flexlayout-react 0.7.14 → 0.8.0

package/README.md

@@ -6,13 +6,13 @@
 
 FlexLayout is a layout manager that arranges React components in multiple tab sets, tabs can be resized and moved.
 
-![FlexLayout Demo Screenshot](/../screenshots/github_images/v0.5/demo1.png?raw=true "FlexLayout Demo Screenshot")
+![FlexLayout Demo Screenshot](Screenshot_light.png?raw=true "FlexLayout Demo Screenshot")
 
-[Run the Demo](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.7/demo/index.html)
+[Run the Demo](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.8/demo/index.html)
 
-Try it now using [JSFiddle](https://jsfiddle.net/10kmLzvu/)
+Try it now using [JSFiddle](https://jsfiddle.net/fvd9btea/)
 
-[API Doc](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.7/typedoc/index.html)
+[API Doc](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.8/typedoc/index.html)
 
 [Screenshot of Caplin Liberator Explorer using FlexLayout](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.20/images/LiberatorExplorerV3_3.PNG)
 
@@ -22,23 +22,21 @@ Features:
 *	splitters
 *	tabs
 *	tab dragging and ordering
-*	tabset dragging (move all the tabs in a tabset in one operation)
-*	dock to tabset or edge of frame
-*	maximize tabset (double click tabset header or use icon)
+*	tab set dragging (move all the tabs in a tab set in one operation)
+*	dock to tab set or edge of frame
+*	maximize tab set (double click tab set header or use icon)
 *	tab overflow (show menu when tabs overflow, scroll tabs using mouse wheel)
-*   border tabsets
+*   border tab sets
 *   popout tabs into new browser windows
 *	submodels, allow layouts inside layouts
 *	tab renaming (double click tab text to rename)
-*	theming - light, underline, gray and dark
-*	touch events - works on mobile devices (iPad, Android)
-*   add tabs using drag, indirect drag, add to active tabset, add to tabset by id
-*   preferred pixel size tabsets (try to keep their size when window resizes)
-*   headed tabsets
-*	tab and tabset attributes: enableHeader, enableTabStrip, enableDock, enableDrop...
-*	customizable tabs and tabset header rendering
+*	theming - light, underline, gray, round and dark
+*	works on mobile devices (iPad, Android)
+*   add tabs using drag, add to active tab set, add to tab set by id
+*	tab and tab set attributes: enableTabStrip, enableDock, enableDrop...
+*	customizable tabs and tab set rendering
 *   component state is preserved when tabs are moved
-*	typescript type declarations included
+*	typescript type declarations
 
 ## Installation
 
@@ -70,7 +68,7 @@ or by adding the css to your html:
 
 ## Usage
 
-The `<Layout>` component renders the tabsets and splitters, it takes the following props:
+The `<Layout>` component renders the tab sets and splitters, it takes the following props:
 
 
 #### Required props:
@@ -81,7 +79,7 @@ The `<Layout>` component renders the tabsets and splitters, it takes the followi
 | model           | the layout model  |
 | factory         | a factory function for creating React components |
 
-Additional [optional props](#optional-props)
+Additional [optional props](#optional-layout-props)
 
 The model is tree of Node objects that define the structure of the layout.
 
@@ -149,62 +147,46 @@ function App() {
 }
 ```		
 
-The above code would render two tabsets horizontally each containing a single tab that hosts a button component. The tabs could be moved and resized by dragging and dropping. Additional grids could be added to the layout by sending actions to the model.
+The above code would render two tab sets horizontally each containing a single tab that hosts a button component. The tabs could be moved and resized by dragging and dropping. Additional grids could be added to the layout by sending actions to the model.
 
-Try it now using [JSFiddle](https://jsfiddle.net/10kmLzvu/) 
+Try it now using [JSFiddle](https://jsfiddle.net/fvd9btea/)
 
 A simple Typescript example can be found here:
 
 https://github.com/nealus/FlexLayout_cra_example
 
-The model is built up using 4 types of 'node':
+The model json contains 4 top level elements:
+
+* global - (optional) where global options are defined
+* layout - where the main row/tabset/tabs layout hierarchy is defined
+* borders - (optional) where up to 4 borders are defined ("top", "bottom", "left", "right").
+* popouts - (optional) where the popout windows are defined
+
+The layout element is built up using 3 types of 'node':
 
 * row - rows contains a list of tabsets and child rows, the top level 'row' will render horizontally (unless the global attribute rootOrientationVertical is set)
-, child 'rows' will render in the opposite orientation to their parent.
+, child 'rows' will render in the opposite orientation to their parent row.
 
 * tabset - tabsets contain a list of tabs and the index of the selected tab
 
 * tab - tabs specify the name of the component that they should host (that will be loaded via the factory) and the text of the actual tab.
 
+The layout structure is defined with rows within rows that contain tabsets that themselves contain tabs.
+
+The optional borders element is made up of border nodes
+
 * border - borders contain a list of tabs and the index of the selected tab, they can only be used in the borders
 top level element.
 
-The main layout is defined with rows within rows that contain tabsets that themselves contain tabs.
-
-The model json contains 3 top level elements:
+The tree structure for the JSON model is well defined as Typescript interfaces, see  [JSON Model](#json-model-definition)
 
-* global - where global options are defined
-* layout - where the main row/tabset/tabs layout hierarchy is defined
-* borders - (optional) where up to 4 borders are defined ("top", "bottom", "left", "right"). 
+Each type of node has a defined set of requires/optional attributes.
 
 Weights on rows and tabsets specify the relative weight of these nodes within the parent row, the actual values do not matter just their relative values (ie two tabsets of weights 30,70 would render the same if they had weights of 3,7).
 
-NOTE: the easiest way to create your initial layout JSON is to use the [demo](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.7/demo/index.html) app, modify one of the 
+NOTE: the easiest way to create your initial layout JSON is to use the [demo](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.8/demo/index.html) app, modify one of the
 existing layouts by dragging/dropping and adding nodes then press the 'Show Layout JSON in console' button to print the JSON to the browser developer console.
 
-To control where nodes can be dropped you can add a callback function to the model:
-
-```
-model.setOnAllowDrop(this.allowDrop);
-```
-
-example:
-```javascript
-    allowDrop(dragNode, dropInfo) {
-        let dropNode = dropInfo.node;
-
-        // prevent non-border tabs dropping into borders
-        if (dropNode.getType() == "border" && (dragNode.getParent() == null || dragNode.getParent().getType() != "border"))
-            return false;
-
-        // prevent border tabs dropping into main layout
-        if (dropNode.getType() != "border" && (dragNode.getParent() != null && dragNode.getParent().getType() == "border"))
-            return false;
-
-        return true;
-    }
-```
-
 By changing global or node attributes you can change the layout appearance and functionality, for example:
 
 Setting tabSetEnableTabStrip:false in the global options would change the layout into a multi-splitter (without
@@ -213,255 +195,28 @@ tabs or drag and drop).
 ```
  global: {tabSetEnableTabStrip:false},
 ```
-## Floating Tabs (Popouts)
-
-Tabs can be rendered into external browser windows (for use in multi-monitor setups)
-by configuring them with the enableFloat attribute. When this attribute is present
-an additional icon is shown in the tab header bar allowing the tab to be popped out
-into an external window.
-
-For popouts to work there needs to be an additional html page 'popout.html' hosted
-at the same location as the main page (copy the one from examples/demo). The popout.html is the host page for the
-popped out tab, the styles from the main page will be copied into it at runtime.
-
-Because popouts are rendering into a different document to the main layout any code in the popped out
-tab that uses the global document or window objects will not work correctly (for example custom popup menus), 
-they need to instead use the document/window of the popout. To get the document/window of the popout use the
-following method on one of the elements rendered in the popout (for example a ref or target in an event handler):
-
-```
-    const currentDocument = this.selfRef.current.ownerDocument;
-    const currentWindow = currentDocument.defaultView!;
-```
-
-In the above code selfRef is a React ref to the toplevel element in the tab being rendered.
-
-Note: some libraries support popout windows by allowing you to specify the document to use, 
-for example see the getDocument() callback in agGrid at https://www.ag-grid.com/javascript-grid-callbacks/
-
-## Optional Props
-
-
-| Prop            | Description       |
-| --------------- | ----------------- |
-| font            | the tab font (overrides value in css). Example: font={{size:"12px", style:"italic"}}|
-| icons           | object mapping keys among `close`, `maximize`, `restore`, `more`, `popout` to React nodes to use in place of the default icons, can alternatively return functions for creating the React nodes |
-| onAction        | function called whenever the layout generates an action to update the model (allows for intercepting actions before they are dispatched to the model, for example, asking the user to confirm a tab close.) Returning `undefined` from the function will halt the action, otherwise return the action to continue |
-| onRenderTab     | function called when rendering a tab, allows leading (icon), content section, buttons and name used in overflow menu to be customized |
-| onRenderTabSet  | function called when rendering a tabset, allows header and buttons to be customized |
-| onModelChange   | function called when model has changed |
-| onExternalDrag  | function called when an external object (not a tab) gets dragged onto the layout, with a single `dragenter` argument. Should return either `undefined` to reject the drag/drop or an object with keys `dragText`, `json`Drop`, to create a tab via drag (similar to a call to `addTabToTabSet`). Function `onDrop` is passed the added tab `Node` and the `drop` `DragEvent`, unless the drag was canceled. |
-| classNameMapper | function called with default css class name, return value is class name that will be used. Mainly for use with css modules.|
-| i18nMapper      | function called for each I18nLabel to allow user translation, currently used for tab and tabset move messages, return undefined to use default values |
-| supportsPopout  | if left undefined will do simple check based on userAgent |
-| popoutURL       | URL of popout window relative to origin, defaults to popout.html |
-| realtimeResize  | boolean value, defaults to false, resize tabs as splitters are dragged. Warning: this can cause resizing to become choppy when tabs are slow to draw |
-| onTabDrag       | function called while dragging a tab, whether from the layout or using `addTabWithDragAndDrop`. Called with the `TabNode` being dragged / the tab json from `addTabWithDragAndDrop`, the `TabNode` being dragged over, the x and y coordinates relative to the dragged-over tab, and the `DockLocation` that would be used. Should return undefined for default behavior, or an object containing `x`, `y`, `width`, `height`, `callback`, `cursor` fields. Coordinates are in pixels relative to the dragged-over tab, and `callback` will be called with the same arguments if the tab is dropped. `cursor` is an optional string field that should contain a CSS cursor value, such as `copy` or `row-resize`. If `callback` is called, the layout does not perform its default behavior on drop. |
-| onRenderDragRect | callback for rendering the drag rectangles |
-| onRenderFloatingTabPlaceholder | callback for rendering the floating tab placeholder |
-| onContextMenu    | callback for handling context actions on tabs and tabsets |
-| onAuxMouseClick  | callback for handling mouse clicks on tabs and tabsets with alt, meta, shift keys, also handles center mouse clicks |
-| onShowOverflowMenu | callback for handling the display of the tab overflow menu |
-| onTabSetPlaceHolder | callback for rendering a placeholder when a tabset is empty |
-| iconFactory      | a factory function for creating icon components for tab bar buttons. <br/><br/> NOTE: for greater customization of the tab use onRenderTab instead of this callback |
-| titleFactory     | a factory function for creating title components for tab bar buttons. <br /><br /> NOTE: for greater customization of the tab use onRenderTab instead of this callback  |
-
-
-## Global Config attributes
-
-Attributes allowed in the 'global' element
-
-
-| Attribute                     | Default | Description                                                                                                  |
-|-------------------------------|:-------:|--------------------------------------------------------------------------------------------------------------|
-| splitterSize                  |    8    | width in pixels of all splitters between tabsets/borders                                                     |
-| splitterExtra                 |    0    | additional width in pixels of the splitter hit test area                                                     |
-| legacyOverflowMenu            |  false  | use the legacy text only overflow menu                                                                       |
-| enableEdgeDock                |  true   |                                                                                                              |
-| enableRotateBorderIcons       |  true   | boolean indicating if tab icons should rotate with the text in the left and right borders                    |
-| tabEnableClose                |  true   | allow user to close all tabs via close button                                                                |
-| tabCloseType                  |    1    | see values in ICloseType                                                                                     |
-| tabEnableDrag                 |  true   | allow user to drag all tabs to new location                                                                  |
-| tabEnableRename               |  true   | allow user to rename all tabs by double clicking                                                             |
-| tabEnableFloat                |  false  | enable popouts in all tabs (in popout capable browser)                                                       |
-| tabClassName                  |  null   |                                                                                                              |
-| tabContentClassName           |  null   |                                                                                                              |
-| tabIcon                       |  null   |                                                                                                              |
-| tabEnableRenderOnDemand       |  true   | whether to avoid rendering component until tab is visible                                                    |
-| tabDragSpeed                  |   0.3   | CSS transition speed of drag outlines (in seconds)                                                           |
-| tabBorderWidth                |   -1    | width when added to border, -1 will use border size                                                          |
-| tabBorderHeight               |   -1    | height when added to border, -1 will use border size                                                         |
-| tabSetEnableDeleteWhenEmpty   |  true   |                                                                                                              |
-| tabSetEnableDrop              |  true   | allow user to drag tabs into all tabsets                                                                     |
-| tabSetEnableDrag              |  true   | allow user to drag tabs out of all tabsets                                                                   |
-| tabSetEnableDivide            |  true   | allow user to drag tabs to region of all tabsets, splitting into new tabset                                  |
-| tabSetEnableMaximize          |  true   | allow user to maximize all tabsets to fill view via maximize button                                          |
-| tabSetEnableClose             |  false  | allow user to close all tabsets via close button                                                             |
-| tabSetAutoSelectTab           |  true   | whether to select new/moved tabs in all tabsets                                                              |
-| tabSetClassNameTabStrip       |  null   | height in pixels of tab strips in all tabsets                                                                |
-| tabSetEnableSingleTabStretch  |  false  | if a tabset has only a single tab then stretch the single tab to fill area and display in a header style     |
-| tabSetClassNameHeader         |  null   |                                                                                                              |
-| tabSetEnableTabStrip          |  true   | enable tab strip and allow multiple tabs in all tabsets                                                      |
-| tabSetHeaderHeight            |    0    | height of tabset header in pixels; if left as 0 then the value will be calculated from the current fontSize  |
-| tabSetTabStripHeight          |    0    | height of tabset tab bar in pixels; if left as 0 then the value will be calculated from the current fontSize |
-| borderBarSize                 |    0    | size of the border bars in pixels; if left as 0 then the value will be calculated from the current fontSize  |
-| borderEnableAutoHide          |  false  | hide border if it has zero tabs                                                                              |
-| borderEnableDrop              |  true   | allow user to drag tabs into this border                                                                     |
-| borderAutoSelectTabWhenOpen   |  true   | whether to select new/moved tabs in border when the border is already open                                   |
-| borderAutoSelectTabWhenClosed |  false  | whether to select new/moved tabs in border when the border is curently closed                                |
-| borderClassName               |  null   |                                                                                                              |
-| borderSize                    |   200   | initial width in pixels for left/right borders, height for top/bottom borders                                |
-| borderMinSize                 |    0    | minimum width in pixels for left/right borders, height for top/bottom borders                                |
-| tabSetMinHeight               |    0    | minimum width (in px) for all tabsets                                                                        |
-| tabSetMinWidth                |    0    | minimum height (in px) for all tabsets                                                                       |
-| tabSetTabLocation             |   top   | show tabs in location top or bottom                                                                          |
-| rootOrientationVertical       |  false  | the top level 'row' will layout horizontally by default, set this option true to make it layout vertically   |
-
-
-## Row Attributes
-
-Attributes allowed in nodes of type 'row'.
-
-| Attribute | Default | Description  |
-| ------------- |:-------------:| -----|
-| type | row | |
-| weight | 100 | |
-| width | null | preferred pixel width |
-| height | null | preferred pixel height |
-| children | *required* | a list of row and tabset nodes |
-
-## Tab Attributes
-
-Attributes allowed in nodes of type 'tab'.
 
-Inherited defaults will take their value from the associated global attributes (see above).
+## Model Actions
 
+Once the model json has been loaded all changes to the model are applied through actions.
 
-| Attribute | Default | Description  |
-| ------------- |:-------------:| -----|
-| type | tab | |
-| name | *required* | name of tab to be displayed in the tab button |
-| altName | *optional* | if there is no name specifed then this value will be used in the overflow menu |
-| component | *required* | string identifying which component to run (for factory) |
-| config | null | a place to hold json config for the hosted component |
-| id | auto generated | |
-| helpText | *optional* | An optional help text for the tab to be displayed upon tab hover. |
-| enableClose | *inherited* | allow user to close tab via close button |
-| closeType | *inherited* | see values in ICloseType |
-| enableDrag | *inherited* | allow user to drag tab to new location |
-| enableRename | *inherited* | allow user to rename tabs by double clicking |
-| enableFloat | *inherited* | enable popout (in popout capable browser) |
-| floating | false | |
-| className | *inherited* | class applied to tab button |
-| contentClassName | *inherited* | class applied to tab content |
-| tabsetClassName | undefined | class applied to parent tabset when this is the only tab and it is stretched to fill the tabset |
-| icon | *inherited* | |
-| enableRenderOnDemand | *inherited* | whether to avoid rendering component until tab is visible |
-| borderWidth | *inherited* | width when added to border, -1 will use border size |
-| borderHeight | *inherited* | height when added to border, -1 will use border size |
-
-Tab nodes have a getExtraData() method that initially returns an empty object, this is the place to 
-add extra data to a tab node that will not be saved.
-
-
-## TabSet Attributes
-
-Attributes allowed in nodes of type 'tabset'.
-
-Inherited defaults will take their value from the associated global attributes (see above).
-
-Note: tabsets can be dynamically created as tabs are moved and deleted when all their tabs are removed (unless enableDeleteWhenEmpty is false).
-
-| Attribute               | Default | Description                                                                                                                                                                            |
-|-------------------------|:-------------:|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| type                    | tabset |                                                                                                                                                                                        |
-| weight                  | 100 | relative weight for sizing of this tabset in parent row                                                                                                                                |
-| width                   | null | preferred pixel width                                                                                                                                                                  |
-| height                  | null | preferred pixel height                                                                                                                                                                 |
-| name                    | null | named tabsets will show a header bar above the tabs                                                                                                                                    |
-| config                  | null | a place to hold json config used in your own code                                                                                                                                      |
-| selected                | 0 | index of selected/visible tab in tabset                                                                                                                                                |
-| active                  | false | whether tabset is currently active; this attribute can only be used in the initial configuration, to change the active tabset you should use the `setActiveTabset` action on the model |
-| maximized               | false | whether tabset is currently maximized to fill view                                                                                                                                     |
-| enableClose             | false | allow user to close tabset via a close button                                                                                                                                          |
-| id                      | auto generated |                                                                                                                                                                                        |
-| children                | *required* | a list of tab nodes                                                                                                                                                                    |
-| enableDeleteWhenEmpty   | *inherited* |                                                                                                                                                                                        |
-| enableDrop              | *inherited* | allow user to drag tabs into this tabset                                                                                                                                               |
-| enableDrag              | *inherited* | allow user to drag tabs out this tabset                                                                                                                                                |
-| enableDivide            | *inherited* | allow user to drag tabs to region of this tabset, splitting into new tabset                                                                                                            |
-| enableMaximize          | *inherited* | allow user to maximize tabset to fill view via maximize button                                                                                                                         |
-| enableSingleTabStretch |  *inherited* | if the tabset has only a single tab then stretch the single tab to fill area and display in a header style                                                                             |
-| autoSelectTab           | *inherited* | whether to select new/moved tabs in tabset                                                                                                                                             |
-| classNameTabStrip       | *inherited* |                                                                                                                                                                                        |
-| classNameHeader         | *inherited* |                                                                                                                                                                                        |
-| enableTabStrip          | *inherited* | enable tab strip and allow multiple tabs in this tabset                                                                                                                                |
-| headerHeight            | *inherited* |                                                                                                                                                                                        |
-| tabStripHeight          | *inherited* | height in pixels of tab strip                                                                                                                                                          |
-| tabLocation             | *inherited* | show tabs in location top or bottom                                                                                                                                                    |
-| minHeight               | *inherited* | minimum height (in px) for this tabset                                                                                                                                                 |
-| minWidth                | *inherited* | minimum width (in px) for this tabset                                                                                                                                                  |
-
-## Border Attributes
-
-Attributes allowed in nodes of type 'border'.
-
-Inherited defaults will take their value from the associated global attributes (see above).
-
-
-| Attribute | Default | Description  |
-| ------------- |:-------------:| -----|
-| type | border | |
-| size | *inherited* | size of the tab body when selected |
-| minSize | *inherited* |  |
-| selected | -1 | index of selected/visible tab in border; -1 means no tab unselected / border closed |
-| id | auto generated | border_ + border name e.g. border_left |
-| config | null | a place to hold json config used in your own code |
-| show | true | show/hide this border |
-| enableAutoHide | false | hide border if it has zero tabs |
-| children | *required* | a list of tab nodes |
-| barSize | *inherited* | size of this border's bar in pixels; if left as 0 then the value will be calculated from the current fontSize |
-| enableDrop | *inherited* | |
-| autoSelectTabWhenOpen | *inherited* | whether to select new/moved tabs in border when the border is already open |
-| autoSelectTabWhenClosed | *inherited* | whether to select new/moved tabs in border when the border is currently closed |
-| className | *inherited* | class applied to tab button |
 
-## Model Actions
+You apply actions using the `Model.doAction()` method.
 
-All changes to the model are applied through actions.
-You can intercept actions resulting from GUI changes before they are applied by
-implementing the `onAction` callback property of the `Layout`.
-You can also apply actions directly using the `Model.doAction()` method.
-This method takes a single argument, created by one of the following action
+This method takes a single argument, created by one of the action
 generators (typically accessed as `FlexLayout.Actions.<actionName>`):
 
-| Action Creator | Description  |
-| ------------- | -----|
-|	Actions.addNode(newNodeJson, toNodeId, location, index, select?) | add a new tab node to the given tabset node; `select` specifies whether to select new tab, defaulting to `autoSelectTab` attribute; returns the created `Node` |
-|	Actions.moveNode(fromNodeId, toNodeId, location, index, select?) | move a tab node from its current location to the new node and location; `select` specifies whether to select tab, defaulting to new tabset's `autoSelectTab` attribute |
-|	Actions.deleteTab(tabNodeId) | delete the given tab |
-|	Actions.renameTab(tabNodeId, newName) | rename the given tab |
-|	Actions.selectTab(tabNodeId) | select the given tab |
-|	Actions.setActiveTabset(tabsetNodeId) | set the tabset as the active tabset |
-|	Actions.adjustSplit(splitterNodeId, value) | adjust the size of the given splitter |
-|	Actions.adjustBorderSplit(borderNodeId, pos) | updates the size of the given border node |
-|	Actions.maximizeToggle(tabsetNodeId) | toggles whether the given tabset node is maximized |
-|	Actions.updateModelAttributes(attributes) | updates the global attributes |
-|	Actions.updateNodeAttributes(nodeId, attributes) | updates the attributes of the given node |
-|	Actions.floatTab(nodeId) | popout the tab into a floating browser window |
-|	Actions.unFloatTab(nodeId) | restore a popped out tab to the main layout |
+[Actions doc](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.8/typedoc/classes/Actions.html)
 
 ### Examples
 
 ```js
 model.doAction(FlexLayout.Actions.updateModelAttributes({
-    splitterSize:40,
-    tabSetHeaderHeight:40,
-    tabSetTabStripHeight:40
+    splitterSize:40
 }));
 ```
 
-The above example would increase the size of the splitters, tabset headers and tabs, this could be used to make
+The above example would increase the size of the splitters, this could be used to make
 adjusting the layout easier on a small device.
 
 ```js
@@ -471,97 +226,169 @@ model.doAction(FlexLayout.Actions.addNode(
 ```
 
 This example adds a new grid component to the center of tabset with id "1" and at the 0'th tab position (use value -1 to add to the end of the tabs).
+
 Note: you can get the id of a node (e.g., the node returned by the `addNode`
 action) using the method `node.getId()`.
 If an id wasn't assigned when the node was created, then one will be created for you of the form `#<uuid>` (e.g. `#0c459064-8dee-444e-8636-eb9ab910fb27`).
 
+Note: You can intercept actions resulting from GUI changes before they are applied by
+implementing the `onAction` callback property of the `Layout`.
+
+## Optional Layout Props
+
+There are many optional properties that can be applied to the layout:
+
+[Layout Properties doc](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.8/typedoc/interfaces/ILayoutProps.html)
+
+
+## JSON Model Definition
+
+The JSON model is well defined as a set of TypeScript interfaces, see the doc for details of all the attributes allowed:
+
+## Model Config Attributes
+
+[Model Attributes doc](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.8/typedoc/interfaces/IJsonModel.html)
+
+## Global Config Attributes
+
+[Global Attributes doc](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.8/typedoc/interfaces/IGlobalAttributes.html)
+
+## Row Config Attributes
+
+[Row Attributes doc](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.8/typedoc/interfaces/IJsonRowNode.html)
+
+## Tab Set Config Attributes
+
+[Tab set Attributes doc](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.8/typedoc/interfaces/IJsonTabSetNode.html)
+
+Note: tab sets will be dynamically created as tabs are moved, and deleted when all their tabs are removed (unless enableDeleteWhenEmpty is false).
+
+## Tab Config attributes
+
+[Tab Attributes doc](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.8/typedoc/interfaces/IJsonTabNode.html)
+
+## Border Config attributes
+
+[Border Attributes doc](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.8/typedoc/interfaces/IJsonBorderNode.html)
+
+
+
+
 
 ## Layout Component Methods to Create New Tabs
 
-Methods on the Layout Component for adding tabs, the tabs are specified by their layout json.
+There are methods on the Layout Component for adding tabs:
+
+[Layout Methods doc](https://rawgit.com/caplin/FlexLayout/demos/demos/v0.8/typedoc/classes/Layout.html)
 
 Example:
 
 ```
-this.layoutRef.current.addTabToTabSet("NAVIGATION", {type:"tab", component:"grid", name:"a grid"});
+layoutRef.current.addTabToTabSet("NAVIGATION", {type:"tab", component:"grid", name:"a grid"});
 ```
-This would add a new grid component to the tabset with id "NAVIGATION" (where this.layoutRef is a ref to the Layout element, see https://reactjs.org/docs/refs-and-the-dom.html ).
+This would add a new grid component to the tab set with id "NAVIGATION" (where layoutRef is a ref to the Layout element, see https://reactjs.org/docs/refs-and-the-dom.html ).
 
 
-| Layout Method | Description  |
-| ------------- | -----|
-| addTabToTabSet(tabsetId, json) | adds a new tab to the tabset with the given Id |
-| addTabToActiveTabSet(json) | adds a new tab to the active tabset |
-| addTabWithDragAndDrop(dragText, json, onDrop) | adds a new tab by dragging a marker to the required location, with the drag starting immediately; on success, `onDrop` is passed the created tab `Node`; on cancel, no arguments are passed |
-| addTabWithDragAndDropIndirect(dragText, json, onDrop) | adds a new tab by dragging a marker to the required location, the marker is shown and must be clicked on to start dragging |
-| moveTabWithDragAndDrop( node, dragText) | Move a tab/tabset using drag and drop triggered from a custom event |
 
 ## Tab Node Events
 
-You can handle events on nodes by adding a listener, this would typically be done 
-in the components constructor() method.
+You can handle events on nodes by adding a listener, this would typically be done
+when the component is mounted in a useEffect method:
 
 Example:
 ```
-    constructor(props) {
-        super(props);
-        let config = this.props.node.getConfig();
-
-        // save state in flexlayout node tree
-        this.props.node.setEventListener("save", (p) => {
-             config.subject = this.subject;
-        };
+    function MyComponent({node}) {
+
+      useEffect(() => {
+        // save subject in flexlayout node tree
+        node.setEventListener("save", () => {
+             node.getConfig().subject = subject;
+           };
+        }, []);
     }
 
 ```
 
 | Event        | parameters          | Description  |
 | ------------- |:-------------:| -----|
-| resize |      |  called when tab is resized during layout, called before it is rendered with the new size|
-| close |      |  called when a tab is closed |
-| visibility |      | called when the visibility of a tab changes |
-| save |      | called before a tabnode is serialized to json, use to save node config by adding data to the object returned by node.getConfig()|
+| resize |  {rect}    |  called when tab is resized during layout, called before it is rendered with the new size|
+| close |   none   |  called when a tab is closed |
+| visibility |  {visible}    | called when the visibility of a tab changes |
+| save |   none   | called before a tabnode is serialized to json, use to save node config by adding data to the object returned by node.getConfig()|
 
+## Popout Windows
+
+Tabs can be rendered into external browser windows (for use in multi-monitor setups)
+by configuring them with the enablePopout attribute. When this attribute is present
+an additional icon is shown in the tab header bar allowing the tab to be popped out
+into an external window.
+
+For popouts to work there needs to be an additional html page 'popout.html' hosted
+at the same location as the main page (copy the one from examples/demo). The popout.html is the host page for the
+popped out tab, the styles from the main page will be copied into it at runtime.
+
+Because popouts are rendering into a different document to the main layout any code in the popped out
+tab that uses the global document or window objects for event listeners will not work correctly (for example custom popup menus where the code uses document.addEventListener(...)),
+they need to instead use the document/window of the popout. To get the document/window of the popout use the
+following method on one of the elements rendered in the popout (for example a ref or target in an event handler):
+
+```
+    const currentDocument = selfRef.current.ownerDocument;
+    const currentWindow = currentDocument.defaultView!;
+```
+
+In the above code selfRef is a React ref to the toplevel element in the tab being rendered.
+
+Note: libraries may support popout windows by allowing you to specify the document to use,
+for example see the getDocument() callback in agGrid at https://www.ag-grid.com/javascript-grid-callbacks/
+
+### Limitations of Popouts
+* FlexLayout uses React Portals to draw the popout window content,
+    this means all the code runs in the main Window's JS context, so effectively the popout windows are just extensions of the area on which the main window can render panels.
+
+* Your code must use the popout window/document in popout windows when adding event listeners (e.g popoutDocument.addEventListener(...)).
+
+* Timers throttle when main window is in the background
+    you could implement a webworker timer replacement if needed (which will not throttle)
+* Many third party controls will use the global document for some event listeners,
+    these will not work correctly without modification
+* Some third party controls will suspend when the global document is hidden
+    you can use the tab overlay attribute to 'gray out' these tabs when the main window is hidden
+* Resize observers may be throttled (or stay attached to the main window), so you may need to use some other way to resize the component when in a popout (see aggrid component in demo).
+* Popouts will not size and position correctly when the browser is zoomed (ie set to 50% zoom)
+* Popouts cannot reload in maximized or minimized states
+* by default flexlayout will maintain react state when moving tabs between windows, but you can use the 
+enableWindowReMount tab attribute to force the component to re-mount.
+
+See this article about using React portals in this way: https://dev.to/noriste/the-challenges-of-rendering-an-openlayers-map-in-a-popup-through-react-2elh
 
 ## Running the Examples and Building the Project
 
 First install dependencies:
 
 ```
-yarn install
+pnpm install
 ```
 
 Compile the project and run the examples:
- 
+
 ```
-yarn start
+pnpm start
 ```
 
 Open your browser at http://localhost:8080/examples/ to show the examples directory, click on the examples to run them.
 
-The 'yarn start' command will watch for changes to flexlayout and example source, so you can make changes to the code
+The 'pnpm start' command will watch for changes to flexlayout and example source, so you can make changes to the code
 and then refresh the browser to see the result.
 
-To run the tests in the Cypress interactive runner use:
-
-```
-yarn cypress
-```
-
-![FlexLayout Cypress tests](/../screenshots/github_images/CypressTests.png?raw=true "Cypress interactive runner Screenshot")
-
-
-To build the npm distribution run 'yarn build', this will create the artifacts in the dist dir.
+To build the npm distribution run 'pnpm build', this will create the artifacts in the dist dir.
 
 ## Alternative Layout Managers
 
 | Name | Repository |
 | ------------- |:-------------|
-| rc-dock | https://github.com/ticlo/rc-dock | 
-| Dockview | https://dockview.dev/ | 
-| lumino | https://github.com/jupyterlab/lumino | 
+| rc-dock | https://github.com/ticlo/rc-dock |
+| Dockview | https://dockview.dev/ |
+| lumino | https://github.com/jupyterlab/lumino |
 | golden-layout | https://github.com/golden-layout/golden-layout |
 | react-mosaic | https://github.com/nomcopter/react-mosaic |
-
-
-

package/declarations/Attribute.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/declarations/AttributeDefinitions.d.ts

@@ -1 +1 @@
-export {};
+export {};