@genesislcap/foundation-layout 14.302.0 → 14.302.1-alpha-945e484.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (25) hide show
  1. package/dist/dts/main/layout-item.d.ts.map +1 -1
  2. package/dist/dts/main/layout-main.d.ts.map +1 -1
  3. package/dist/dts/utils/misc.d.ts.map +1 -1
  4. package/dist/foundation-layout.api.json +1 -1
  5. package/dist/foundation-layout.d.ts +519 -519
  6. package/dist/tsdoc-metadata.json +1 -1
  7. package/docs/api/foundation-layout.foundationlayout.additem.md +49 -4
  8. package/docs/api/foundation-layout.foundationlayout.layoutrequiredregistrations.md +33 -3
  9. package/docs/api/foundation-layout.foundationlayout.loadlayout.md +65 -5
  10. package/docs/api/foundation-layout.foundationlayout.md +357 -23
  11. package/docs/api/foundation-layout.foundationlayout.registeritem.md +49 -4
  12. package/docs/api/foundation-layout.foundationlayout.removeitems.md +49 -4
  13. package/docs/api/foundation-layout.foundationlayoutitem.md +98 -6
  14. package/docs/api/foundation-layout.foundationlayoutregion.md +60 -4
  15. package/docs/api/foundation-layout.layoutcomponentwithstate.applystate.md +31 -3
  16. package/docs/api/foundation-layout.layoutcomponentwithstate.md +34 -4
  17. package/docs/api/foundation-layout.layoutregistrationerror._constructor_.md +31 -3
  18. package/docs/api/foundation-layout.layoutregistrationerror.md +31 -3
  19. package/docs/api/foundation-layout.layoutusageerror._constructor_.md +31 -3
  20. package/docs/api/foundation-layout.layoutusageerror.md +31 -3
  21. package/docs/api/foundation-layout.md +274 -28
  22. package/docs/api/foundation-layout.registeredelementconfig.md +115 -7
  23. package/docs/api/index.md +21 -3
  24. package/docs/api-report.md.api.md +235 -0
  25. package/package.json +13 -13
@@ -6,41 +6,287 @@
6
6
 
7
7
  ## Classes
8
8
 
9
- | Class | Description |
10
- | --- | --- |
11
- | [FoundationLayout](./foundation-layout.foundationlayout.md) | Top level web component which is used to initialise a custom layout |
12
- | [FoundationLayoutItem](./foundation-layout.foundationlayoutitem.md) | <code>FoundationLayoutItem</code> is a custom element that represents an item in the layout. |
13
- | [FoundationLayoutRegion](./foundation-layout.foundationlayoutregion.md) | <code>FoundationLayoutRegion</code> is a custom element that represents a region in the layout. |
14
- | [LayoutRegistrationError](./foundation-layout.layoutregistrationerror.md) | |
15
- | [LayoutUsageError](./foundation-layout.layoutusageerror.md) | |
9
+ <table><thead><tr><th>
10
+
11
+ Class
12
+
13
+
14
+ </th><th>
15
+
16
+ Description
17
+
18
+
19
+ </th></tr></thead>
20
+ <tbody><tr><td>
21
+
22
+ [FoundationLayout](./foundation-layout.foundationlayout.md)
23
+
24
+
25
+ </td><td>
26
+
27
+ Top level web component which is used to initialise a custom layout
28
+
29
+
30
+ </td></tr>
31
+ <tr><td>
32
+
33
+ [FoundationLayoutItem](./foundation-layout.foundationlayoutitem.md)
34
+
35
+
36
+ </td><td>
37
+
38
+ `FoundationLayoutItem` is a custom element that represents an item in the layout.
39
+
40
+
41
+ </td></tr>
42
+ <tr><td>
43
+
44
+ [FoundationLayoutRegion](./foundation-layout.foundationlayoutregion.md)
45
+
46
+
47
+ </td><td>
48
+
49
+ `FoundationLayoutRegion` is a custom element that represents a region in the layout.
50
+
51
+
52
+ </td></tr>
53
+ <tr><td>
54
+
55
+ [LayoutRegistrationError](./foundation-layout.layoutregistrationerror.md)
56
+
57
+
58
+ </td><td>
59
+
60
+
61
+
62
+ </td></tr>
63
+ <tr><td>
64
+
65
+ [LayoutUsageError](./foundation-layout.layoutusageerror.md)
66
+
67
+
68
+ </td><td>
69
+
70
+
71
+
72
+ </td></tr>
73
+ </tbody></table>
16
74
 
