boolean
-Used to validate whether type of unknown value is an integer, and, if so,
is it within the option lower and upper limits.
+Used to validate whether type of unknown value is an integer, and, if so,
+is it within the option lower and upper limits.
**Kind**: global function
**Returns**: boolean - true if value is an interger, and optionally in specified range.
@@ -29,3 +30,18 @@ Used to validate whether type of unknown value is an integer, and, if so,
is it
| [lowerLimit] | number | Optional lower limit (inclusive) |
| [upperLimit] | number | Optional upper limit (inclusive) |
+
+
+## isWithinRange(value, [lowerLimit], [upperLimit]) ⇒ boolean
+Used to validate whether type of unknown value is a number (including decimals),
+and, if so, is it within the optional lower and upper limits.
+
+**Kind**: global function
+**Returns**: boolean - true if value is a finite number, and optionally in specified range.
+
+| Param | Type | Description |
+| --- | --- | --- |
+| value | \* | Value for which to validate its type |
+| [lowerLimit] | number | Optional lower limit (inclusive) |
+| [upperLimit] | number | Optional upper limit (inclusive) |
+
diff --git a/docs/API-Reference/view/MainViewFactory.md b/docs/API-Reference/view/MainViewFactory.md
index 51e1db4793..5678cf93d9 100644
--- a/docs/API-Reference/view/MainViewFactory.md
+++ b/docs/API-Reference/view/MainViewFactory.md
@@ -3,39 +3,80 @@
const MainViewFactory = brackets.getModule("view/MainViewFactory")
```
-
+
-## \_
-MainViewFactory is a singleton for managing view factories.
Registering a view factory:
```js
registerViewFactory({
canOpenFile: function (fullPath) {
return (fullPath.slice(-4) === ".ico");
},
openFile: function(file, pane) {
return createIconView(file, pane);
}
});
```
The openFile method is used to open the file and construct
a view of it. Implementation should add the view to the pane
```js
function createIconView(file, pane) {
// IconView will construct its DOM and append
// it to pane.$el
var view = new IconView(file, pane.$el);
// Then tell the pane to add it to
// its view map and show it
pane.addView(view, true);
return new $.Deferred().resolve().promise();
}
```
Factories should only create 1 view of a file per pane. Brackets currently only supports 1 view of
a file open at a given time but that may change to allow the same file open in more than 1 pane. Therefore
Factories can do a simple check to see if a view already exists and show it before creating a new one:
```js
var view = pane.getViewForPath(file.fullPath);
if (view) {
pane.showView(view);
} else {
return createIconView(file, pane);
}
```
+## view/MainViewFactory
+MainViewFactory is a singleton for managing view factories.
-**Kind**: global variable
-
+Registering a view factory:
+```js
+ registerViewFactory({
+ canOpenFile: function (fullPath) {
+ return (fullPath.slice(-4) === ".ico");
+ },
+ openFile: function(file, pane) {
+ return createIconView(file, pane);
+ }
+ });
+```
+ The openFile method is used to open the file and construct
+ a view of it. Implementation should add the view to the pane
+```js
+ function createIconView(file, pane) {
+ // IconView will construct its DOM and append
+ // it to pane.$el
+ var view = new IconView(file, pane.$el);
+ // Then tell the pane to add it to
+ // its view map and show it
+ pane.addView(view, true);
+ return new $.Deferred().resolve().promise();
+ }
+```
+ Factories should only create 1 view of a file per pane. Brackets currently only supports 1 view of
+ a file open at a given time but that may change to allow the same file open in more than 1 pane. Therefore
+ Factories can do a simple check to see if a view already exists and show it before creating a new one:
+```js
+ var view = pane.getViewForPath(file.fullPath);
+ if (view) {
+ pane.showView(view);
+ } else {
+ return createIconView(file, pane);
+ }
+```
+
+
+* [view/MainViewFactory](#module_view/MainViewFactory)
+ * [.registerViewFactory(factory)](#module_view/MainViewFactory..registerViewFactory)
+ * [.findSuitableFactoryForPath(fullPath)](#module_view/MainViewFactory..findSuitableFactoryForPath) ⇒ Factory
+ * [.Factory](#module_view/MainViewFactory..Factory) : Object
+
+
-## registerViewFactory(factory)
+### view/MainViewFactory.registerViewFactory(factory)
Registers a view factory
-**Kind**: global function
+**Kind**: inner method of [view/MainViewFactory](#module_view/MainViewFactory)
| Param | Type | Description |
| --- | --- | --- |
-| factory | [Factory](#Factory) | The view factory to register. |
+| factory | Factory | The view factory to register. |
-
+
-## findSuitableFactoryForPath(fullPath) ⇒ [Factory](#Factory)
+### view/MainViewFactory.findSuitableFactoryForPath(fullPath) ⇒ Factory
Finds a factory that can open the specified file
-**Kind**: global function
-**Returns**: [Factory](#Factory) - A factory that can create a view for the path or undefined if there isn't one.
+**Kind**: inner method of [view/MainViewFactory](#module_view/MainViewFactory)
+**Returns**: Factory - A factory that can create a view for the path or undefined if there isn't one.
| Param | Type | Description |
| --- | --- | --- |
| fullPath | string | The file to open. |
-
+
-## Factory : Object
-**Kind**: global typedef
+### view/MainViewFactory.Factory : Object
+**Kind**: inner typedef of [view/MainViewFactory](#module_view/MainViewFactory)
**Properties**
| Name | Type | Description |
diff --git a/docs/API-Reference/view/MainViewManager.md b/docs/API-Reference/view/MainViewManager.md
index f4a71dde3e..0d38ca3362 100644
--- a/docs/API-Reference/view/MainViewManager.md
+++ b/docs/API-Reference/view/MainViewManager.md
@@ -3,9 +3,9 @@
const MainViewManager = brackets.getModule("view/MainViewManager")
```
-
+
-## \_
+## view/MainViewManager
MainViewManager manages the arrangement of all open panes as well as provides the controller
logic behind all views in the MainView (e.g. ensuring that a file doesn't appear in 2 lists)
@@ -56,226 +56,261 @@ This module dispatches several events:
To listen for events, do something like this: (see EventDispatcher for details on this pattern)
`MainViewManager.on("eventname", handler);`
-**Kind**: global variable
-
-## EVENT\_CURRENT\_FILE\_CHANGE : string
+* [view/MainViewManager](#module_view/MainViewManager)
+ * [.EVENT_CURRENT_FILE_CHANGE](#module_view/MainViewManager..EVENT_CURRENT_FILE_CHANGE) : string
+ * [.ALL_PANES](#module_view/MainViewManager..ALL_PANES)
+ * [.ACTIVE_PANE](#module_view/MainViewManager..ACTIVE_PANE)
+ * [.isExclusiveToPane(File)](#module_view/MainViewManager..isExclusiveToPane) ⇒ Object
+ * [.getActivePaneId()](#module_view/MainViewManager..getActivePaneId) ⇒ string
+ * [.focusActivePane()](#module_view/MainViewManager..focusActivePane)
+ * [.setActivePaneId(paneId)](#module_view/MainViewManager..setActivePaneId)
+ * [.getCurrentlyViewedFile(paneId)](#module_view/MainViewManager..getCurrentlyViewedFile) ⇒ File
+ * [.getCurrentlyViewedEditor(paneId)](#module_view/MainViewManager..getCurrentlyViewedEditor) ⇒ Editor
+ * [.getAllViewedEditors()](#module_view/MainViewManager..getAllViewedEditors) ⇒ Object
+ * [.getCurrentlyViewedPath(paneId)](#module_view/MainViewManager..getCurrentlyViewedPath) ⇒ string
+ * [.cacheScrollState(paneId)](#module_view/MainViewManager..cacheScrollState)
+ * [.restoreAdjustedScrollState(paneId, heightDelta)](#module_view/MainViewManager..restoreAdjustedScrollState)
+ * [.getWorkingSet(paneId)](#module_view/MainViewManager..getWorkingSet) ⇒ Array.<File>
+ * [.getAllOpenFiles()](#module_view/MainViewManager..getAllOpenFiles) ⇒ array.<File>
+ * [.getPaneIdList()](#module_view/MainViewManager..getPaneIdList) ⇒ array.<string>
+ * [.getWorkingSetSize(paneId)](#module_view/MainViewManager..getWorkingSetSize) ⇒ number
+ * [.getPaneTitle(paneId)](#module_view/MainViewManager..getPaneTitle) ⇒ string
+ * [.getPaneCount()](#module_view/MainViewManager..getPaneCount) ⇒ number
+ * [.findInAllWorkingSets(fullPath)](#module_view/MainViewManager..findInAllWorkingSets) ⇒ Object
+ * [.findInOpenPane(fullPath)](#module_view/MainViewManager..findInOpenPane) ⇒ Object
+ * [.findInWorkingSet(paneId, fullPath)](#module_view/MainViewManager..findInWorkingSet) ⇒ number
+ * [.findInWorkingSetByAddedOrder(paneId, fullPath)](#module_view/MainViewManager..findInWorkingSetByAddedOrder) ⇒ number
+ * [.findInWorkingSetByMRUOrder(paneId, fullPath)](#module_view/MainViewManager..findInWorkingSetByMRUOrder) ⇒ number
+ * [.addToWorkingSet(paneId, file, [index], [forceRedraw])](#module_view/MainViewManager..addToWorkingSet)
+ * [.addListToWorkingSet(paneId, fileList)](#module_view/MainViewManager..addListToWorkingSet)
+ * [.switchPaneFocus()](#module_view/MainViewManager..switchPaneFocus)
+ * [.traverseToNextViewByMRU(direction)](#module_view/MainViewManager..traverseToNextViewByMRU) ⇒ Object
+ * [.traverseToNextViewInListOrder(direction)](#module_view/MainViewManager..traverseToNextViewInListOrder) ⇒ Object
+ * [.beginTraversal()](#module_view/MainViewManager..beginTraversal)
+ * [.endTraversal()](#module_view/MainViewManager..endTraversal)
+ * [.setLayoutScheme(rows, columns)](#module_view/MainViewManager..setLayoutScheme)
+ * [.getLayoutScheme()](#module_view/MainViewManager..getLayoutScheme) ⇒ Object
+
+
+
+### view/MainViewManager.EVENT\_CURRENT\_FILE\_CHANGE : string
Event current file change
-**Kind**: global constant
-
+**Kind**: inner constant of [view/MainViewManager](#module_view/MainViewManager)
+
-## ALL\_PANES
+### view/MainViewManager.ALL\_PANES
Special paneId shortcut that can be used to specify that
all panes should be targeted by the API.
Not all APIs support this constnant.
Check the API documentation before use.
-**Kind**: global constant
-
+**Kind**: inner constant of [view/MainViewManager](#module_view/MainViewManager)
+
-## ACTIVE\_PANE
+### view/MainViewManager.ACTIVE\_PANE
Special paneId shortcut that can be used to specify that
the API should target the focused pane only.
All APIs support this shortcut.
-**Kind**: global constant
-
+**Kind**: inner constant of [view/MainViewManager](#module_view/MainViewManager)
+
-## isExclusiveToPane(File) ⇒ Object
+### view/MainViewManager.isExclusiveToPane(File) ⇒ Object
Checks whether a file is listed exclusively in the provided pane
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
| Param | Type | Description |
| --- | --- | --- |
| File | File | the file |
-
+
-## getActivePaneId() ⇒ string
+### view/MainViewManager.getActivePaneId() ⇒ string
Retrieves the currently active Pane Id
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: string - Active Pane's ID.
-
+
-## focusActivePane()
+### view/MainViewManager.focusActivePane()
Focuses the current pane. If the current pane has a current view, then the pane will focus the view.
-**Kind**: global function
-
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
+
-## setActivePaneId(paneId)
+### view/MainViewManager.setActivePaneId(paneId)
Switch active pane to the specified pane id (or ACTIVE_PANE/ALL_PANES, in which case this
call does nothing).
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
| Param | Type | Description |
| --- | --- | --- |
| paneId | string | the id of the pane to activate |
-
+
-## getCurrentlyViewedFile(paneId) ⇒ File
+### view/MainViewManager.getCurrentlyViewedFile(paneId) ⇒ File
Retrieves the currently viewed file of the specified paneId
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: File - File object of the currently viewed file, or null if there isn't one or there's no such pane
| Param | Type | Description |
| --- | --- | --- |
| paneId | string | the id of the pane in which to retrieve the currently viewed file |
-
+
-## getCurrentlyViewedEditor(paneId) ⇒ Editor
+### view/MainViewManager.getCurrentlyViewedEditor(paneId) ⇒ Editor
Retrieves the currently viewed editor of the specified paneId
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: Editor - currently editor, or null if there isn't one or there's no such pane
| Param | Type | Description |
| --- | --- | --- |
| paneId | string | the id of the pane in which to retrieve the currently viewed editor |
-
+
-## getAllViewedEditors() ⇒ Object
+### view/MainViewManager.getAllViewedEditors() ⇒ Object
Gets an array of editors open in panes with their pane IDs.
Can return an empty array if no editors are open.
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: Object - An array of objects, each containing an editor and its corresponding pane ID.
-
+
-## getCurrentlyViewedPath(paneId) ⇒ string
+### view/MainViewManager.getCurrentlyViewedPath(paneId) ⇒ string
Retrieves the currently viewed path of the pane specified by paneId
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: string - the path of the currently viewed file or null if there isn't one
| Param | Type | Description |
| --- | --- | --- |
| paneId | string | the id of the pane in which to retrieve the currently viewed path |
-
+
-## cacheScrollState(paneId)
+### view/MainViewManager.cacheScrollState(paneId)
Caches the specified pane's current scroll state
If there was already cached state for the specified pane, it is discarded and overwritten
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
| Param | Type | Description |
| --- | --- | --- |
| paneId | string | id of the pane in which to cache the scroll state, ALL_PANES or ACTIVE_PANE |
-
+
-## restoreAdjustedScrollState(paneId, heightDelta)
+### view/MainViewManager.restoreAdjustedScrollState(paneId, heightDelta)
Restores the scroll state from cache and applies the heightDelta
The view implementation is responsible for applying or ignoring the heightDelta.
This is used primarily when a modal bar opens to keep the editor from scrolling the current
page out of view in order to maintain the appearance.
The state is removed from the cache after calling this function.
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
| Param | Type | Description |
| --- | --- | --- |
| paneId | string | id of the pane in which to adjust the scroll state, ALL_PANES or ACTIVE_PANE |
| heightDelta | number | delta H to apply to the scroll state |
-
+
-## getWorkingSet(paneId) ⇒ Array.<File>
+### view/MainViewManager.getWorkingSet(paneId) ⇒ Array.<File>
Retrieves the WorkingSet for the given paneId not including temporary views
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
| Param | Type | Description |
| --- | --- | --- |
| paneId | string | id of the pane in which to get the view list, ALL_PANES or ACTIVE_PANE |
-
+
-## getAllOpenFiles() ⇒ array.<File>
+### view/MainViewManager.getAllOpenFiles() ⇒ array.<File>
Retrieves the list of all open files including temporary views
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: array.<File> - the list of all open files in all open panes
-
+
-## getPaneIdList() ⇒ array.<string>
+### view/MainViewManager.getPaneIdList() ⇒ array.<string>
Retrieves the list of all open pane ids
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: array.<string> - the list of all open panes
-
+
-## getWorkingSetSize(paneId) ⇒ number
+### view/MainViewManager.getWorkingSetSize(paneId) ⇒ number
Retrieves the size of the selected pane's view list
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: number - the number of items in the specified pane
| Param | Type | Description |
| --- | --- | --- |
| paneId | string | id of the pane in which to get the workingset size. Can use `ALL_PANES` or `ACTIVE_PANE` |
-
+
-## getPaneTitle(paneId) ⇒ string
+### view/MainViewManager.getPaneTitle(paneId) ⇒ string
Retrieves the title to display in the workingset view
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: string - title
| Param | Type | Description |
| --- | --- | --- |
| paneId | string | id of the pane in which to get the title |
-
+
-## getPaneCount() ⇒ number
+### view/MainViewManager.getPaneCount() ⇒ number
Retrieves the number of panes
-**Kind**: global function
-
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
+
-## findInAllWorkingSets(fullPath) ⇒ Object
+### view/MainViewManager.findInAllWorkingSets(fullPath) ⇒ Object
Finds all instances of the specified file in all working sets.
If there is a temporary view of the file, it is not part of the result set
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: Object - an array of paneId/index records
| Param | Type | Description |
| --- | --- | --- |
| fullPath | string | path of the file to find views of |
-
+
-## findInOpenPane(fullPath) ⇒ Object
-Returns the pane IDs and editors (if present) of the given file in any open and viewable pane.
-If the same file is open in multiple panes, all matching panes will be returned.
+### view/MainViewManager.findInOpenPane(fullPath) ⇒ Object
+Returns the pane IDs and editors (if present) of the given file in any open and viewable pane.
+If the same file is open in multiple panes, all matching panes will be returned.
If not found in any panes, an empty array will be returned.
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: Object - An array of objects, each containing the pane ID and the corresponding editor, if present.
| Param | Type | Description |
| --- | --- | --- |
| fullPath | string | The full path of the file to search for. |
-
+
-## findInWorkingSet(paneId, fullPath) ⇒ number
+### view/MainViewManager.findInWorkingSet(paneId, fullPath) ⇒ number
Gets the index of the file matching fullPath in the workingset
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: number - index, -1 if not found.
| Param | Type | Description |
@@ -283,12 +318,12 @@ Gets the index of the file matching fullPath in the workingset
| paneId | string | id of the pane in which to search or ALL_PANES or ACTIVE_PANE |
| fullPath | string | full path of the file to search for |
-
+
-## findInWorkingSetByAddedOrder(paneId, fullPath) ⇒ number
+### view/MainViewManager.findInWorkingSetByAddedOrder(paneId, fullPath) ⇒ number
Gets the index of the file matching fullPath in the added order workingset
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: number - index, -1 if not found.
| Param | Type | Description |
@@ -296,12 +331,12 @@ Gets the index of the file matching fullPath in the added order workingset
| paneId | string | id of the pane in which to search or ALL_PANES or ACTIVE_PANE |
| fullPath | string | full path of the file to search for |
-
+
-## findInWorkingSetByMRUOrder(paneId, fullPath) ⇒ number
+### view/MainViewManager.findInWorkingSetByMRUOrder(paneId, fullPath) ⇒ number
Gets the index of the file matching fullPath in the MRU order workingset
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: number - index, -1 if not found.
| Param | Type | Description |
@@ -309,9 +344,9 @@ Gets the index of the file matching fullPath in the MRU order workingset
| paneId | string | id of the pane in which to search or ALL_PANES or ACTIVE_PANE |
| fullPath | string | full path of the file to search for |
-
+
-## addToWorkingSet(paneId, file, [index], [forceRedraw])
+### view/MainViewManager.addToWorkingSet(paneId, file, [index], [forceRedraw])
Adds the given file to the end of the workingset, if it is not already there.
This API does not create a view of the file, it just adds it to the working set
Views of files in the working set are persisted and are not destroyed until the user
@@ -319,7 +354,7 @@ Views of files in the working set are persisted and are not destroyed until the
made the current view. If a File is already opened then the file is just made current
and its view is shown.
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
| Param | Type | Description |
| --- | --- | --- |
@@ -328,30 +363,30 @@ Views of files in the working set are persisted and are not destroyed until the
| [index] | number | Position to add to list (defaults to last); -1 is ignored |
| [forceRedraw] | boolean | If true, a workingset change notification is always sent (useful if suppressRedraw was used with removeView() earlier) |
-
+
-## addListToWorkingSet(paneId, fileList)
+### view/MainViewManager.addListToWorkingSet(paneId, fileList)
Adds the given file list to the end of the workingset.
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
| Param | Type | Description |
| --- | --- | --- |
| paneId | string | The id of the pane in which to add the file object to or ACTIVE_PANE |
| fileList | Array.<File> | Array of files to add to the pane |
-
+
-## switchPaneFocus()
+### view/MainViewManager.switchPaneFocus()
Switch between panes
-**Kind**: global function
-
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
+
-## traverseToNextViewByMRU(direction) ⇒ Object
+### view/MainViewManager.traverseToNextViewByMRU(direction) ⇒ Object
Get the next or previous file in the MRU list.
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: Object - The File object of the next item in the traversal order or null if there aren't any files to traverse.
May return current file if there are no other files to traverse.
@@ -359,12 +394,12 @@ Get the next or previous file in the MRU list.
| --- | --- | --- |
| direction | number | Must be 1 or -1 to traverse forward or backward |
-
+
-## traverseToNextViewInListOrder(direction) ⇒ Object
+### view/MainViewManager.traverseToNextViewInListOrder(direction) ⇒ Object
Get the next or previous file in list order.
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: Object - The File object of the next item in the traversal order or null if there aren't any files to traverse.
May return current file if there are no other files to traverse.
@@ -372,26 +407,26 @@ Get the next or previous file in list order.
| --- | --- | --- |
| direction | number | Must be 1 or -1 to traverse forward or backward |
-
+
-## beginTraversal()
+### view/MainViewManager.beginTraversal()
Indicates that traversal has begun.
Can be called any number of times.
-**Kind**: global function
-
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
+
-## endTraversal()
+### view/MainViewManager.endTraversal()
Un-freezes the MRU list after one or more beginTraversal() calls.
Whatever file is current is bumped to the front of the MRU list.
-**Kind**: global function
-
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
+
-## setLayoutScheme(rows, columns)
+### view/MainViewManager.setLayoutScheme(rows, columns)
Changes the layout scheme
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Summay**: Rows or Columns may be 1 or 2 but both cannot be 2. 1x2, 2x1 or 1x1 are the legal values
| Param | Type | Description |
@@ -399,10 +434,10 @@ Changes the layout scheme
| rows | number | (may be 1 or 2) |
| columns | number | (may be 1 or 2) |
-
+
-## getLayoutScheme() ⇒ Object
+### view/MainViewManager.getLayoutScheme() ⇒ Object
Retrieves the current layout scheme.
-**Kind**: global function
+**Kind**: inner method of [view/MainViewManager](#module_view/MainViewManager)
**Returns**: Object - - An object containing the number of rows and columns in the layout.
diff --git a/docs/API-Reference/view/Pane.md b/docs/API-Reference/view/Pane.md
index 399b3df8e7..2ca1cdab71 100644
--- a/docs/API-Reference/view/Pane.md
+++ b/docs/API-Reference/view/Pane.md
@@ -3,59 +3,235 @@
const Pane = brackets.getModule("view/Pane")
```
-
+
-## Pane
-**Kind**: global class
+## view/Pane
+Pane objects host views of files, editors, etc... Clients cannot access
+Pane objects directly. Instead the implementation is protected by the
+MainViewManager -- however View Factories are given a Pane object which
+they can use to add views. References to Pane objects should not be kept
+as they may be destroyed and removed from the DOM.
+
+To get a custom view, there are two components:
+
+ 1) A View Factory
+ 2) A View Object
+
+View objects are anonymous object that have a particular interface.
+
+Views can be added to a pane but do not have to exist in the Pane object's view list.
+Such views are "temporary views". Temporary views are not serialized with the Pane state
+or reconstituted when the pane is serialized from disk. They are destroyed at the earliest
+opportunity.
+
+Temporary views are added by calling `Pane.showView()` and passing it the view object. The view
+will be destroyed when the next view is shown, the pane is mereged with another pane or the "Close All"
+command is exectuted on the Pane. Temporary Editor Views do not contain any modifications and are
+added to the workingset (and are no longer tempoary views) once the document has been modified. They
+will remain in the working set until closed from that point on.
+
+Views that have a longer life span are added by calling addView to associate the view with a
+filename in the _views object. These views are not destroyed until they are removed from the pane
+by calling one of the following: removeView, removeViews, or _reset
+
+Pane Object Events:
+
+ - viewListChange - Whenever there is a file change to a file in the working set. These 2 events: `DocumentManager.pathRemove`
+ and `DocumentManager.fileNameChange` will cause a `viewListChange` event so the WorkingSetView can update.
+
+ - currentViewChange - Whenever the current view changes.
+ (e, newView:View, oldView:View)
+
+ - viewDestroy - Whenever a view has been destroyed
+ (e, view:View)
+
+View Interface:
+
+The view is an anonymous object which has the following method signatures. see ImageViewer for an example or the sample
+provided with Brackets `src/extensions/samples/BracketsConfigCentral`
+
+```js
+ {
+ $el:jQuery
+ getFile: function ():!File
+ updateLayout: function(forceRefresh:boolean)
+ destroy: function()
+ getScrollPos: function():*=
+ adjustScrollPos: function(state:Object=, heightDelta:number)=
+ notifyContainerChange: function()=
+ notifyVisibilityChange: function(boolean)=
+ focus:function()=
+ }
+```
+When views are created they can be added to the pane by calling `pane.addView()`.
+Views can be created and parented by attaching directly to `pane.$el`
+
+ this._codeMirror = new CodeMirror(pane.$el, ...)
+
+Factories can create a view that's initially hidden by calling `pane.addView(view)` and passing `false` for the show parameter.
+Hidden views can be later shown by calling `pane.showView(view)`
+
+`$el:jQuery!`
+
+ property that stores the jQuery wrapped DOM element of the view. All views must have one so pane objects can manipulate the DOM
+ element when necessary (e.g. `showView`, `_reparent`, etc...)
+
+`getFile():File!`
+
+ Called throughout the life of a View when the current file is queried by the system.
+
+`updateLayout(forceRefresh:boolean)`
+
+ Called to notify the view that it should be resized to fit its parent container. This may be called several times
+ or only once. Views can ignore the `forceRefresh` flag. It is used for editor views to force a relayout of the editor
+ which probably isn't necessary for most views. Views should implement their html to be dynamic and not rely on this
+ function to be called whenever possible.
+
+`destroy()`
+
+ Views must implement a destroy method to remove their DOM element at the very least. There is no default
+ implementation and views are hidden before this method is called. The Pane object doesn't make assumptions
+ about when it is safe to remove a node. In some instances other cleanup must take place before a the DOM
+ node is destroyed so the implementation details are left to the view.
+
+ Views can implement a simple destroy by calling
+
+ this.$el.remove()
+
+ These members are optional and need not be implemented by Views
+
+ getScrollPos()
+ adjustScrollPos()
+
+ The system at various times will want to save and restore a view's scroll position. The data returned by `getScrollPos()`
+ is specific to the view and will be passed back to `adjustScrollPos()` when the scroll position needs to be restored.
+
+ When Modal Bars are invoked, the system calls `getScrollPos()` so that the current scroll psotion of all visible Views can be cached.
+ That cached scroll position is later passed to `adjustScrollPos()` along with a height delta. The height delta is used to
+ scroll the view so that it doesn't appear to have "jumped" when invoking the Modal Bar.
+
+ Height delta will be a positive when the Modal Bar is being shown and negative number when the Modal Bar is being hidden.
+
+ `getViewState()` is another optional member that is used to cache a view's state when hiding or destroying a view or closing the project.
+ The data returned by this member is stored in `ViewStateManager` and is saved with the project.
+
+ Views or View Factories are responsible for restoring the view state when the view of that file is created by recalling the cached state
+
+ var view = createIconView(file, pane);
+ view.restoreViewState(ViewStateManager.getViewState(file.fullPath));
+
+ Notifications
+ The following optional methods receive notifications from the Pane object when certain events take place which affect the view:
+
+`notifyContainerChange()`
+
+ Optional Notification callback called when the container changes. The view can perform any synchronization or state update
+ it needs to do when its parent container changes.
+
+`notifyVisiblityChange()`
+
+ Optional Notification callback called when the view's vsibility changes. The view can perform any synchronization or
+ state update it needs to do when its visiblity state changes.
+
+
+* [view/Pane](#module_view/Pane)
+ * [.Pane](#module_view/Pane..Pane)
+ * [new Pane(id, $container)](#new_module_view/Pane..Pane_new)
+ * [.id](#module_view/Pane..Pane+id) : string
+ * [.$container](#module_view/Pane..Pane+$container) : JQuery
+ * [.$el](#module_view/Pane..Pane+$el) : JQuery
+ * [.$header](#module_view/Pane..Pane+$header) : JQuery
+ * [.$headerText](#module_view/Pane..Pane+$headerText) : JQuery
+ * [.$headerFlipViewBtn](#module_view/Pane..Pane+$headerFlipViewBtn) : JQuery
+ * [.$headerCloseBtn](#module_view/Pane..Pane+$headerCloseBtn) : JQuery
+ * [.$content](#module_view/Pane..Pane+$content) : JQuery
+ * [.ITEM_NOT_FOUND](#module_view/Pane..Pane+ITEM_NOT_FOUND)
+ * [.ITEM_FOUND_NO_SORT](#module_view/Pane..Pane+ITEM_FOUND_NO_SORT)
+ * [.ITEM_FOUND_NEEDS_SORT](#module_view/Pane..Pane+ITEM_FOUND_NEEDS_SORT)
+ * [.mergeFrom(other)](#module_view/Pane..Pane+mergeFrom)
+ * [.destroy()](#module_view/Pane..Pane+destroy)
+ * [.getViewList()](#module_view/Pane..Pane+getViewList) ⇒ Array.<File>
+ * [.getViewListSize()](#module_view/Pane..Pane+getViewListSize) ⇒ number
+ * [.findInViewList(fullPath)](#module_view/Pane..Pane+findInViewList) ⇒ number
+ * [.findInViewListAddedOrder(fullPath)](#module_view/Pane..Pane+findInViewListAddedOrder) ⇒ number
+ * [.findInViewListMRUOrder(fullPath)](#module_view/Pane..Pane+findInViewListMRUOrder) ⇒ number
+ * [.reorderItem(file, [index], [force])](#module_view/Pane..Pane+reorderItem) ⇒ number
+ * [.addToViewList(file, [index])](#module_view/Pane..Pane+addToViewList) ⇒ number
+ * [.addListToViewList(fileList)](#module_view/Pane..Pane+addListToViewList) ⇒ Array.<File>
+ * [.makeViewMostRecent(file)](#module_view/Pane..Pane+makeViewMostRecent)
+ * [.sortViewList(compareFn)](#module_view/Pane..Pane+sortViewList)
+ * [.swapViewListIndexes(index1, index2)](#module_view/Pane..Pane+swapViewListIndexes) ⇒ boolean
+ * [.traverseViewListByMRU(direction, [current])](#module_view/Pane..Pane+traverseViewListByMRU) ⇒ File
+ * [.showInterstitial(show)](#module_view/Pane..Pane+showInterstitial)
+ * [.getViewForPath(path)](#module_view/Pane..Pane+getViewForPath) ⇒ boolean
+ * [.addView(view, show)](#module_view/Pane..Pane+addView)
+ * [.showView(view)](#module_view/Pane..Pane+showView)
+ * [.updateLayout(forceRefresh)](#module_view/Pane..Pane+updateLayout)
+ * [.getCurrentlyViewedFile()](#module_view/Pane..Pane+getCurrentlyViewedFile) ⇒ File
+ * [.getCurrentlyViewedEditor()](#module_view/Pane..Pane+getCurrentlyViewedEditor) ⇒ File
+ * [.getCurrentlyViewedPath()](#module_view/Pane..Pane+getCurrentlyViewedPath) ⇒ string
+ * [.destroyViewIfNotNeeded(view)](#module_view/Pane..Pane+destroyViewIfNotNeeded)
+ * [.removeView(file, suppressOpenNextFile, preventViewChange)](#module_view/Pane..Pane+removeView) ⇒ boolean
+ * [.removeViews(list)](#module_view/Pane..Pane+removeViews) ⇒ Array.<File>
+ * [.focus()](#module_view/Pane..Pane+focus)
+ * [.loadState(state)](#module_view/Pane..Pane+loadState) ⇒ jQuery.Promise
+ * [.saveState()](#module_view/Pane..Pane+saveState) ⇒ Object
+ * [.getScrollState()](#module_view/Pane..Pane+getScrollState) ⇒ Object
+ * [.restoreAndAdjustScrollState([state], [heightDelta])](#module_view/Pane..Pane+restoreAndAdjustScrollState)
+
+
+
+### view/Pane.Pane
+**Kind**: inner class of [view/Pane](#module_view/Pane)
**See**: [MainViewManager](MainViewManager) for more information
-* [Pane](#Pane)
- * [new Pane(id, $container)](#new_Pane_new)
- * [.id](#Pane+id) : string
- * [.$container](#Pane+$container) : JQuery
- * [.$el](#Pane+$el) : JQuery
- * [.$header](#Pane+$header) : JQuery
- * [.$headerText](#Pane+$headerText) : JQuery
- * [.$headerFlipViewBtn](#Pane+$headerFlipViewBtn) : JQuery
- * [.$headerCloseBtn](#Pane+$headerCloseBtn) : JQuery
- * [.$content](#Pane+$content) : JQuery
- * [.ITEM_NOT_FOUND](#Pane+ITEM_NOT_FOUND)
- * [.ITEM_FOUND_NO_SORT](#Pane+ITEM_FOUND_NO_SORT)
- * [.ITEM_FOUND_NEEDS_SORT](#Pane+ITEM_FOUND_NEEDS_SORT)
- * [.mergeFrom(other)](#Pane+mergeFrom)
- * [.destroy()](#Pane+destroy)
- * [.getViewList()](#Pane+getViewList) ⇒ Array.<File>
- * [.getViewListSize()](#Pane+getViewListSize) ⇒ number
- * [.findInViewList(fullPath)](#Pane+findInViewList) ⇒ number
- * [.findInViewListAddedOrder(fullPath)](#Pane+findInViewListAddedOrder) ⇒ number
- * [.findInViewListMRUOrder(fullPath)](#Pane+findInViewListMRUOrder) ⇒ number
- * [.reorderItem(file, [index], [force])](#Pane+reorderItem) ⇒ number
- * [.addToViewList(file, [index])](#Pane+addToViewList) ⇒ number
- * [.addListToViewList(fileList)](#Pane+addListToViewList) ⇒ Array.<File>
- * [.makeViewMostRecent(file)](#Pane+makeViewMostRecent)
- * [.sortViewList(compareFn)](#Pane+sortViewList)
- * [.swapViewListIndexes(index1, index2)](#Pane+swapViewListIndexes) ⇒ boolean
- * [.traverseViewListByMRU(direction, [current])](#Pane+traverseViewListByMRU) ⇒ File
- * [.showInterstitial(show)](#Pane+showInterstitial)
- * [.getViewForPath(path)](#Pane+getViewForPath) ⇒ boolean
- * [.addView(view, show)](#Pane+addView)
- * [.showView(view)](#Pane+showView)
- * [.updateLayout(forceRefresh)](#Pane+updateLayout)
- * [.getCurrentlyViewedFile()](#Pane+getCurrentlyViewedFile) ⇒ File
- * [.getCurrentlyViewedEditor()](#Pane+getCurrentlyViewedEditor) ⇒ File
- * [.getCurrentlyViewedPath()](#Pane+getCurrentlyViewedPath) ⇒ string
- * [.destroyViewIfNotNeeded(view)](#Pane+destroyViewIfNotNeeded)
- * [.removeView(file, suppressOpenNextFile, preventViewChange)](#Pane+removeView) ⇒ boolean
- * [.removeViews(list)](#Pane+removeViews) ⇒ Array.<File>
- * [.focus()](#Pane+focus)
- * [.loadState(state)](#Pane+loadState) ⇒ jQuery.Promise
- * [.saveState()](#Pane+saveState) ⇒ Object
- * [.getScrollState()](#Pane+getScrollState) ⇒ Object
- * [.restoreAndAdjustScrollState([state], [heightDelta])](#Pane+restoreAndAdjustScrollState)
-
-
-
-### new Pane(id, $container)
+* [.Pane](#module_view/Pane..Pane)
+ * [new Pane(id, $container)](#new_module_view/Pane..Pane_new)
+ * [.id](#module_view/Pane..Pane+id) : string
+ * [.$container](#module_view/Pane..Pane+$container) : JQuery
+ * [.$el](#module_view/Pane..Pane+$el) : JQuery
+ * [.$header](#module_view/Pane..Pane+$header) : JQuery
+ * [.$headerText](#module_view/Pane..Pane+$headerText) : JQuery
+ * [.$headerFlipViewBtn](#module_view/Pane..Pane+$headerFlipViewBtn) : JQuery
+ * [.$headerCloseBtn](#module_view/Pane..Pane+$headerCloseBtn) : JQuery
+ * [.$content](#module_view/Pane..Pane+$content) : JQuery
+ * [.ITEM_NOT_FOUND](#module_view/Pane..Pane+ITEM_NOT_FOUND)
+ * [.ITEM_FOUND_NO_SORT](#module_view/Pane..Pane+ITEM_FOUND_NO_SORT)
+ * [.ITEM_FOUND_NEEDS_SORT](#module_view/Pane..Pane+ITEM_FOUND_NEEDS_SORT)
+ * [.mergeFrom(other)](#module_view/Pane..Pane+mergeFrom)
+ * [.destroy()](#module_view/Pane..Pane+destroy)
+ * [.getViewList()](#module_view/Pane..Pane+getViewList) ⇒ Array.<File>
+ * [.getViewListSize()](#module_view/Pane..Pane+getViewListSize) ⇒ number
+ * [.findInViewList(fullPath)](#module_view/Pane..Pane+findInViewList) ⇒ number
+ * [.findInViewListAddedOrder(fullPath)](#module_view/Pane..Pane+findInViewListAddedOrder) ⇒ number
+ * [.findInViewListMRUOrder(fullPath)](#module_view/Pane..Pane+findInViewListMRUOrder) ⇒ number
+ * [.reorderItem(file, [index], [force])](#module_view/Pane..Pane+reorderItem) ⇒ number
+ * [.addToViewList(file, [index])](#module_view/Pane..Pane+addToViewList) ⇒ number
+ * [.addListToViewList(fileList)](#module_view/Pane..Pane+addListToViewList) ⇒ Array.<File>
+ * [.makeViewMostRecent(file)](#module_view/Pane..Pane+makeViewMostRecent)
+ * [.sortViewList(compareFn)](#module_view/Pane..Pane+sortViewList)
+ * [.swapViewListIndexes(index1, index2)](#module_view/Pane..Pane+swapViewListIndexes) ⇒ boolean
+ * [.traverseViewListByMRU(direction, [current])](#module_view/Pane..Pane+traverseViewListByMRU) ⇒ File
+ * [.showInterstitial(show)](#module_view/Pane..Pane+showInterstitial)
+ * [.getViewForPath(path)](#module_view/Pane..Pane+getViewForPath) ⇒ boolean
+ * [.addView(view, show)](#module_view/Pane..Pane+addView)
+ * [.showView(view)](#module_view/Pane..Pane+showView)
+ * [.updateLayout(forceRefresh)](#module_view/Pane..Pane+updateLayout)
+ * [.getCurrentlyViewedFile()](#module_view/Pane..Pane+getCurrentlyViewedFile) ⇒ File
+ * [.getCurrentlyViewedEditor()](#module_view/Pane..Pane+getCurrentlyViewedEditor) ⇒ File
+ * [.getCurrentlyViewedPath()](#module_view/Pane..Pane+getCurrentlyViewedPath) ⇒ string
+ * [.destroyViewIfNotNeeded(view)](#module_view/Pane..Pane+destroyViewIfNotNeeded)
+ * [.removeView(file, suppressOpenNextFile, preventViewChange)](#module_view/Pane..Pane+removeView) ⇒ boolean
+ * [.removeViews(list)](#module_view/Pane..Pane+removeViews) ⇒ Array.<File>
+ * [.focus()](#module_view/Pane..Pane+focus)
+ * [.loadState(state)](#module_view/Pane..Pane+loadState) ⇒ jQuery.Promise
+ * [.saveState()](#module_view/Pane..Pane+saveState) ⇒ Object
+ * [.getScrollState()](#module_view/Pane..Pane+getScrollState) ⇒ Object
+ * [.restoreAndAdjustScrollState([state], [heightDelta])](#module_view/Pane..Pane+restoreAndAdjustScrollState)
+
+
+
+#### new Pane(id, $container)
Pane Objects are constructed by the MainViewManager object when a Pane view is needed.
@@ -64,145 +240,145 @@ Pane Objects are constructed by the MainViewManager object when a Pane view is n
| id | string | The id to use to identify this pane. |
| $container | jQuery | The parent jQuery container to place the pane view. |
-
+
-### pane.id : string
+#### pane.id : string
id of the pane
-**Kind**: instance property of [Pane](#Pane)
+**Kind**: instance property of [Pane](#module_view/Pane..Pane)
**Read only**: true
-
+
-### pane.$container : JQuery
+#### pane.$container : JQuery
container where the pane lives
-**Kind**: instance property of [Pane](#Pane)
+**Kind**: instance property of [Pane](#module_view/Pane..Pane)
**Read only**: true
-
+
-### pane.$el : JQuery
+#### pane.$el : JQuery
the wrapped DOM node of this pane
-**Kind**: instance property of [Pane](#Pane)
+**Kind**: instance property of [Pane](#module_view/Pane..Pane)
**Read only**: true
-
+
-### pane.$header : JQuery
+#### pane.$header : JQuery
the wrapped DOM node container that contains name of current view and the switch view button, or informational string if there is no view
-**Kind**: instance property of [Pane](#Pane)
+**Kind**: instance property of [Pane](#module_view/Pane..Pane)
**Read only**: true
-
+
-### pane.$headerText : JQuery
+#### pane.$headerText : JQuery
the wrapped DOM node that contains name of current view, or informational string if there is no view
-**Kind**: instance property of [Pane](#Pane)
+**Kind**: instance property of [Pane](#module_view/Pane..Pane)
**Read only**: true
-
+
-### pane.$headerFlipViewBtn : JQuery
+#### pane.$headerFlipViewBtn : JQuery
the wrapped DOM node that is used to flip the view to another pane
-**Kind**: instance property of [Pane](#Pane)
+**Kind**: instance property of [Pane](#module_view/Pane..Pane)
**Read only**: true
-
+
-### pane.$headerCloseBtn : JQuery
+#### pane.$headerCloseBtn : JQuery
close button of the pane
-**Kind**: instance property of [Pane](#Pane)
+**Kind**: instance property of [Pane](#module_view/Pane..Pane)
**Read only**: true
-
+
-### pane.$content : JQuery
+#### pane.$content : JQuery
the wrapped DOM node that contains views
-**Kind**: instance property of [Pane](#Pane)
+**Kind**: instance property of [Pane](#module_view/Pane..Pane)
**Read only**: true
-
+
-### pane.ITEM\_NOT\_FOUND
+#### pane.ITEM\_NOT\_FOUND
Return value from reorderItem when the Item was not found
-**Kind**: instance constant of [Pane](#Pane)
-**See**: [reorderItem](#Pane+reorderItem)
-
+**Kind**: instance constant of [Pane](#module_view/Pane..Pane)
+**See**: [Pane#reorderItem](Pane#reorderItem)
+
-### pane.ITEM\_FOUND\_NO\_SORT
+#### pane.ITEM\_FOUND\_NO\_SORT
Return value from reorderItem when the Item was found at its natural index
and the workingset does not need to be resorted
-**Kind**: instance constant of [Pane](#Pane)
-**See**: [reorderItem](#Pane+reorderItem)
-
+**Kind**: instance constant of [Pane](#module_view/Pane..Pane)
+**See**: [Pane#reorderItem](Pane#reorderItem)
+
-### pane.ITEM\_FOUND\_NEEDS\_SORT
+#### pane.ITEM\_FOUND\_NEEDS\_SORT
Return value from reorderItem when the Item was found and reindexed
and the workingset needs to be resorted
-**Kind**: instance constant of [Pane](#Pane)
-**See**: [reorderItem](#Pane+reorderItem)
-
+**Kind**: instance constant of [Pane](#module_view/Pane..Pane)
+**See**: [Pane#reorderItem](Pane#reorderItem)
+
-### pane.mergeFrom(other)
+#### pane.mergeFrom(other)
Merges the another Pane object's contents into this Pane
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
| Param | Type | Description |
| --- | --- | --- |
-| other | [Pane](#Pane) | Pane from which to copy |
+| other | Pane | Pane from which to copy |
-
+
-### pane.destroy()
+#### pane.destroy()
Removes the DOM node for the Pane, removes all
event handlers and _resets all internal data structures
-**Kind**: instance method of [Pane](#Pane)
-
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
+
-### pane.getViewList() ⇒ Array.<File>
+#### pane.getViewList() ⇒ Array.<File>
Returns a copy of the view file list
-**Kind**: instance method of [Pane](#Pane)
-
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
+
-### pane.getViewListSize() ⇒ number
+#### pane.getViewListSize() ⇒ number
Returns the number of entries in the view file list
-**Kind**: instance method of [Pane](#Pane)
-
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
+
-### pane.findInViewList(fullPath) ⇒ number
+#### pane.findInViewList(fullPath) ⇒ number
Returns the index of the item in the view file list
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: number - index of the item or -1 if not found
| Param | Type | Description |
| --- | --- | --- |
| fullPath | string | the full path of the item to look for |
-
+
-### pane.findInViewListAddedOrder(fullPath) ⇒ number
+#### pane.findInViewListAddedOrder(fullPath) ⇒ number
Returns the order in which the item was added
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: number - order of the item or -1 if not found
| Param | Type | Description |
| --- | --- | --- |
| fullPath | string | the full path of the item to look for |
-
+
-### pane.findInViewListMRUOrder(fullPath) ⇒ number
+#### pane.findInViewListMRUOrder(fullPath) ⇒ number
Returns the order in which the item was last used
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: number - order of the item or -1 if not found.
0 indicates most recently used, followed by 1 and so on...
@@ -210,12 +386,12 @@ Returns the order in which the item was last used
| --- | --- | --- |
| fullPath | string | the full path of the item to look for |
-
+
-### pane.reorderItem(file, [index], [force]) ⇒ number
+#### pane.reorderItem(file, [index], [force]) ⇒ number
reorders the specified file in the view list to the desired position
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: number - this function returns one of the following manifest constants:
ITEM_NOT_FOUND : The request file object was not found
ITEM_FOUND_NO_SORT : The request file object was found but it was already at the requested index
@@ -227,13 +403,13 @@ reorders the specified file in the view list to the desired position
| [index] | number | the new position of the item |
| [force] | boolean | true to force the item into that position, false otherwise. (Requires an index be requested) |
-
+
-### pane.addToViewList(file, [index]) ⇒ number
+#### pane.addToViewList(file, [index]) ⇒ number
Adds the given file to the end of the workingset, if it is not already in the list
Does not change which document is currently open in the editor. Completes synchronously.
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: number - index of where the item was added
| Param | Type | Description |
@@ -241,46 +417,46 @@ Does not change which document is currently open in the editor. Completes synchr
| file | File | file to add |
| [index] | number | position where to add the item |
-
+
-### pane.addListToViewList(fileList) ⇒ Array.<File>
+#### pane.addListToViewList(fileList) ⇒ Array.<File>
Adds the given file list to the end of the workingset.
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: Array.<File> - list of files added to the list
| Param | Type |
| --- | --- |
| fileList | Array.<File> |
-
+
-### pane.makeViewMostRecent(file)
+#### pane.makeViewMostRecent(file)
Moves the specified file to the front of the MRU (Most Recently Used) list.
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
| Param | Type | Description |
| --- | --- | --- |
| file | File | The file to move to the front of the MRU list. |
-
+
-### pane.sortViewList(compareFn)
+#### pane.sortViewList(compareFn)
Sorts items in the pane's view list.
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
| Param | Type | Description |
| --- | --- | --- |
| compareFn | function | The function used to compare items in the view list. |
-
+
-### pane.swapViewListIndexes(index1, index2) ⇒ boolean
+#### pane.swapViewListIndexes(index1, index2) ⇒ boolean
Swaps two items in the file view list (used while dragging items in the working set view)
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: boolean - } true
| Param | Type | Description |
@@ -288,12 +464,12 @@ Swaps two items in the file view list (used while dragging items in the working
| index1 | number | the index of the first item to swap |
| index2 | number | the index of the second item to swap |
-
+
-### pane.traverseViewListByMRU(direction, [current]) ⇒ File
+#### pane.traverseViewListByMRU(direction, [current]) ⇒ File
Traverses the list and returns the File object of the next item in the MRU order
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: File - The File object of the next item in the travesal order or null if there isn't one.
| Param | Type | Description |
@@ -301,103 +477,103 @@ Traverses the list and returns the File object of the next item in the MRU order
| direction | number | Must be 1 or -1 to traverse forward or backward |
| [current] | string | the fullPath of the item where traversal is to start. If this parameter is omitted then the path of the current view is used. If the current view is a temporary view then the first item in the MRU list is returned |
-
+
-### pane.showInterstitial(show)
+#### pane.showInterstitial(show)
Shows the pane's interstitial page
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
| Param | Type | Description |
| --- | --- | --- |
| show | boolean | show or hide the interstitial page |
-
+
-### pane.getViewForPath(path) ⇒ boolean
+#### pane.getViewForPath(path) ⇒ boolean
retrieves the view object for the given path
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: boolean - show - show or hide the interstitial page
| Param | Type | Description |
| --- | --- | --- |
| path | string | the fullPath of the view to retrieve |
-
+
-### pane.addView(view, show)
+#### pane.addView(view, show)
Adds a view to the pane
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
| Param | Type | Description |
| --- | --- | --- |
| view | View | the View object to add |
| show | boolean | true to show the view right away, false otherwise |
-
+
-### pane.showView(view)
+#### pane.showView(view)
Swaps the current view with the requested view.
If the interstitial page is shown, it is hidden.
If the currentView is a temporary view, it is destroyed.
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
| Param | Type | Description |
| --- | --- | --- |
| view | View | the to show |
-
+
-### pane.updateLayout(forceRefresh)
+#### pane.updateLayout(forceRefresh)
Sets pane content height. Updates the layout causing the current view to redraw itself
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
| Param | Type | Description |
| --- | --- | --- |
| forceRefresh | boolean | true to force a resize and refresh of the current view, false if just to resize forceRefresh is only used by Editor views to force a relayout of all editor DOM elements. Custom View implementations should just ignore this flag. |
-
+
-### pane.getCurrentlyViewedFile() ⇒ File
+#### pane.getCurrentlyViewedFile() ⇒ File
Retrieves the File object of the current view
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: File - the File object of the current view or null if there isn't one
-
+
-### pane.getCurrentlyViewedEditor() ⇒ File
+#### pane.getCurrentlyViewedEditor() ⇒ File
Retrieves the File object of the current view
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: File - the File object of the current view or null if there isn't one
-
+
-### pane.getCurrentlyViewedPath() ⇒ string
+#### pane.getCurrentlyViewedPath() ⇒ string
Retrieves the path of the current view
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: string - the path of the current view or null if there isn't one
-
+
-### pane.destroyViewIfNotNeeded(view)
+#### pane.destroyViewIfNotNeeded(view)
destroys the view if it isn't needed
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
| Param | Type | Description |
| --- | --- | --- |
| view | View | the view to destroy |
-
+
-### pane.removeView(file, suppressOpenNextFile, preventViewChange) ⇒ boolean
+#### pane.removeView(file, suppressOpenNextFile, preventViewChange) ⇒ boolean
Removes the view and opens the next view
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: boolean - true if the file was removed from the working set
This function will remove a temporary view of a file but will return false in that case
@@ -407,13 +583,13 @@ Removes the view and opens the next view
| suppressOpenNextFile | boolean | suppresses opening the next file in MRU order |
| preventViewChange | boolean | if suppressOpenNextFile is truthy, this flag can be used to prevent the current view from being destroyed. Ignored if suppressOpenNextFile is falsy |
-
+
-### pane.removeViews(list) ⇒ Array.<File>
+#### pane.removeViews(list) ⇒ Array.<File>
Removes the specifed file from all internal lists, destroys the view of the file (if there is one)
and shows the interstitial page if the current view is destroyed.
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: Array.<File> - Array of File objects removed from the working set.
This function will remove temporary views but the file objects for those views will not be found
in the result set. Only the file objects removed from the working set are returned.
@@ -422,178 +598,47 @@ Removes the specifed file from all internal lists, destroys the view of the file
| --- | --- | --- |
| list | Array.<File> | Array of files to remove |
-
+
-### pane.focus()
+#### pane.focus()
Gives focus to the last thing that had focus, the current view or the pane in that order
-**Kind**: instance method of [Pane](#Pane)
-
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
+
-### pane.loadState(state) ⇒ jQuery.Promise
+#### pane.loadState(state) ⇒ jQuery.Promise
serializes the pane state from JSON
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: jQuery.Promise - A promise which resolves to \{fullPath:string, paneId:string} which can be passed as command data to FILE_OPEN
| Param | Type | Description |
| --- | --- | --- |
| state | Object | the state to load |
-
+
-### pane.saveState() ⇒ Object
+#### pane.saveState() ⇒ Object
Returns the JSON-ified state of the object so it can be serialize
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: Object - state - the state to save
-
+
-### pane.getScrollState() ⇒ Object
+#### pane.getScrollState() ⇒ Object
gets the current view's scroll state data
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
**Returns**: Object - scroll state - the current scroll state
-
+
-### pane.restoreAndAdjustScrollState([state], [heightDelta])
+#### pane.restoreAndAdjustScrollState([state], [heightDelta])
tells the current view to restore its scroll state from cached data and apply a height delta
-**Kind**: instance method of [Pane](#Pane)
+**Kind**: instance method of [Pane](#module_view/Pane..Pane)
| Param | Type | Description |
| --- | --- | --- |
| [state] | Object | the current scroll state |
| [heightDelta] | number | the amount to add or subtract from the state |
-
-
-## \_
-Pane objects host views of files, editors, etc... Clients cannot access
-Pane objects directly. Instead the implementation is protected by the
-MainViewManager -- however View Factories are given a Pane object which
-they can use to add views. References to Pane objects should not be kept
-as they may be destroyed and removed from the DOM.
-
-To get a custom view, there are two components:
-
- 1) A View Factory
- 2) A View Object
-
-View objects are anonymous object that have a particular interface.
-
-Views can be added to a pane but do not have to exist in the Pane object's view list.
-Such views are "temporary views". Temporary views are not serialized with the Pane state
-or reconstituted when the pane is serialized from disk. They are destroyed at the earliest
-opportunity.
-
-Temporary views are added by calling `Pane.showView()` and passing it the view object. The view
-will be destroyed when the next view is shown, the pane is mereged with another pane or the "Close All"
-command is exectuted on the Pane. Temporary Editor Views do not contain any modifications and are
-added to the workingset (and are no longer tempoary views) once the document has been modified. They
-will remain in the working set until closed from that point on.
-
-Views that have a longer life span are added by calling addView to associate the view with a
-filename in the _views object. These views are not destroyed until they are removed from the pane
-by calling one of the following: removeView, removeViews, or _reset
-
-Pane Object Events:
-
- - viewListChange - Whenever there is a file change to a file in the working set. These 2 events: `DocumentManager.pathRemove`
- and `DocumentManager.fileNameChange` will cause a `viewListChange` event so the WorkingSetView can update.
-
- - currentViewChange - Whenever the current view changes.
- (e, newView:View, oldView:View)
-
- - viewDestroy - Whenever a view has been destroyed
- (e, view:View)
-
-View Interface:
-
-The view is an anonymous object which has the following method signatures. see ImageViewer for an example or the sample
-provided with Brackets `src/extensions/samples/BracketsConfigCentral`
-
-```js
- {
- $el:jQuery
- getFile: function ():!File
- updateLayout: function(forceRefresh:boolean)
- destroy: function()
- getScrollPos: function():*=
- adjustScrollPos: function(state:Object=, heightDelta:number)=
- notifyContainerChange: function()=
- notifyVisibilityChange: function(boolean)=
- focus:function()=
- }
-```
-When views are created they can be added to the pane by calling `pane.addView()`.
-Views can be created and parented by attaching directly to `pane.$el`
-
- this._codeMirror = new CodeMirror(pane.$el, ...)
-
-Factories can create a view that's initially hidden by calling `pane.addView(view)` and passing `false` for the show parameter.
-Hidden views can be later shown by calling `pane.showView(view)`
-
-`$el:jQuery!`
-
- property that stores the jQuery wrapped DOM element of the view. All views must have one so pane objects can manipulate the DOM
- element when necessary (e.g. `showView`, `_reparent`, etc...)
-
-`getFile():File!`
-
- Called throughout the life of a View when the current file is queried by the system.
-
-`updateLayout(forceRefresh:boolean)`
-
- Called to notify the view that it should be resized to fit its parent container. This may be called several times
- or only once. Views can ignore the `forceRefresh` flag. It is used for editor views to force a relayout of the editor
- which probably isn't necessary for most views. Views should implement their html to be dynamic and not rely on this
- function to be called whenever possible.
-
-`destroy()`
-
- Views must implement a destroy method to remove their DOM element at the very least. There is no default
- implementation and views are hidden before this method is called. The Pane object doesn't make assumptions
- about when it is safe to remove a node. In some instances other cleanup must take place before a the DOM
- node is destroyed so the implementation details are left to the view.
-
- Views can implement a simple destroy by calling
-
- this.$el.remove()
-
- These members are optional and need not be implemented by Views
-
- getScrollPos()
- adjustScrollPos()
-
- The system at various times will want to save and restore a view's scroll position. The data returned by `getScrollPos()`
- is specific to the view and will be passed back to `adjustScrollPos()` when the scroll position needs to be restored.
-
- When Modal Bars are invoked, the system calls `getScrollPos()` so that the current scroll psotion of all visible Views can be cached.
- That cached scroll position is later passed to `adjustScrollPos()` along with a height delta. The height delta is used to
- scroll the view so that it doesn't appear to have "jumped" when invoking the Modal Bar.
-
- Height delta will be a positive when the Modal Bar is being shown and negative number when the Modal Bar is being hidden.
-
- `getViewState()` is another optional member that is used to cache a view's state when hiding or destroying a view or closing the project.
- The data returned by this member is stored in `ViewStateManager` and is saved with the project.
-
- Views or View Factories are responsible for restoring the view state when the view of that file is created by recalling the cached state
-
- var view = createIconView(file, pane);
- view.restoreViewState(ViewStateManager.getViewState(file.fullPath));
-
- Notifications
- The following optional methods receive notifications from the Pane object when certain events take place which affect the view:
-
-`notifyContainerChange()`
-
- Optional Notification callback called when the container changes. The view can perform any synchronization or state update
- it needs to do when its parent container changes.
-
-`notifyVisiblityChange()`
-
- Optional Notification callback called when the view's vsibility changes. The view can perform any synchronization or
- state update it needs to do when its visiblity state changes.
-
-**Kind**: global variable
diff --git a/docs/API-Reference/view/SidebarTabs.md b/docs/API-Reference/view/SidebarTabs.md
new file mode 100644
index 0000000000..fbbd4bdd60
--- /dev/null
+++ b/docs/API-Reference/view/SidebarTabs.md
@@ -0,0 +1,139 @@
+### Import :
+```js
+const SidebarTabs = brackets.getModule("view/SidebarTabs")
+```
+
+
+
+## view/SidebarTabs
+SidebarTabs manages multiple tab panes within the sidebar. It inserts a
+`#navTabBar` element after `#mainNavBar` and provides an API for registering
+tabs, associating DOM content with tabs, and switching between them.
+
+Existing sidebar children that are not explicitly associated with a tab via
+`addToTab` are treated as belonging to the default "Files" tab. This means
+extensions that add DOM nodes to the sidebar will continue to work without
+any code changes.
+
+Tab switching works purely by toggling the `.sidebar-tab-hidden` CSS class
+(`display: none !important`). No DOM reparenting or detaching occurs, so
+cached jQuery/DOM references held by extensions remain valid.
+
+
+* [view/SidebarTabs](#module_view/SidebarTabs)
+ * [.SIDEBAR_TAB_FILES](#module_view/SidebarTabs..SIDEBAR_TAB_FILES) : string
+ * [.EVENT_TAB_ADDED](#module_view/SidebarTabs..EVENT_TAB_ADDED) : string
+ * [.EVENT_TAB_REMOVED](#module_view/SidebarTabs..EVENT_TAB_REMOVED) : string
+ * [.EVENT_TAB_CHANGED](#module_view/SidebarTabs..EVENT_TAB_CHANGED) : string
+ * [.addTab(id, label, iconClass, [options])](#module_view/SidebarTabs..addTab)
+ * [.addToTab(tabId, $content)](#module_view/SidebarTabs..addToTab)
+ * [.removeFromTab(tabId, $content)](#module_view/SidebarTabs..removeFromTab)
+ * [.removeTab(id)](#module_view/SidebarTabs..removeTab) ⇒ boolean
+ * [.setActiveTab(id)](#module_view/SidebarTabs..setActiveTab)
+ * [.getActiveTab()](#module_view/SidebarTabs..getActiveTab) ⇒ string
+ * [.getAllTabs()](#module_view/SidebarTabs..getAllTabs) ⇒ Array.<{id: string, label: string, iconClass: string, priority: number}>
+
+
+
+### view/SidebarTabs.SIDEBAR\_TAB\_FILES : string
+The built-in Files tab id.
+
+**Kind**: inner constant of [view/SidebarTabs](#module_view/SidebarTabs)
+
+
+### view/SidebarTabs.EVENT\_TAB\_ADDED : string
+Fired when a new tab is registered via `addTab`.
+
+**Kind**: inner constant of [view/SidebarTabs](#module_view/SidebarTabs)
+
+
+### view/SidebarTabs.EVENT\_TAB\_REMOVED : string
+Fired when a tab is removed via `removeTab`.
+
+**Kind**: inner constant of [view/SidebarTabs](#module_view/SidebarTabs)
+
+
+### view/SidebarTabs.EVENT\_TAB\_CHANGED : string
+Fired when the active tab changes via `setActiveTab`.
+
+**Kind**: inner constant of [view/SidebarTabs](#module_view/SidebarTabs)
+
+
+### view/SidebarTabs.addTab(id, label, iconClass, [options])
+Register a new sidebar tab.
+
+**Kind**: inner method of [view/SidebarTabs](#module_view/SidebarTabs)
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| id | string | | Unique tab identifier |
+| label | string | | Display text shown in the tab bar |
+| iconClass | string | | FontAwesome (or other) icon class string |
+| [options] | Object | | |
+| [options.priority] | number | 100 | Lower values appear further left |
+
+
+
+### view/SidebarTabs.addToTab(tabId, $content)
+Associate a DOM node (or jQuery element) with a tab. If the node is not
+already a child of `#sidebar`, it is appended. If the tab is not the
+currently active tab, the node is immediately hidden.
+
+**Kind**: inner method of [view/SidebarTabs](#module_view/SidebarTabs)
+
+| Param | Type | Description |
+| --- | --- | --- |
+| tabId | string | The tab to associate with |
+| $content | jQuery \| Element | DOM node or jQuery wrapper |
+
+
+
+### view/SidebarTabs.removeFromTab(tabId, $content)
+Remove a DOM node's association with a tab. If the node was appended by
+`addToTab` (was not originally in the sidebar) and is no longer
+associated with any tab, it is also removed from the DOM.
+
+**Kind**: inner method of [view/SidebarTabs](#module_view/SidebarTabs)
+
+| Param | Type | Description |
+| --- | --- | --- |
+| tabId | string | The tab to disassociate from |
+| $content | jQuery \| Element | DOM node or jQuery wrapper |
+
+
+
+### view/SidebarTabs.removeTab(id) ⇒ boolean
+Remove a tab entirely. Only succeeds if all content has been removed via
+`removeFromTab` first. Returns false if content still exists.
+
+**Kind**: inner method of [view/SidebarTabs](#module_view/SidebarTabs)
+**Returns**: boolean - true if removed, false if content still associated
+
+| Param | Type | Description |
+| --- | --- | --- |
+| id | string | The tab id to remove |
+
+
+
+### view/SidebarTabs.setActiveTab(id)
+Switch the active sidebar tab. Shows nodes associated with the target
+tab, hides all others.
+
+**Kind**: inner method of [view/SidebarTabs](#module_view/SidebarTabs)
+
+| Param | Type | Description |
+| --- | --- | --- |
+| id | string | The tab id to activate |
+
+
+
+### view/SidebarTabs.getActiveTab() ⇒ string
+Get the currently active tab id.
+
+**Kind**: inner method of [view/SidebarTabs](#module_view/SidebarTabs)
+
+
+### view/SidebarTabs.getAllTabs() ⇒ Array.<{id: string, label: string, iconClass: string, priority: number}>
+Get an array of all registered tab descriptors.
+
+**Kind**: inner method of [view/SidebarTabs](#module_view/SidebarTabs)
diff --git a/docs/API-Reference/view/ViewStateManager.md b/docs/API-Reference/view/ViewStateManager.md
index b888fee6a1..e0092f2fdc 100644
--- a/docs/API-Reference/view/ViewStateManager.md
+++ b/docs/API-Reference/view/ViewStateManager.md
@@ -3,9 +3,9 @@
const ViewStateManager = brackets.getModule("view/ViewStateManager")
```
-
+
-## \_
+## view/ViewStateManager
ViewStateManager is a singleton for views to park their global viwe state. The state is saved
with project data but the View or View Factory is responsible for restoring the view state
when the view is created.
@@ -16,43 +16,49 @@ for later use.
Views or View Factories are responsible for restoring the view state when the view of that file is created
by recalling the cached state. Views determine what data is store in the view state and how to restore it.
-**Kind**: global variable
-
-## reset()
+* [view/ViewStateManager](#module_view/ViewStateManager)
+ * [.reset()](#module_view/ViewStateManager..reset)
+ * [.updateViewState(view, viewState)](#module_view/ViewStateManager..updateViewState)
+ * [.getViewState(file)](#module_view/ViewStateManager..getViewState) ⇒ \*
+ * [.addViewStates(viewStates)](#module_view/ViewStateManager..addViewStates)
+
+
+
+### view/ViewStateManager.reset()
resets the view state cache
-**Kind**: global function
-
+**Kind**: inner method of [view/ViewStateManager](#module_view/ViewStateManager)
+
-## updateViewState(view, viewState)
+### view/ViewStateManager.updateViewState(view, viewState)
Updates the view state for the specified view
-**Kind**: global function
+**Kind**: inner method of [view/ViewStateManager](#module_view/ViewStateManager)
| Param | Type | Description |
| --- | --- | --- |
| view | Object | the to save state |
| viewState | \* | any data that the view needs to restore the view state. |
-
+
-## getViewState(file) ⇒ \*
+### view/ViewStateManager.getViewState(file) ⇒ \*
gets the view state for the specified file
-**Kind**: global function
+**Kind**: inner method of [view/ViewStateManager](#module_view/ViewStateManager)
**Returns**: \* - whatever data that was saved earlier with a call setViewState
| Param | Type | Description |
| --- | --- | --- |
| file | File | the file to record the view state for |
-
+
-## addViewStates(viewStates)
+### view/ViewStateManager.addViewStates(viewStates)
adds an array of view states
-**Kind**: global function
+**Kind**: inner method of [view/ViewStateManager](#module_view/ViewStateManager)
| Param | Type | Description |
| --- | --- | --- |
diff --git a/docs/API-Reference/view/WorkspaceManager.md b/docs/API-Reference/view/WorkspaceManager.md
index 34948a2665..8d39dbbaaf 100644
--- a/docs/API-Reference/view/WorkspaceManager.md
+++ b/docs/API-Reference/view/WorkspaceManager.md
@@ -3,21 +3,9 @@
const WorkspaceManager = brackets.getModule("view/WorkspaceManager")
```
-
+
-## PANEL\_TYPE\_BOTTOM\_PANEL : string
-Constant representing the type of bottom panel
-
-**Kind**: global variable
-
-
-## PANEL\_TYPE\_PLUGIN\_PANEL : string
-Constant representing the type of plugin panel
-
-**Kind**: global variable
-
-
-## AppInit
+## view/WorkspaceManager
Manages layout of panels surrounding the editor area, and size of the editor area (but not its contents).
Updates panel sizes when the window is resized. Maintains the max resizing limits for panels, based on
@@ -28,32 +16,62 @@ Events:
The 2nd arg is the available workspace height.
The 3rd arg is a refreshHint flag for internal use (passed in to recomputeLayout)
-**Kind**: global constant
-
-## EVENT\_WORKSPACE\_UPDATE\_LAYOUT
+* [view/WorkspaceManager](#module_view/WorkspaceManager)
+ * _static_
+ * [.PANEL_TYPE_BOTTOM_PANEL](#module_view/WorkspaceManager.PANEL_TYPE_BOTTOM_PANEL) : string
+ * [.PANEL_TYPE_PLUGIN_PANEL](#module_view/WorkspaceManager.PANEL_TYPE_PLUGIN_PANEL) : string
+ * _inner_
+ * [.EVENT_WORKSPACE_UPDATE_LAYOUT](#module_view/WorkspaceManager..EVENT_WORKSPACE_UPDATE_LAYOUT)
+ * [.EVENT_WORKSPACE_PANEL_SHOWN](#module_view/WorkspaceManager..EVENT_WORKSPACE_PANEL_SHOWN)
+ * [.EVENT_WORKSPACE_PANEL_HIDDEN](#module_view/WorkspaceManager..EVENT_WORKSPACE_PANEL_HIDDEN)
+ * [.createBottomPanel(id, $panel, [minSize])](#module_view/WorkspaceManager..createBottomPanel) ⇒ Panel
+ * [.createPluginPanel(id, $panel, [minSize], $toolbarIcon, [initialSize])](#module_view/WorkspaceManager..createPluginPanel) ⇒ Panel
+ * [.getAllPanelIDs()](#module_view/WorkspaceManager..getAllPanelIDs) ⇒ Array
+ * [.getPanelForID(panelID)](#module_view/WorkspaceManager..getPanelForID) ⇒ Object
+ * [.recomputeLayout(refreshHint)](#module_view/WorkspaceManager..recomputeLayout)
+ * [.isPanelVisible(panelID)](#module_view/WorkspaceManager..isPanelVisible) ⇒ boolean
+ * [.setPluginPanelWidth(width)](#module_view/WorkspaceManager..setPluginPanelWidth)
+ * [.addEscapeKeyEventHandler(consumerName, eventHandler)](#module_view/WorkspaceManager..addEscapeKeyEventHandler) ⇒ boolean
+ * [.removeEscapeKeyEventHandler(consumerName)](#module_view/WorkspaceManager..removeEscapeKeyEventHandler) ⇒ boolean
+
+
+
+### view/WorkspaceManager.PANEL\_TYPE\_BOTTOM\_PANEL : string
+Constant representing the type of bottom panel
+
+**Kind**: static property of [view/WorkspaceManager](#module_view/WorkspaceManager)
+
+
+### view/WorkspaceManager.PANEL\_TYPE\_PLUGIN\_PANEL : string
+Constant representing the type of plugin panel
+
+**Kind**: static property of [view/WorkspaceManager](#module_view/WorkspaceManager)
+
+
+### view/WorkspaceManager.EVENT\_WORKSPACE\_UPDATE\_LAYOUT
Event triggered when the workspace layout updates.
-**Kind**: global constant
-
+**Kind**: inner constant of [view/WorkspaceManager](#module_view/WorkspaceManager)
+
-## EVENT\_WORKSPACE\_PANEL\_SHOWN
+### view/WorkspaceManager.EVENT\_WORKSPACE\_PANEL\_SHOWN
Event triggered when a panel is shown.
-**Kind**: global constant
-
+**Kind**: inner constant of [view/WorkspaceManager](#module_view/WorkspaceManager)
+
-## EVENT\_WORKSPACE\_PANEL\_HIDDEN
+### view/WorkspaceManager.EVENT\_WORKSPACE\_PANEL\_HIDDEN
Event triggered when a panel is hidden.
-**Kind**: global constant
-
+**Kind**: inner constant of [view/WorkspaceManager](#module_view/WorkspaceManager)
+
-## createBottomPanel(id, $panel, [minSize]) ⇒ Panel
+### view/WorkspaceManager.createBottomPanel(id, $panel, [minSize]) ⇒ Panel
Creates a new resizable panel beneath the editor area and above the status bar footer. Panel is initially invisible.
The panel's size & visibility are automatically saved & restored as a view-state preference.
-**Kind**: global function
+**Kind**: inner method of [view/WorkspaceManager](#module_view/WorkspaceManager)
| Param | Type | Description |
| --- | --- | --- |
@@ -61,14 +79,14 @@ The panel's size & visibility are automatically saved & restored as a view-state
| $panel | jQueryObject | DOM content to use as the panel. Need not be in the document yet. Must have an id attribute, for use as a preferences key. |
| [minSize] | number | Minimum height of panel in px. |
-
+
-## createPluginPanel(id, $panel, [minSize], $toolbarIcon, [initialSize]) ⇒ Panel
+### view/WorkspaceManager.createPluginPanel(id, $panel, [minSize], $toolbarIcon, [initialSize]) ⇒ Panel
Creates a new resizable plugin panel associated with the given toolbar icon. Panel is initially invisible.
The panel's size & visibility are automatically saved & restored. Only one panel can be associated with a
toolbar icon.
-**Kind**: global function
+**Kind**: inner method of [view/WorkspaceManager](#module_view/WorkspaceManager)
| Param | Type | Description |
| --- | --- | --- |
@@ -78,57 +96,71 @@ toolbar icon.
| $toolbarIcon | jQueryObject | An icon that should be present in main-toolbar to associate this panel to. The panel will be shown only if the icon is visible on the toolbar and the user clicks on the icon. |
| [initialSize] | number | Optional Initial size of panel in px. If not given, panel will use minsize or current size. |
-
+
-## getAllPanelIDs() ⇒ Array
+### view/WorkspaceManager.getAllPanelIDs() ⇒ Array
Returns an array of all panel ID's
-**Kind**: global function
+**Kind**: inner method of [view/WorkspaceManager](#module_view/WorkspaceManager)
**Returns**: Array - List of ID's of all bottom panels
-
+
-## getPanelForID(panelID) ⇒ Object
+### view/WorkspaceManager.getPanelForID(panelID) ⇒ Object
Gets the Panel interface for the given ID. Can return undefined if no panel with the ID is found.
-**Kind**: global function
+**Kind**: inner method of [view/WorkspaceManager](#module_view/WorkspaceManager)
**Returns**: Object - Panel object for the ID or undefined
| Param | Type |
| --- | --- |
| panelID | string |
-
+
-## recomputeLayout(refreshHint)
+### view/WorkspaceManager.recomputeLayout(refreshHint)
Called when an external widget has appeared and needs some of the space occupied
by the mainview manager
-**Kind**: global function
+**Kind**: inner method of [view/WorkspaceManager](#module_view/WorkspaceManager)
| Param | Type | Description |
| --- | --- | --- |
| refreshHint | boolean | true to refresh the editor, false if not |
-
+
-## isPanelVisible(panelID) ⇒ boolean
+### view/WorkspaceManager.isPanelVisible(panelID) ⇒ boolean
Responsible to check if the panel is visible or not.
Returns true if visible else false.
-**Kind**: global function
+**Kind**: inner method of [view/WorkspaceManager](#module_view/WorkspaceManager)
| Param |
| --- |
| panelID |
-
+
+
+### view/WorkspaceManager.setPluginPanelWidth(width)
+Programmatically sets the plugin panel content width to the given value in pixels.
+The total toolbar width is adjusted to account for the plugin icons bar.
+Width is clamped to respect panel minWidth and max size (75% of window).
+No-op if no panel is currently visible.
+
+**Kind**: inner method of [view/WorkspaceManager](#module_view/WorkspaceManager)
+
+| Param | Type | Description |
+| --- | --- | --- |
+| width | number | Desired content width in pixels |
+
+
-## addEscapeKeyEventHandler(consumerName, eventHandler) ⇒ boolean
+### view/WorkspaceManager.addEscapeKeyEventHandler(consumerName, eventHandler) ⇒ boolean
If any widgets related to the editor needs to handle the escape key event, add it here. returning true from the
registered handler will prevent primary escape key toggle panel behavior of phoenix. Note that returning true
will no stop the event bubbling, that has to be controlled with the event parameter forwarded to the handler.
-**Kind**: global function
+**Kind**: inner method of [view/WorkspaceManager](#module_view/WorkspaceManager)
**Returns**: boolean - true if added
| Param | Type | Description |
@@ -136,12 +168,12 @@ will no stop the event bubbling, that has to be controlled with the event parame
| consumerName | string | a unique name for your consumer |
| eventHandler | function | If the eventHandler returns true for this callback, the escape key event will not lead to panel toggle default behavior. |
-
+
-## removeEscapeKeyEventHandler(consumerName) ⇒ boolean
+### view/WorkspaceManager.removeEscapeKeyEventHandler(consumerName) ⇒ boolean
Removing the escape key event consumer.
-**Kind**: global function
+**Kind**: inner method of [view/WorkspaceManager](#module_view/WorkspaceManager)
**Returns**: boolean - true if removed
| Param | Type | Description |
diff --git a/gulpfile.js/thirdparty-lib-copy.js b/gulpfile.js/thirdparty-lib-copy.js
index 466db4ec62..3e35b93808 100644
--- a/gulpfile.js/thirdparty-lib-copy.js
+++ b/gulpfile.js/thirdparty-lib-copy.js
@@ -242,7 +242,9 @@ let copyThirdPartyLibs = series(
// jasmine-reporters
copyFiles.bind(copyFiles, ['node_modules/jasmine-reporters/src/**/*'],
'test/thirdparty/jasmine-reporters/'),
- copyLicence.bind(copyLicence, 'node_modules/jasmine-reporters/LICENSE', 'jasmine-reporters')
+ copyLicence.bind(copyLicence, 'node_modules/jasmine-reporters/LICENSE', 'jasmine-reporters'),
+ // lmdb
+ copyLicence.bind(copyLicence, 'node_modules/lmdb/LICENSE', 'lmdb')
);
diff --git a/package-lock.json b/package-lock.json
index 27808ef6cc..2d1ac373ed 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,18 +1,19 @@
{
"name": "phoenix",
- "version": "4.1.2-0",
+ "version": "5.1.4-0",
"lockfileVersion": 2,
"requires": true,
"packages": {
"": {
"name": "phoenix",
- "version": "4.1.2-0",
+ "version": "5.1.4-0",
+ "hasInstallScript": true,
"dependencies": {
"@bugsnag/js": "^7.18.0",
"@floating-ui/dom": "^0.5.4",
"@fortawesome/fontawesome-free": "^6.1.2",
"@highlightjs/cdn-assets": "^11.5.1",
- "@phcode/fs": "^3.0.1",
+ "@phcode/fs": "^4.0.2",
"@phcode/language-support": "^1.1.0",
"@pixelbrackets/gfm-stylesheet": "^1.1.0",
"@prettier/plugin-php": "^0.22.2",
@@ -28,7 +29,7 @@
"jshint": "^2.13.5",
"jszip": "^3.8.0",
"less": "^4.1.3",
- "lodash": "^4.17.21",
+ "lodash": "^4.17.23",
"lru-cache": "^10.2.0",
"marked": "^4.0.18",
"mime-db": "^1.52.0",
@@ -64,6 +65,7 @@
"jasmine-core": "^4.2.0",
"jasmine-reporters": "^2.5.0",
"jsdoc-to-markdown": "^9.1.1",
+ "lmdb": "^3.5.1",
"readable-stream": "^3.6.0",
"through2": "^4.0.2"
}
@@ -797,6 +799,13 @@
"xtend": "~4.0.1"
}
},
+ "node_modules/@harperfast/extended-iterable": {
+ "version": "1.0.3",
+ "resolved": "https://registry.npmjs.org/@harperfast/extended-iterable/-/extended-iterable-1.0.3.tgz",
+ "integrity": "sha512-sSAYhQca3rDWtQUHSAPeO7axFIUJOI6hn1gjRC5APVE1a90tuyT8f5WIgRsFhhWA7htNkju2veB9eWL6YHi/Lw==",
+ "dev": true,
+ "license": "Apache-2.0"
+ },
"node_modules/@highlightjs/cdn-assets": {
"version": "11.5.1",
"resolved": "https://registry.npmjs.org/@highlightjs/cdn-assets/-/cdn-assets-11.5.1.tgz",
@@ -862,6 +871,188 @@
"node": ">=v12.0.0"
}
},
+ "node_modules/@lmdb/lmdb-darwin-arm64": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-darwin-arm64/-/lmdb-darwin-arm64-3.5.1.tgz",
+ "integrity": "sha512-tpfN4kKrrMpQ+If1l8bhmoNkECJi0iOu6AEdrTJvWVC+32sLxTARX5Rsu579mPImRP9YFWfWgeRQ5oav7zApQQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ]
+ },
+ "node_modules/@lmdb/lmdb-darwin-x64": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-darwin-x64/-/lmdb-darwin-x64-3.5.1.tgz",
+ "integrity": "sha512-+a2tTfc3rmWhLAolFUWRgJtpSuu+Fw/yjn4rF406NMxhfjbMuiOUTDRvRlMFV+DzyjkwnokisskHbCWkS3Ly5w==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ]
+ },
+ "node_modules/@lmdb/lmdb-linux-arm": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-linux-arm/-/lmdb-linux-arm-3.5.1.tgz",
+ "integrity": "sha512-0EgcE6reYr8InjD7V37EgXcYrloqpxVPINy3ig1MwDSbl6LF/vXTYRH9OE1Ti1D8YZnB35ZH9aTcdfSb5lql2A==",
+ "cpu": [
+ "arm"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@lmdb/lmdb-linux-arm64": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-linux-arm64/-/lmdb-linux-arm64-3.5.1.tgz",
+ "integrity": "sha512-aoERa5B6ywXdyFeYGQ1gbQpkMkDbEo45qVoXE5QpIRavqjnyPwjOulMkmkypkmsbJ5z4Wi0TBztON8agCTG0Vg==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@lmdb/lmdb-linux-x64": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-linux-x64/-/lmdb-linux-x64-3.5.1.tgz",
+ "integrity": "sha512-SqNDY1+vpji7bh0sFH5wlWyFTOzjbDOl0/kB5RLLYDAFyd/uw3n7wyrmas3rYPpAW7z18lMOi1yKlTPv967E3g==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@lmdb/lmdb-win32-arm64": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-win32-arm64/-/lmdb-win32-arm64-3.5.1.tgz",
+ "integrity": "sha512-50v0O1Lt37cwrmR9vWZK5hRW0Aw+KEmxJJ75fge/zIYdvNKB/0bSMSVR5Uc2OV9JhosIUyklOmrEvavwNJ8D6w==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
+ "node_modules/@lmdb/lmdb-win32-x64": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-win32-x64/-/lmdb-win32-x64-3.5.1.tgz",
+ "integrity": "sha512-qwosvPyl+zpUlp3gRb7UcJ3H8S28XHCzkv0Y0EgQToXjQP91ZD67EHSCDmaLjtKhe+GVIW5om1KUpzVLA0l6pg==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
+ "node_modules/@msgpackr-extract/msgpackr-extract-darwin-arm64": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@msgpackr-extract/msgpackr-extract-darwin-arm64/-/msgpackr-extract-darwin-arm64-3.0.3.tgz",
+ "integrity": "sha512-QZHtlVgbAdy2zAqNA9Gu1UpIuI8Xvsd1v8ic6B2pZmeFnFcMWiPLfWXh7TVw4eGEZ/C9TH281KwhVoeQUKbyjw==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ]
+ },
+ "node_modules/@msgpackr-extract/msgpackr-extract-darwin-x64": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@msgpackr-extract/msgpackr-extract-darwin-x64/-/msgpackr-extract-darwin-x64-3.0.3.tgz",
+ "integrity": "sha512-mdzd3AVzYKuUmiWOQ8GNhl64/IoFGol569zNRdkLReh6LRLHOXxU4U8eq0JwaD8iFHdVGqSy4IjFL4reoWCDFw==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ]
+ },
+ "node_modules/@msgpackr-extract/msgpackr-extract-linux-arm": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@msgpackr-extract/msgpackr-extract-linux-arm/-/msgpackr-extract-linux-arm-3.0.3.tgz",
+ "integrity": "sha512-fg0uy/dG/nZEXfYilKoRe7yALaNmHoYeIoJuJ7KJ+YyU2bvY8vPv27f7UKhGRpY6euFYqEVhxCFZgAUNQBM3nw==",
+ "cpu": [
+ "arm"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@msgpackr-extract/msgpackr-extract-linux-arm64": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@msgpackr-extract/msgpackr-extract-linux-arm64/-/msgpackr-extract-linux-arm64-3.0.3.tgz",
+ "integrity": "sha512-YxQL+ax0XqBJDZiKimS2XQaf+2wDGVa1enVRGzEvLLVFeqa5kx2bWbtcSXgsxjQB7nRqqIGFIcLteF/sHeVtQg==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@msgpackr-extract/msgpackr-extract-linux-x64": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@msgpackr-extract/msgpackr-extract-linux-x64/-/msgpackr-extract-linux-x64-3.0.3.tgz",
+ "integrity": "sha512-cvwNfbP07pKUfq1uH+S6KJ7dT9K8WOE4ZiAcsrSes+UY55E/0jLYc+vq+DO7jlmqRb5zAggExKm0H7O/CBaesg==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@msgpackr-extract/msgpackr-extract-win32-x64": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@msgpackr-extract/msgpackr-extract-win32-x64/-/msgpackr-extract-win32-x64-3.0.3.tgz",
+ "integrity": "sha512-x0fWaQtYp4E6sktbsdAqnehxDgEc/VwM7uLsRCYWaiGu0ykYdZPiS8zCWdnjHwyiumousxfBm4SO31eXqwEZhQ==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
"node_modules/@nodelib/fs.scandir": {
"version": "2.1.5",
"resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
@@ -898,10 +1089,9 @@
}
},
"node_modules/@phcode/fs": {
- "version": "3.0.1",
- "resolved": "https://registry.npmjs.org/@phcode/fs/-/fs-3.0.1.tgz",
- "integrity": "sha512-IntWO/GdUyC7BX+WeDQUTZmL8inGY//aiFzaphw1eni+0LRh3aGSK61eOlwlpcdA3TRxEzbEyH15NZYaUaWRHg==",
- "license": "GNU-AGPL3.0",
+ "version": "4.0.2",
+ "resolved": "https://registry.npmjs.org/@phcode/fs/-/fs-4.0.2.tgz",
+ "integrity": "sha512-vjR2EtMizOj/tf30FObT1KkbBFwLRkVWFsnyUdt0sex6H/lpxRgjKp7NO8YBUKROw66eMoL+7kGyHKAlfV9zWA==",
"dependencies": {
"chokidar": "^3.5.3",
"ignore": "^5.2.4",
@@ -1083,6 +1273,7 @@
"resolved": "https://registry.npmjs.org/@types/markdown-it/-/markdown-it-14.1.2.tgz",
"integrity": "sha512-promo4eFwuiW+TfGxhi+0x3czqTYJkG8qB17ZUJiVF10Xm7NLVRSLUsfRTU/6h1e24VvRnXCx+hG7li58lkzog==",
"dev": true,
+ "peer": true,
"dependencies": {
"@types/linkify-it": "^5",
"@types/mdurl": "^2"
@@ -1104,7 +1295,8 @@
"version": "17.0.8",
"resolved": "https://registry.npmjs.org/@types/node/-/node-17.0.8.tgz",
"integrity": "sha512-YofkM6fGv4gDJq78g4j0mMuGMkZVxZDgtU0JRdx6FgiJDG+0fY0GKVolOV8WqVmEhLCXkQRjwDdKyPxJp/uucg==",
- "dev": true
+ "dev": true,
+ "peer": true
},
"node_modules/@types/normalize-package-data": {
"version": "2.4.4",
@@ -1150,6 +1342,7 @@
"resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz",
"integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
"dev": true,
+ "peer": true,
"bin": {
"acorn": "bin/acorn"
},
@@ -3822,6 +4015,16 @@
"node": ">=0.10.0"
}
},
+ "node_modules/detect-libc": {
+ "version": "2.1.2",
+ "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+ "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "engines": {
+ "node": ">=8"
+ }
+ },
"node_modules/devicon": {
"version": "2.15.1",
"resolved": "https://registry.npmjs.org/devicon/-/devicon-2.15.1.tgz",
@@ -4202,6 +4405,7 @@
"resolved": "https://registry.npmjs.org/eslint/-/eslint-8.19.0.tgz",
"integrity": "sha512-SXOPj3x9VKvPe81TjjUJCYlV4oJjQw68Uek+AM0X4p+33dj2HY5bpTZOgnQHcG2eAm1mtCU9uNMnJi7exU/kYw==",
"dev": true,
+ "peer": true,
"dependencies": {
"@eslint/eslintrc": "^1.3.0",
"@humanwhocodes/config-array": "^0.9.2",
@@ -5901,6 +6105,7 @@
"resolved": "https://registry.npmjs.org/gulp/-/gulp-4.0.2.tgz",
"integrity": "sha512-dvEs27SCZt2ibF29xYgmnwwCYZxdxhQ/+LFWlbAW8y7jt68L/65402Lz3+CKy0Ov4rOs+NERmDq7YlZaDqUIfA==",
"dev": true,
+ "peer": true,
"dependencies": {
"glob-watcher": "^5.0.3",
"gulp-cli": "^2.2.0",
@@ -8029,6 +8234,34 @@
"uc.micro": "^2.0.0"
}
},
+ "node_modules/lmdb": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/lmdb/-/lmdb-3.5.1.tgz",
+ "integrity": "sha512-NYHA0MRPjvNX+vSw8Xxg6FLKxzAG+e7Pt8RqAQA/EehzHVXq9SxDqJIN3JL1hK0dweb884y8kIh6rkWvPyg9Wg==",
+ "dev": true,
+ "hasInstallScript": true,
+ "license": "MIT",
+ "dependencies": {
+ "@harperfast/extended-iterable": "^1.0.3",
+ "msgpackr": "^1.11.2",
+ "node-addon-api": "^6.1.0",
+ "node-gyp-build-optional-packages": "5.2.2",
+ "ordered-binary": "^1.5.3",
+ "weak-lru-cache": "^1.2.2"
+ },
+ "bin": {
+ "download-lmdb-prebuilds": "bin/download-prebuilds.js"
+ },
+ "optionalDependencies": {
+ "@lmdb/lmdb-darwin-arm64": "3.5.1",
+ "@lmdb/lmdb-darwin-x64": "3.5.1",
+ "@lmdb/lmdb-linux-arm": "3.5.1",
+ "@lmdb/lmdb-linux-arm64": "3.5.1",
+ "@lmdb/lmdb-linux-x64": "3.5.1",
+ "@lmdb/lmdb-win32-arm64": "3.5.1",
+ "@lmdb/lmdb-win32-x64": "3.5.1"
+ }
+ },
"node_modules/load-json-file": {
"version": "1.1.0",
"resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz",
@@ -8061,9 +8294,10 @@
}
},
"node_modules/lodash": {
- "version": "4.17.21",
- "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
- "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg=="
+ "version": "4.17.23",
+ "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz",
+ "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==",
+ "license": "MIT"
},
"node_modules/lodash._escapehtmlchar": {
"version": "2.4.1",
@@ -8819,6 +9053,39 @@
"integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==",
"devOptional": true
},
+ "node_modules/msgpackr": {
+ "version": "1.11.8",
+ "resolved": "https://registry.npmjs.org/msgpackr/-/msgpackr-1.11.8.tgz",
+ "integrity": "sha512-bC4UGzHhVvgDNS7kn9tV8fAucIYUBuGojcaLiz7v+P63Lmtm0Xeji8B/8tYKddALXxJLpwIeBmUN3u64C4YkRA==",
+ "dev": true,
+ "license": "MIT",
+ "optionalDependencies": {
+ "msgpackr-extract": "^3.0.2"
+ }
+ },
+ "node_modules/msgpackr-extract": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/msgpackr-extract/-/msgpackr-extract-3.0.3.tgz",
+ "integrity": "sha512-P0efT1C9jIdVRefqjzOQ9Xml57zpOXnIuS+csaB4MdZbTdmGDLo8XhzBG1N7aO11gKDDkJvBLULeFTo46wwreA==",
+ "dev": true,
+ "hasInstallScript": true,
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "node-gyp-build-optional-packages": "5.2.2"
+ },
+ "bin": {
+ "download-msgpackr-prebuilds": "bin/download-prebuilds.js"
+ },
+ "optionalDependencies": {
+ "@msgpackr-extract/msgpackr-extract-darwin-arm64": "3.0.3",
+ "@msgpackr-extract/msgpackr-extract-darwin-x64": "3.0.3",
+ "@msgpackr-extract/msgpackr-extract-linux-arm": "3.0.3",
+ "@msgpackr-extract/msgpackr-extract-linux-arm64": "3.0.3",
+ "@msgpackr-extract/msgpackr-extract-linux-x64": "3.0.3",
+ "@msgpackr-extract/msgpackr-extract-win32-x64": "3.0.3"
+ }
+ },
"node_modules/multipipe": {
"version": "0.1.2",
"resolved": "https://registry.npmjs.org/multipipe/-/multipipe-0.1.2.tgz",
@@ -8939,6 +9206,28 @@
"integrity": "sha512-CXdUiJembsNjuToQvxayPZF9Vqht7hewsvy2sOWafLvi2awflj9mOC6bHIg50orX8IJvWKY9wYQ/zB2kogPslQ==",
"dev": true
},
+ "node_modules/node-addon-api": {
+ "version": "6.1.0",
+ "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-6.1.0.tgz",
+ "integrity": "sha512-+eawOlIgy680F0kBzPUNFhMZGtJ1YmqM6l4+Crf4IkImjYrO/mqPwRMh352g23uIaQKFItcQ64I7KMaJxHgAVA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/node-gyp-build-optional-packages": {
+ "version": "5.2.2",
+ "resolved": "https://registry.npmjs.org/node-gyp-build-optional-packages/-/node-gyp-build-optional-packages-5.2.2.tgz",
+ "integrity": "sha512-s+w+rBWnpTMwSFbaE0UXsRlg7hU4FjekKU4eyAih5T8nJuNZT1nNsskXpxmeqSK9UzkBl6UgRlnKc8hz8IEqOw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "detect-libc": "^2.0.1"
+ },
+ "bin": {
+ "node-gyp-build-optional-packages": "bin.js",
+ "node-gyp-build-optional-packages-optional": "optional.js",
+ "node-gyp-build-optional-packages-test": "build-test.js"
+ }
+ },
"node_modules/node.extend": {
"version": "1.1.8",
"resolved": "https://registry.npmjs.org/node.extend/-/node.extend-1.1.8.tgz",
@@ -9270,6 +9559,13 @@
"node": ">= 0.8.0"
}
},
+ "node_modules/ordered-binary": {
+ "version": "1.6.1",
+ "resolved": "https://registry.npmjs.org/ordered-binary/-/ordered-binary-1.6.1.tgz",
+ "integrity": "sha512-QkCdPooczexPLiXIrbVOPYkR3VO3T6v2OyKRkR1Xbhpy7/LAVXwahnRCgRp78Oe/Ehf0C/HATAxfSr6eA1oX+w==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/ordered-read-streams": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/ordered-read-streams/-/ordered-read-streams-1.0.1.tgz",
@@ -10054,6 +10350,7 @@
"version": "3.2.5",
"resolved": "https://registry.npmjs.org/prettier/-/prettier-3.2.5.tgz",
"integrity": "sha512-3/GWa9aOC0YeD7LUfvOG2NiDyhOWRvt1k+rcKhOuYnMY24iiCphgneUfJDyFXd6rZCAnuLBv6UeAULtrhT/F4A==",
+ "peer": true,
"bin": {
"prettier": "bin/prettier.cjs"
},
@@ -12148,6 +12445,7 @@
"resolved": "https://registry.npmjs.org/typescript/-/typescript-4.9.5.tgz",
"integrity": "sha512-1FXk9E2Hm+QzZQ7z+McJiHL4NW1F2EzMu9Nq9i3zAaGqibafqYwCVU6WyWAuyQRRzOlxou8xZSyXLEN8oKj24g==",
"dev": true,
+ "peer": true,
"bin": {
"tsc": "bin/tsc",
"tsserver": "bin/tsserver"
@@ -12607,6 +12905,13 @@
"node >=0.1.95"
]
},
+ "node_modules/weak-lru-cache": {
+ "version": "1.2.2",
+ "resolved": "https://registry.npmjs.org/weak-lru-cache/-/weak-lru-cache-1.2.2.tgz",
+ "integrity": "sha512-DEAoo25RfSYMuTGc9vPJzZcZullwIqRDSI9LOy+fkCJPi6hykCnfKaXTuPBDuXAUcqHXyOgFtHNp/kB2FjYHbw==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/websocket-driver": {
"version": "0.7.4",
"resolved": "https://registry.npmjs.org/websocket-driver/-/websocket-driver-0.7.4.tgz",
@@ -13533,6 +13838,12 @@
}
}
},
+ "@harperfast/extended-iterable": {
+ "version": "1.0.3",
+ "resolved": "https://registry.npmjs.org/@harperfast/extended-iterable/-/extended-iterable-1.0.3.tgz",
+ "integrity": "sha512-sSAYhQca3rDWtQUHSAPeO7axFIUJOI6hn1gjRC5APVE1a90tuyT8f5WIgRsFhhWA7htNkju2veB9eWL6YHi/Lw==",
+ "dev": true
+ },
"@highlightjs/cdn-assets": {
"version": "11.5.1",
"resolved": "https://registry.npmjs.org/@highlightjs/cdn-assets/-/cdn-assets-11.5.1.tgz",
@@ -13586,6 +13897,97 @@
"lodash": "^4.17.21"
}
},
+ "@lmdb/lmdb-darwin-arm64": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-darwin-arm64/-/lmdb-darwin-arm64-3.5.1.tgz",
+ "integrity": "sha512-tpfN4kKrrMpQ+If1l8bhmoNkECJi0iOu6AEdrTJvWVC+32sLxTARX5Rsu579mPImRP9YFWfWgeRQ5oav7zApQQ==",
+ "dev": true,
+ "optional": true
+ },
+ "@lmdb/lmdb-darwin-x64": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-darwin-x64/-/lmdb-darwin-x64-3.5.1.tgz",
+ "integrity": "sha512-+a2tTfc3rmWhLAolFUWRgJtpSuu+Fw/yjn4rF406NMxhfjbMuiOUTDRvRlMFV+DzyjkwnokisskHbCWkS3Ly5w==",
+ "dev": true,
+ "optional": true
+ },
+ "@lmdb/lmdb-linux-arm": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-linux-arm/-/lmdb-linux-arm-3.5.1.tgz",
+ "integrity": "sha512-0EgcE6reYr8InjD7V37EgXcYrloqpxVPINy3ig1MwDSbl6LF/vXTYRH9OE1Ti1D8YZnB35ZH9aTcdfSb5lql2A==",
+ "dev": true,
+ "optional": true
+ },
+ "@lmdb/lmdb-linux-arm64": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-linux-arm64/-/lmdb-linux-arm64-3.5.1.tgz",
+ "integrity": "sha512-aoERa5B6ywXdyFeYGQ1gbQpkMkDbEo45qVoXE5QpIRavqjnyPwjOulMkmkypkmsbJ5z4Wi0TBztON8agCTG0Vg==",
+ "dev": true,
+ "optional": true
+ },
+ "@lmdb/lmdb-linux-x64": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-linux-x64/-/lmdb-linux-x64-3.5.1.tgz",
+ "integrity": "sha512-SqNDY1+vpji7bh0sFH5wlWyFTOzjbDOl0/kB5RLLYDAFyd/uw3n7wyrmas3rYPpAW7z18lMOi1yKlTPv967E3g==",
+ "dev": true,
+ "optional": true
+ },
+ "@lmdb/lmdb-win32-arm64": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-win32-arm64/-/lmdb-win32-arm64-3.5.1.tgz",
+ "integrity": "sha512-50v0O1Lt37cwrmR9vWZK5hRW0Aw+KEmxJJ75fge/zIYdvNKB/0bSMSVR5Uc2OV9JhosIUyklOmrEvavwNJ8D6w==",
+ "dev": true,
+ "optional": true
+ },
+ "@lmdb/lmdb-win32-x64": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/@lmdb/lmdb-win32-x64/-/lmdb-win32-x64-3.5.1.tgz",
+ "integrity": "sha512-qwosvPyl+zpUlp3gRb7UcJ3H8S28XHCzkv0Y0EgQToXjQP91ZD67EHSCDmaLjtKhe+GVIW5om1KUpzVLA0l6pg==",
+ "dev": true,
+ "optional": true
+ },
+ "@msgpackr-extract/msgpackr-extract-darwin-arm64": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@msgpackr-extract/msgpackr-extract-darwin-arm64/-/msgpackr-extract-darwin-arm64-3.0.3.tgz",
+ "integrity": "sha512-QZHtlVgbAdy2zAqNA9Gu1UpIuI8Xvsd1v8ic6B2pZmeFnFcMWiPLfWXh7TVw4eGEZ/C9TH281KwhVoeQUKbyjw==",
+ "dev": true,
+ "optional": true
+ },
+ "@msgpackr-extract/msgpackr-extract-darwin-x64": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@msgpackr-extract/msgpackr-extract-darwin-x64/-/msgpackr-extract-darwin-x64-3.0.3.tgz",
+ "integrity": "sha512-mdzd3AVzYKuUmiWOQ8GNhl64/IoFGol569zNRdkLReh6LRLHOXxU4U8eq0JwaD8iFHdVGqSy4IjFL4reoWCDFw==",
+ "dev": true,
+ "optional": true
+ },
+ "@msgpackr-extract/msgpackr-extract-linux-arm": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@msgpackr-extract/msgpackr-extract-linux-arm/-/msgpackr-extract-linux-arm-3.0.3.tgz",
+ "integrity": "sha512-fg0uy/dG/nZEXfYilKoRe7yALaNmHoYeIoJuJ7KJ+YyU2bvY8vPv27f7UKhGRpY6euFYqEVhxCFZgAUNQBM3nw==",
+ "dev": true,
+ "optional": true
+ },
+ "@msgpackr-extract/msgpackr-extract-linux-arm64": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@msgpackr-extract/msgpackr-extract-linux-arm64/-/msgpackr-extract-linux-arm64-3.0.3.tgz",
+ "integrity": "sha512-YxQL+ax0XqBJDZiKimS2XQaf+2wDGVa1enVRGzEvLLVFeqa5kx2bWbtcSXgsxjQB7nRqqIGFIcLteF/sHeVtQg==",
+ "dev": true,
+ "optional": true
+ },
+ "@msgpackr-extract/msgpackr-extract-linux-x64": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@msgpackr-extract/msgpackr-extract-linux-x64/-/msgpackr-extract-linux-x64-3.0.3.tgz",
+ "integrity": "sha512-cvwNfbP07pKUfq1uH+S6KJ7dT9K8WOE4ZiAcsrSes+UY55E/0jLYc+vq+DO7jlmqRb5zAggExKm0H7O/CBaesg==",
+ "dev": true,
+ "optional": true
+ },
+ "@msgpackr-extract/msgpackr-extract-win32-x64": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@msgpackr-extract/msgpackr-extract-win32-x64/-/msgpackr-extract-win32-x64-3.0.3.tgz",
+ "integrity": "sha512-x0fWaQtYp4E6sktbsdAqnehxDgEc/VwM7uLsRCYWaiGu0ykYdZPiS8zCWdnjHwyiumousxfBm4SO31eXqwEZhQ==",
+ "dev": true,
+ "optional": true
+ },
"@nodelib/fs.scandir": {
"version": "2.1.5",
"resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
@@ -13613,9 +14015,9 @@
}
},
"@phcode/fs": {
- "version": "3.0.1",
- "resolved": "https://registry.npmjs.org/@phcode/fs/-/fs-3.0.1.tgz",
- "integrity": "sha512-IntWO/GdUyC7BX+WeDQUTZmL8inGY//aiFzaphw1eni+0LRh3aGSK61eOlwlpcdA3TRxEzbEyH15NZYaUaWRHg==",
+ "version": "4.0.2",
+ "resolved": "https://registry.npmjs.org/@phcode/fs/-/fs-4.0.2.tgz",
+ "integrity": "sha512-vjR2EtMizOj/tf30FObT1KkbBFwLRkVWFsnyUdt0sex6H/lpxRgjKp7NO8YBUKROw66eMoL+7kGyHKAlfV9zWA==",
"requires": {
"chokidar": "^3.5.3",
"ignore": "^5.2.4",
@@ -13749,6 +14151,7 @@
"resolved": "https://registry.npmjs.org/@types/markdown-it/-/markdown-it-14.1.2.tgz",
"integrity": "sha512-promo4eFwuiW+TfGxhi+0x3czqTYJkG8qB17ZUJiVF10Xm7NLVRSLUsfRTU/6h1e24VvRnXCx+hG7li58lkzog==",
"dev": true,
+ "peer": true,
"requires": {
"@types/linkify-it": "^5",
"@types/mdurl": "^2"
@@ -13770,7 +14173,8 @@
"version": "17.0.8",
"resolved": "https://registry.npmjs.org/@types/node/-/node-17.0.8.tgz",
"integrity": "sha512-YofkM6fGv4gDJq78g4j0mMuGMkZVxZDgtU0JRdx6FgiJDG+0fY0GKVolOV8WqVmEhLCXkQRjwDdKyPxJp/uucg==",
- "dev": true
+ "dev": true,
+ "peer": true
},
"@types/normalize-package-data": {
"version": "2.4.4",
@@ -13809,7 +14213,8 @@
"version": "8.15.0",
"resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz",
"integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
- "dev": true
+ "dev": true,
+ "peer": true
},
"acorn-jsx": {
"version": "5.3.2",
@@ -15924,6 +16329,12 @@
"integrity": "sha1-8NZtA2cqglyxtzvbP+YjEMjlUrc=",
"dev": true
},
+ "detect-libc": {
+ "version": "2.1.2",
+ "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+ "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
+ "dev": true
+ },
"devicon": {
"version": "2.15.1",
"resolved": "https://registry.npmjs.org/devicon/-/devicon-2.15.1.tgz",
@@ -16250,6 +16661,7 @@
"resolved": "https://registry.npmjs.org/eslint/-/eslint-8.19.0.tgz",
"integrity": "sha512-SXOPj3x9VKvPe81TjjUJCYlV4oJjQw68Uek+AM0X4p+33dj2HY5bpTZOgnQHcG2eAm1mtCU9uNMnJi7exU/kYw==",
"dev": true,
+ "peer": true,
"requires": {
"@eslint/eslintrc": "^1.3.0",
"@humanwhocodes/config-array": "^0.9.2",
@@ -17603,6 +18015,7 @@
"resolved": "https://registry.npmjs.org/gulp/-/gulp-4.0.2.tgz",
"integrity": "sha512-dvEs27SCZt2ibF29xYgmnwwCYZxdxhQ/+LFWlbAW8y7jt68L/65402Lz3+CKy0Ov4rOs+NERmDq7YlZaDqUIfA==",
"dev": true,
+ "peer": true,
"requires": {
"glob-watcher": "^5.0.3",
"gulp-cli": "^2.2.0",
@@ -19310,6 +19723,27 @@
"uc.micro": "^2.0.0"
}
},
+ "lmdb": {
+ "version": "3.5.1",
+ "resolved": "https://registry.npmjs.org/lmdb/-/lmdb-3.5.1.tgz",
+ "integrity": "sha512-NYHA0MRPjvNX+vSw8Xxg6FLKxzAG+e7Pt8RqAQA/EehzHVXq9SxDqJIN3JL1hK0dweb884y8kIh6rkWvPyg9Wg==",
+ "dev": true,
+ "requires": {
+ "@harperfast/extended-iterable": "^1.0.3",
+ "@lmdb/lmdb-darwin-arm64": "3.5.1",
+ "@lmdb/lmdb-darwin-x64": "3.5.1",
+ "@lmdb/lmdb-linux-arm": "3.5.1",
+ "@lmdb/lmdb-linux-arm64": "3.5.1",
+ "@lmdb/lmdb-linux-x64": "3.5.1",
+ "@lmdb/lmdb-win32-arm64": "3.5.1",
+ "@lmdb/lmdb-win32-x64": "3.5.1",
+ "msgpackr": "^1.11.2",
+ "node-addon-api": "^6.1.0",
+ "node-gyp-build-optional-packages": "5.2.2",
+ "ordered-binary": "^1.5.3",
+ "weak-lru-cache": "^1.2.2"
+ }
+ },
"load-json-file": {
"version": "1.1.0",
"resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz",
@@ -19333,9 +19767,9 @@
}
},
"lodash": {
- "version": "4.17.21",
- "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
- "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg=="
+ "version": "4.17.23",
+ "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz",
+ "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w=="
},
"lodash._escapehtmlchar": {
"version": "2.4.1",
@@ -19977,6 +20411,31 @@
"integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==",
"devOptional": true
},
+ "msgpackr": {
+ "version": "1.11.8",
+ "resolved": "https://registry.npmjs.org/msgpackr/-/msgpackr-1.11.8.tgz",
+ "integrity": "sha512-bC4UGzHhVvgDNS7kn9tV8fAucIYUBuGojcaLiz7v+P63Lmtm0Xeji8B/8tYKddALXxJLpwIeBmUN3u64C4YkRA==",
+ "dev": true,
+ "requires": {
+ "msgpackr-extract": "^3.0.2"
+ }
+ },
+ "msgpackr-extract": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/msgpackr-extract/-/msgpackr-extract-3.0.3.tgz",
+ "integrity": "sha512-P0efT1C9jIdVRefqjzOQ9Xml57zpOXnIuS+csaB4MdZbTdmGDLo8XhzBG1N7aO11gKDDkJvBLULeFTo46wwreA==",
+ "dev": true,
+ "optional": true,
+ "requires": {
+ "@msgpackr-extract/msgpackr-extract-darwin-arm64": "3.0.3",
+ "@msgpackr-extract/msgpackr-extract-darwin-x64": "3.0.3",
+ "@msgpackr-extract/msgpackr-extract-linux-arm": "3.0.3",
+ "@msgpackr-extract/msgpackr-extract-linux-arm64": "3.0.3",
+ "@msgpackr-extract/msgpackr-extract-linux-x64": "3.0.3",
+ "@msgpackr-extract/msgpackr-extract-win32-x64": "3.0.3",
+ "node-gyp-build-optional-packages": "5.2.2"
+ }
+ },
"multipipe": {
"version": "0.1.2",
"resolved": "https://registry.npmjs.org/multipipe/-/multipipe-0.1.2.tgz",
@@ -20078,6 +20537,21 @@
"integrity": "sha512-CXdUiJembsNjuToQvxayPZF9Vqht7hewsvy2sOWafLvi2awflj9mOC6bHIg50orX8IJvWKY9wYQ/zB2kogPslQ==",
"dev": true
},
+ "node-addon-api": {
+ "version": "6.1.0",
+ "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-6.1.0.tgz",
+ "integrity": "sha512-+eawOlIgy680F0kBzPUNFhMZGtJ1YmqM6l4+Crf4IkImjYrO/mqPwRMh352g23uIaQKFItcQ64I7KMaJxHgAVA==",
+ "dev": true
+ },
+ "node-gyp-build-optional-packages": {
+ "version": "5.2.2",
+ "resolved": "https://registry.npmjs.org/node-gyp-build-optional-packages/-/node-gyp-build-optional-packages-5.2.2.tgz",
+ "integrity": "sha512-s+w+rBWnpTMwSFbaE0UXsRlg7hU4FjekKU4eyAih5T8nJuNZT1nNsskXpxmeqSK9UzkBl6UgRlnKc8hz8IEqOw==",
+ "dev": true,
+ "requires": {
+ "detect-libc": "^2.0.1"
+ }
+ },
"node.extend": {
"version": "1.1.8",
"resolved": "https://registry.npmjs.org/node.extend/-/node.extend-1.1.8.tgz",
@@ -20329,6 +20803,12 @@
"word-wrap": "^1.2.3"
}
},
+ "ordered-binary": {
+ "version": "1.6.1",
+ "resolved": "https://registry.npmjs.org/ordered-binary/-/ordered-binary-1.6.1.tgz",
+ "integrity": "sha512-QkCdPooczexPLiXIrbVOPYkR3VO3T6v2OyKRkR1Xbhpy7/LAVXwahnRCgRp78Oe/Ehf0C/HATAxfSr6eA1oX+w==",
+ "dev": true
+ },
"ordered-read-streams": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/ordered-read-streams/-/ordered-read-streams-1.0.1.tgz",
@@ -20987,7 +21467,8 @@
"prettier": {
"version": "3.2.5",
"resolved": "https://registry.npmjs.org/prettier/-/prettier-3.2.5.tgz",
- "integrity": "sha512-3/GWa9aOC0YeD7LUfvOG2NiDyhOWRvt1k+rcKhOuYnMY24iiCphgneUfJDyFXd6rZCAnuLBv6UeAULtrhT/F4A=="
+ "integrity": "sha512-3/GWa9aOC0YeD7LUfvOG2NiDyhOWRvt1k+rcKhOuYnMY24iiCphgneUfJDyFXd6rZCAnuLBv6UeAULtrhT/F4A==",
+ "peer": true
},
"pretty-hrtime": {
"version": "1.0.3",
@@ -22668,7 +23149,8 @@
"version": "4.9.5",
"resolved": "https://registry.npmjs.org/typescript/-/typescript-4.9.5.tgz",
"integrity": "sha512-1FXk9E2Hm+QzZQ7z+McJiHL4NW1F2EzMu9Nq9i3zAaGqibafqYwCVU6WyWAuyQRRzOlxou8xZSyXLEN8oKj24g==",
- "dev": true
+ "dev": true,
+ "peer": true
},
"typical": {
"version": "7.3.0",
@@ -23043,6 +23525,12 @@
"integrity": "sha1-6NugkbdFZ5mjr1eXi5hud+EyBAY=",
"dev": true
},
+ "weak-lru-cache": {
+ "version": "1.2.2",
+ "resolved": "https://registry.npmjs.org/weak-lru-cache/-/weak-lru-cache-1.2.2.tgz",
+ "integrity": "sha512-DEAoo25RfSYMuTGc9vPJzZcZullwIqRDSI9LOy+fkCJPi6hykCnfKaXTuPBDuXAUcqHXyOgFtHNp/kB2FjYHbw==",
+ "dev": true
+ },
"websocket-driver": {
"version": "0.7.4",
"resolved": "https://registry.npmjs.org/websocket-driver/-/websocket-driver-0.7.4.tgz",
diff --git a/package.json b/package.json
index 72a8396309..e93657da42 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
{
"name": "phoenix",
- "version": "5.0.5-0",
- "apiVersion": "5.0.5",
+ "version": "5.1.4-0",
+ "apiVersion": "5.1.4",
"homepage": "https://core.ai",
"issues": {
"url": "https://github.com/phcode-dev/phoenix/issues"
@@ -38,9 +38,11 @@
"jasmine-reporters": "^2.5.0",
"jsdoc-to-markdown": "^9.1.1",
"readable-stream": "^3.6.0",
- "through2": "^4.0.2"
+ "through2": "^4.0.2",
+ "lmdb": "^3.5.1"
},
"scripts": {
+ "postinstall": "npm install --prefix phoenix-builder-mcp",
"lint": "eslint --quiet src test",
"lint:fix": "eslint --quiet --fix src test",
"prepare": "husky install",
@@ -94,7 +96,7 @@
"@floating-ui/dom": "^0.5.4",
"@fortawesome/fontawesome-free": "^6.1.2",
"@highlightjs/cdn-assets": "^11.5.1",
- "@phcode/fs": "^3.0.1",
+ "@phcode/fs": "^4.0.2",
"@phcode/language-support": "^1.1.0",
"@pixelbrackets/gfm-stylesheet": "^1.1.0",
"@prettier/plugin-php": "^0.22.2",
@@ -110,7 +112,7 @@
"jshint": "^2.13.5",
"jszip": "^3.8.0",
"less": "^4.1.3",
- "lodash": "^4.17.21",
+ "lodash": "^4.17.23",
"lru-cache": "^10.2.0",
"marked": "^4.0.18",
"mime-db": "^1.52.0",
diff --git a/phoenix-builder-mcp/README.md b/phoenix-builder-mcp/README.md
new file mode 100644
index 0000000000..9d088b8535
--- /dev/null
+++ b/phoenix-builder-mcp/README.md
@@ -0,0 +1,128 @@
+# Phoenix Builder MCP
+
+An MCP (Model Context Protocol) server that lets Claude Code launch, control, and inspect a running Phoenix Code instance. It also includes a Chrome extension that enables screenshot capture when Phoenix runs in a browser.
+
+## Prerequisites
+
+- Node.js
+- The [phoenix-desktop](https://github.com/nicedoc/phoenix-desktop) repo cloned alongside this repo (i.e. `../phoenix-desktop`)
+
+## Setup
+
+### 1. Install dependencies
+
+```bash
+cd phoenix-builder-mcp
+npm install
+```
+
+### 2. Claude Code MCP configuration
+
+The project root already contains `.mcp.json` which registers the server automatically:
+
+```json
+{
+ "mcpServers": {
+ "phoenix-builder": {
+ "command": "node",
+ "args": ["phoenix-builder-mcp/index.js"],
+ "env": {
+ "PHOENIX_DESKTOP_PATH": "../phoenix-desktop"
+ }
+ }
+ }
+}
+```
+
+Set `PHOENIX_DESKTOP_PATH` to the path of your phoenix-desktop checkout if it is not at `../phoenix-desktop`.
+
+You can also set `PHOENIX_MCP_WS_PORT` (default `38571`) to change the WebSocket port used for communication between the MCP server and the Phoenix browser runtime.
+
+### 3. Chrome extension (for browser screenshots)
+
+Screenshots work out of the box in the Electron/Tauri desktop app. If you are running Phoenix in a browser (e.g. `localhost` or `phcode.dev`), you need to install the Chrome extension:
+
+#### Loading as an unpacked extension (development)
+
+1. Open `chrome://extensions` in Chrome.
+2. Enable **Developer mode** (toggle in the top-right corner).
+3. Click **Load unpacked**.
+4. Select the `phoenix-builder-mcp/chrome_extension/` directory.
+5. The extension will appear as "Phoenix Code Screenshot".
+
+Once loaded, any Phoenix page on `localhost` or `phcode.dev` will have `window._phoenixScreenshotExtensionAvailable` set to `true`, and the `take_screenshot` MCP tool and `Phoenix.app.screenShotBinary()` API will work in the browser.
+
+#### Building a .zip for distribution
+
+```bash
+cd phoenix-builder-mcp/chrome_extension
+./build.sh
+```
+
+This produces `chrome_extension/build/phoenix-screenshot-extension.zip`.
+
+To build a signed `.crx` you need the Chrome binary and a private key:
+
+```bash
+chrome --pack-extension=./phoenix-builder-mcp/chrome_extension --pack-extension-key=key.pem
+```
+
+## MCP Tools
+
+Once the MCP server is running, the following tools are available in Claude Code:
+
+### `start_phoenix`
+Launches the Phoenix Code Electron app by running `npm run serve:electron` in the phoenix-desktop directory. Returns the process PID and WebSocket port.
+
+### `stop_phoenix`
+Stops the running Phoenix Code process (SIGTERM, then SIGKILL after 5s).
+
+### `get_phoenix_status`
+Returns process status, PID, WebSocket connection state, connected instance names, and the WS port.
+
+### `get_terminal_logs`
+Returns stdout/stderr from the Electron process. By default returns only new logs since the last call. Pass `clear: true` to get all logs and clear the buffer.
+
+### `get_browser_console_logs`
+Returns `console.log`/`warn`/`error` output forwarded from the Phoenix browser runtime over WebSocket. Supports the same `clear` flag. When multiple Phoenix instances are connected, pass `instance` to target a specific one (e.g. `"Phoenix-a3f2"`).
+
+### `take_screenshot`
+Captures a PNG screenshot of the Phoenix window. Optionally pass a `selector` (CSS selector string) to capture a specific element. Returns the image directly as `image/png`.
+
+In Electron/Tauri this uses the native capture API. In the browser it requires the Chrome extension (see above).
+
+### `reload_phoenix`
+Reloads the Phoenix app. Prompts to save unsaved files before reloading.
+
+### `force_reload_phoenix`
+Force-reloads the Phoenix app without saving unsaved changes.
+
+## Typical Claude Code workflow
+
+```
+> start_phoenix # launches the app
+> take_screenshot # see what the UI looks like
+> get_browser_console_logs # check for errors
+> reload_phoenix # pick up code changes
+> take_screenshot # verify the fix
+> stop_phoenix # done
+```
+
+## Architecture
+
+```
+Claude Code <--stdio--> MCP Server (index.js)
+ |
+ +-- process-manager.js (spawns/kills Electron)
+ +-- ws-control-server.js (WebSocket on port 38571)
+ |
+ Phoenix browser runtime
+ (connects back over WS for logs, screenshots, reload)
+```
+
+For browser-mode screenshots the flow is:
+
+```
+MCP Server --WS--> Phoenix runtime --postMessage--> Content Script --chrome.runtime--> Background SW
+ (captureVisibleTab)
+```
diff --git a/phoenix-builder-mcp/chrome_extension/background.js b/phoenix-builder-mcp/chrome_extension/background.js
new file mode 100644
index 0000000000..aa83f8959f
--- /dev/null
+++ b/phoenix-builder-mcp/chrome_extension/background.js
@@ -0,0 +1,13 @@
+chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
+ if (message.type !== "phoenix_screenshot_capture") {
+ return false;
+ }
+ chrome.tabs.captureVisibleTab(null, { format: "png" })
+ .then(dataUrl => {
+ sendResponse({ success: true, dataUrl });
+ })
+ .catch(err => {
+ sendResponse({ success: false, error: err.message || String(err) });
+ });
+ return true; // keep channel open for async sendResponse
+});
diff --git a/phoenix-builder-mcp/chrome_extension/build.sh b/phoenix-builder-mcp/chrome_extension/build.sh
new file mode 100755
index 0000000000..45fcd1e96e
--- /dev/null
+++ b/phoenix-builder-mcp/chrome_extension/build.sh
@@ -0,0 +1,26 @@
+#!/bin/bash
+# Builds a .zip of the Chrome extension for distribution or local install.
+# Usage: ./build.sh
+#
+# To load as an unpacked extension during development:
+# 1. Open chrome://extensions
+# 2. Enable "Developer mode"
+# 3. Click "Load unpacked" and select this directory
+#
+# To build a .crx (signed package) you need the Chrome binary and a private key:
+# chrome --pack-extension=./phoenix-builder-mcp/chrome_extension --pack-extension-key=key.pem
+
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+BUILD_DIR="$SCRIPT_DIR/build"
+
+rm -rf "$BUILD_DIR"
+mkdir -p "$BUILD_DIR"
+
+zip -j "$BUILD_DIR/phoenix-screenshot-extension.zip" \
+ "$SCRIPT_DIR/manifest.json" \
+ "$SCRIPT_DIR/background.js" \
+ "$SCRIPT_DIR/content-script.js" \
+ "$SCRIPT_DIR/page-script.js"
+
+echo "Built: $BUILD_DIR/phoenix-screenshot-extension.zip"
diff --git a/phoenix-builder-mcp/chrome_extension/content-script.js b/phoenix-builder-mcp/chrome_extension/content-script.js
new file mode 100644
index 0000000000..a6993556fb
--- /dev/null
+++ b/phoenix-builder-mcp/chrome_extension/content-script.js
@@ -0,0 +1,27 @@
+// Relay screenshot requests from the page to the background service worker.
+// The availability flag (window._phoenixScreenshotExtensionAvailable) is set by
+// page-script.js which runs in the MAIN world via the manifest.
+window.addEventListener("message", (event) => {
+ if (event.source !== window || !event.data || event.data.type !== "phoenix_screenshot_request") {
+ return;
+ }
+ const requestId = event.data.id;
+ chrome.runtime.sendMessage({ type: "phoenix_screenshot_capture" }, (response) => {
+ if (chrome.runtime.lastError) {
+ window.postMessage({
+ type: "phoenix_screenshot_response",
+ id: requestId,
+ success: false,
+ error: chrome.runtime.lastError.message || "Extension communication error"
+ }, "*");
+ return;
+ }
+ window.postMessage({
+ type: "phoenix_screenshot_response",
+ id: requestId,
+ success: response.success,
+ dataUrl: response.dataUrl,
+ error: response.error
+ }, "*");
+ });
+});
diff --git a/phoenix-builder-mcp/chrome_extension/manifest.json b/phoenix-builder-mcp/chrome_extension/manifest.json
new file mode 100644
index 0000000000..33e83db6ff
--- /dev/null
+++ b/phoenix-builder-mcp/chrome_extension/manifest.json
@@ -0,0 +1,36 @@
+{
+ "manifest_version": 3,
+ "name": "Phoenix Code Screenshot",
+ "version": "1.0.0",
+ "description": "Enables screenshot capture in Phoenix Code when running in the browser.",
+ "permissions": [],
+ "host_permissions": [
+ "