17
75
  ## Interfaces
18
76
 
19
- | Interface | Description |
20
- | --- | --- |
21
- | [LayoutComponentWithState](./foundation-layout.layoutcomponentwithstate.md) | Interface to implement on an item which is a component of the layout and you wish to serialise state with. This is saved separately for each instance of the component, which allows you to restore multiple instances of the same component with different state. |
22
- | [RegisteredElementConfig](./foundation-layout.registeredelementconfig.md) | The parameters that can be set on a new item when being added by the [FoundationLayout.addItem()](./foundation-layout.foundationlayout.additem.md) API |
77
+ <table><thead><tr><th>
78
+
79
+ Interface
80
+
81
+
82
+ </th><th>
83
+
84
+ Description
85
+
86
+
87
+ </th></tr></thead>
88
+ <tbody><tr><td>
89
+
90
+ [LayoutComponentWithState](./foundation-layout.layoutcomponentwithstate.md)
91
+
92
+
93
+ </td><td>
94
+
95
+ Interface to implement on an item which is a component of the layout and you wish to serialise state with. This is saved separately for each instance of the component, which allows you to restore multiple instances of the same component with different state.
96
+
97
+
98
+ </td></tr>
99
+ <tr><td>
100
+
101
+ [RegisteredElementConfig](./foundation-layout.registeredelementconfig.md)
102
+
103
+
104
+ </td><td>
105
+
106
+ The parameters that can be set on a new item when being added by the [FoundationLayout.addItem()](./foundation-layout.foundationlayout.additem.md) API
107
+
108
+
109
+ </td></tr>
110
+ </tbody></table>
23
111
 
24
112
  ## Variables
25
113
 
26
- | Variable | Description |
27
- | --- | --- |
28
- | [DEFAULT\_RELOAD\_BUFFER](./foundation-layout.default_reload_buffer.md) | <p>Default time in milliseconds for the layout to buffer calls to reloading the layout while the declarative API is loading.</p><p>During the first load of the layout, a loading spinner will be shown.</p> |
29
- | [foundationLayoutComponents](./foundation-layout.foundationlayoutcomponents.md) | Registration object to register the layout with your design system. |
30
- | [LAYOUT\_ICONS](./foundation-layout.layout_icons.md) | A collection of SVG icons in base64 format. |
31
- | [LAYOUT\_POPOUT\_CONTAINER\_CLASS](./foundation-layout.layout_popout_container_class.md) | **_(BETA)_** Put this classname on an element which is a DOM parent of the layout, and if the layout goes into popout mode then it will place itself as the only child for the popout container you set. |
32
- | [LayoutEmitEvents](./foundation-layout.layoutemitevents.md) | <p>Defines events that the layout system emits</p><p>'firstLoaded' - emitted when the layout has finished loading the first time using the declarative API after [DEFAULT\_RELOAD\_BUFFER](./foundation-layout.default_reload_buffer.md) ms. <br/> 'itemAdded' - emitted when an item is added to the layout' <br/> 'itemRemoved' - emitted when an item is removed from the layout' <br/> 'itemResized' - emitted when the user drags the divider to resize elements</p> |
33
- | [LayoutReceiveEvents](./foundation-layout.layoutreceiveevents.md) | <p>Defines events that the layout system listens for</p><p>'changeTitle' - emit this from a contained item to update the title of the window that contains it. 'autosave' - emit this from a contained item to hint to the layout system that it should autosave the layout. A contained item should do this if it has just changed some state it would like to persist. See [LayoutComponentWithState](./foundation-layout.layoutcomponentwithstate.md)<!-- -->.</p> |
34
- | [layoutStyles](./foundation-layout.layoutstyles.md) | <code>ElementStyles</code> which defines the css for [FoundationLayout](./foundation-layout.foundationlayout.md)<!-- -->. |
35
- | [layoutTemplate](./foundation-layout.layouttemplate.md) | <code>ViewTemplate</code> which defines the html for [FoundationLayout](./foundation-layout.foundationlayout.md)<!-- -->. |
114
+ <table><thead><tr><th>
115
+
116
+ Variable
117
+
118
+
119
+ </th><th>
120
+
121
+ Description
122
+
123
+
124
+ </th></tr></thead>
125
+ <tbody><tr><td>
126
+
127
+ [DEFAULT\_RELOAD\_BUFFER](./foundation-layout.default_reload_buffer.md)
128
+
129
+
130
+ </td><td>
131
+
132
+ Default time in milliseconds for the layout to buffer calls to reloading the layout while the declarative API is loading.
133
+
134
+ During the first load of the layout, a loading spinner will be shown.
135
+
136
+
137
+ </td></tr>
138
+ <tr><td>
139
+
140
+ [foundationLayoutComponents](./foundation-layout.foundationlayoutcomponents.md)
141
+
142
+
143
+ </td><td>
144
+
145
+ Registration object to register the layout with your design system.
146
+
147
+
148
+ </td></tr>
149
+ <tr><td>
150
+
151
+ [LAYOUT\_ICONS](./foundation-layout.layout_icons.md)
152
+
153
+
154
+ </td><td>
155
+
156
+ A collection of SVG icons in base64 format.
157
+
158
+
159
+ </td></tr>
160
+ <tr><td>
161
+
162
+ [LAYOUT\_POPOUT\_CONTAINER\_CLASS](./foundation-layout.layout_popout_container_class.md)
163
+
164
+
165
+ </td><td>
166
+
167
+ **_(BETA)_** Put this classname on an element which is a DOM parent of the layout, and if the layout goes into popout mode then it will place itself as the only child for the popout container you set.
168
+
169
+
170
+ </td></tr>
171
+ <tr><td>
172
+
173
+ [LayoutEmitEvents](./foundation-layout.layoutemitevents.md)
174
+
175
+
176
+ </td><td>
177
+
178
+ Defines events that the layout system emits
179
+
180
+ 'firstLoaded' - emitted when the layout has finished loading the first time using the declarative API after [DEFAULT\_RELOAD\_BUFFER](./foundation-layout.default_reload_buffer.md) ms. <br/> 'itemAdded' - emitted when an item is added to the layout' <br/> 'itemRemoved' - emitted when an item is removed from the layout' <br/> 'itemResized' - emitted when the user drags the divider to resize elements
181
+
182
+
183
+ </td></tr>
184
+ <tr><td>
185
+
186
+ [LayoutReceiveEvents](./foundation-layout.layoutreceiveevents.md)
187
+
188
+
189
+ </td><td>
190
+
191
+ Defines events that the layout system listens for
192
+
193
+ 'changeTitle' - emit this from a contained item to update the title of the window that contains it. 'autosave' - emit this from a contained item to hint to the layout system that it should autosave the layout. A contained item should do this if it has just changed some state it would like to persist. See [LayoutComponentWithState](./foundation-layout.layoutcomponentwithstate.md)<!-- -->.
194
+
195
+
196
+ </td></tr>
197
+ <tr><td>
198
+
199
+ [layoutStyles](./foundation-layout.layoutstyles.md)
200
+
201
+
202
+ </td><td>
203
+
204
+ `ElementStyles` which defines the css for [FoundationLayout](./foundation-layout.foundationlayout.md)<!-- -->.
205
+
206
+
207
+ </td></tr>
208
+ <tr><td>
209
+
210
+ [layoutTemplate](./foundation-layout.layouttemplate.md)
211
+
212
+
213
+ </td><td>
214
+
215
+ `ViewTemplate` which defines the html for [FoundationLayout](./foundation-layout.foundationlayout.md)<!-- -->.
216
+
217
+
218
+ </td></tr>
219
+ </tbody></table>
36
220
 
37
221
  ## Type Aliases
38
222
 
39
- | Type Alias | Description |
40
- | --- | --- |
41
- | [CustomButton](./foundation-layout.custombutton.md) | Definition of a custom button which will be added to all layout items. |
42
- | [LayoutReceiveEventsDetail](./foundation-layout.layoutreceiveeventsdetail.md) | <p>Defines the shape of the detail that the layout listens works with for events it listens on</p><p>'changeTitle' - <code>title</code> is the string you want to set. For <code>mode</code>: <code>replace</code> will set the title to be <code>title</code>, <code>suffix</code> will append <code>title</code> to the end of the existing title. 'autosave' - no other parameters.</p> |
43
- | [LayoutRegionType](./foundation-layout.layoutregiontype.md) | Union type describing the three different types of region splits. Set on the <code>type</code> attribute on [FoundationLayoutRegion](./foundation-layout.foundationlayoutregion.md)<!-- -->. |
44
- | [Placement](./foundation-layout.placement.md) | Where to and how to add the new item(s) into the layout when using the [FoundationLayout.addItem()](./foundation-layout.foundationlayout.additem.md) API. |
45
- | [SerialisedLayout](./foundation-layout.serialisedlayout.md) | Versioned layout config objects. <code>v</code> is the version and <code>c</code> contains the layout config. |
223
+ <table><thead><tr><th>
224
+
225
+ Type Alias
226
+
227
+
228
+ </th><th>
229
+
230
+ Description
231
+
232
+
233
+ </th></tr></thead>
234
+ <tbody><tr><td>
235
+
236
+ [CustomButton](./foundation-layout.custombutton.md)
237
+
238
+
239
+ </td><td>
240
+
241
+ Definition of a custom button which will be added to all layout items.
242
+
243
+
244
+ </td></tr>
245
+ <tr><td>
246
+
247
+ [LayoutReceiveEventsDetail](./foundation-layout.layoutreceiveeventsdetail.md)
248
+
249
+
250
+ </td><td>
251
+
252
+ Defines the shape of the detail that the layout listens works with for events it listens on
253
+
254
+ 'changeTitle' - `title` is the string you want to set. For `mode`<!-- -->: `replace` will set the title to be `title`<!-- -->, `suffix` will append `title` to the end of the existing title. 'autosave' - no other parameters.
255
+
256
+
257
+ </td></tr>
258
+ <tr><td>
259
+
260
+ [LayoutRegionType](./foundation-layout.layoutregiontype.md)
261
+
262
+
263
+ </td><td>
264
+
265
+ Union type describing the three different types of region splits. Set on the `type` attribute on [FoundationLayoutRegion](./foundation-layout.foundationlayoutregion.md)<!-- -->.
266
+
267
+
268
+ </td></tr>
269
+ <tr><td>
270
+
271
+ [Placement](./foundation-layout.placement.md)
272
+
273
+
274
+ </td><td>
275
+
276
+ Where to and how to add the new item(s) into the layout when using the [FoundationLayout.addItem()](./foundation-layout.foundationlayout.additem.md) API.
277
+
278
+
279
+ </td></tr>
280
+ <tr><td>
281
+
282
+ [SerialisedLayout](./foundation-layout.serialisedlayout.md)
283
+
284
+
285
+ </td><td>
286
+
287
+ Versioned layout config objects. `v` is the version and `c` contains the layout config.
288
+
289
+
290
+ </td></tr>
291
+ </tbody></table>
46
292
 
@@ -18,11 +18,119 @@ export interface RegisteredElementConfig
18
18
 
19
19
  ## Properties
20
20
 
21
- | Property | Modifiers | Type | Description |
22
- | --- | --- | --- | --- |
23
- | [closable?](./foundation-layout.registeredelementconfig.closable.md) | | boolean | _(Optional)_ |
24
- | [registration](./foundation-layout.registeredelementconfig.registration.md) | | string | |
25
- | [showMaximiseButton?](./foundation-layout.registeredelementconfig.showmaximisebutton.md) | | boolean | _(Optional)_ |
26
- | [size?](./foundation-layout.registeredelementconfig.size.md) | | string | _(Optional)_ |
27
- | [title?](./foundation-layout.registeredelementconfig.title.md) | | string | _(Optional)_ |
21
+ <table><thead><tr><th>
22
+
23
+ Property
24
+
25
+
26
+ </th><th>
27
+
28
+ Modifiers
29
+
30
+
31
+ </th><th>
32
+
33
+ Type
34
+
35
+
36
+ </th><th>
37
+
38
+ Description
39
+
40
+
41
+ </th></tr></thead>
42
+ <tbody><tr><td>
43
+
44
+ [closable?](./foundation-layout.registeredelementconfig.closable.md)
45
+
46
+
47
+ </td><td>
48
+
49
+
50
+ </td><td>
51
+
52
+ boolean
53
+
54
+
55
+ </td><td>
56
+
57
+ _(Optional)_
58
+
59
+
60
+ </td></tr>
61
+ <tr><td>
62
+
63
+ [registration](./foundation-layout.registeredelementconfig.registration.md)
64
+
65
+
66
+ </td><td>
67
+
68
+
69
+ </td><td>
70
+
71
+ string
72
+
73
+
74
+ </td><td>
75
+
76
+
77
+ </td></tr>
78
+ <tr><td>
79
+
80
+ [showMaximiseButton?](./foundation-layout.registeredelementconfig.showmaximisebutton.md)
81
+
82
+
83
+ </td><td>
84
+
85
+
86
+ </td><td>
87
+
88
+ boolean
89
+
90
+
91
+ </td><td>
92
+
93
+ _(Optional)_
94
+
95
+
96
+ </td></tr>
97
+ <tr><td>
98
+
99
+ [size?](./foundation-layout.registeredelementconfig.size.md)
100
+
101
+
102
+ </td><td>
103
+
104
+
105
+ </td><td>
106
+
107
+ string
108
+
109
+
110
+ </td><td>
111
+
112
+ _(Optional)_
113
+
114
+
115
+ </td></tr>
116
+ <tr><td>
117
+
118
+ [title?](./foundation-layout.registeredelementconfig.title.md)
119
+
120
+
121
+ </td><td>
122
+
123
+
124
+ </td><td>
125
+
126
+ string
127
+
128
+
129
+ </td><td>
130
+
131
+ _(Optional)_
132
+
133
+
134
+ </td></tr>
135
+ </tbody></table>
28
136
 
package/docs/api/index.md CHANGED
@@ -6,7 +6,25 @@
6
6
 
7
7
  ## Packages
8
8
 
9
- | Package | Description |
10
- | --- | --- |
11
- | [@genesislcap/foundation-layout](./foundation-layout.md) | |
9
+ <table><thead><tr><th>
10
+
11
+ Package
12
+
13
+
14
+ </th><th>
15
+
16
+ Description
17
+
18
+
19
+ </th></tr></thead>
20
+ <tbody><tr><td>
21
+
22
+ [@genesislcap/foundation-layout](./foundation-layout.md)
23
+
24
+
25
+ </td><td>
26
+
27
+
28
+ </td></tr>
29
+ </tbody></table>
12
30