@atlaskit/page-layout 1.3.1 → 1.3.2

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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # @atlaskit/page-layout
2
2
 
3
+ ## 1.3.2
4
+
5
+ ### Patch Changes
6
+
7
+ - [`522a27e6119`](https://bitbucket.org/atlassian/atlassian-frontend/commits/522a27e6119) - Remove `isOpen` prop from @atlaskit/banner, it is now open by default.
8
+ - Updated dependencies
9
+
3
10
  ## 1.3.1
4
11
 
5
12
  ### Patch Changes
@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", {
8
8
  Object.defineProperty(exports, "Banner", {
9
9
  enumerable: true,
10
10
  get: function get() {
11
- return _banner.default;
11
+ return _bannerSlot.default;
12
12
  }
13
13
  });
14
14
  Object.defineProperty(exports, "Content", {
@@ -92,7 +92,7 @@ var _leftSidebar = _interopRequireDefault(require("./slots/left-sidebar"));
92
92
 
93
93
  var _leftSidebarWithoutResize = _interopRequireDefault(require("./slots/left-sidebar-without-resize"));
94
94
 
95
- var _banner = _interopRequireDefault(require("./slots/banner"));
95
+ var _bannerSlot = _interopRequireDefault(require("./slots/banner-slot"));
96
96
 
97
97
  var _topNavigation = _interopRequireDefault(require("./slots/top-navigation"));
98
98
 
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "@atlaskit/page-layout",
3
- "version": "1.3.1",
3
+ "version": "1.3.2",
4
4
  "sideEffects": false
5
5
  }
@@ -5,7 +5,7 @@ export { default as LeftPanel } from './slots/left-panel';
5
5
  export { default as RightSidebar } from './slots/right-sidebar';
6
6
  export { default as LeftSidebar } from './slots/left-sidebar';
7
7
  export { default as LeftSidebarWithoutResize } from './slots/left-sidebar-without-resize';
8
- export { default as Banner } from './slots/banner';
8
+ export { default as Banner } from './slots/banner-slot';
9
9
  export { default as TopNavigation } from './slots/top-navigation';
10
10
  export { default as Content } from './slots/content';
11
11
  export { default as ResizeControl } from './resize-control';
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "@atlaskit/page-layout",
3
- "version": "1.3.1",
3
+ "version": "1.3.2",
4
4
  "sideEffects": false
5
5
  }
@@ -5,7 +5,7 @@ export { default as LeftPanel } from './slots/left-panel';
5
5
  export { default as RightSidebar } from './slots/right-sidebar';
6
6
  export { default as LeftSidebar } from './slots/left-sidebar';
7
7
  export { default as LeftSidebarWithoutResize } from './slots/left-sidebar-without-resize';
8
- export { default as Banner } from './slots/banner';
8
+ export { default as Banner } from './slots/banner-slot';
9
9
  export { default as TopNavigation } from './slots/top-navigation';
10
10
  export { default as Content } from './slots/content';
11
11
  export { default as ResizeControl } from './resize-control';
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "@atlaskit/page-layout",
3
- "version": "1.3.1",
3
+ "version": "1.3.2",
4
4
  "sideEffects": false
5
5
  }
@@ -5,7 +5,7 @@ export { default as LeftPanel } from './slots/left-panel';
5
5
  export { default as RightSidebar } from './slots/right-sidebar';
6
6
  export { default as LeftSidebar } from './slots/left-sidebar';
7
7
  export { default as LeftSidebarWithoutResize } from './slots/left-sidebar-without-resize';
8
- export { default as Banner } from './slots/banner';
8
+ export { default as Banner } from './slots/banner-slot';
9
9
  export { default as TopNavigation } from './slots/top-navigation';
10
10
  export { default as Content } from './slots/content';
11
11
  export { default as ResizeControl } from './resize-control';
@@ -5,7 +5,7 @@ export { default as LeftPanel } from './slots/left-panel';
5
5
  export { default as RightSidebar } from './slots/right-sidebar';
6
6
  export { default as LeftSidebar } from './slots/left-sidebar';
7
7
  export { default as LeftSidebarWithoutResize } from './slots/left-sidebar-without-resize';
8
- export { default as Banner } from './slots/banner';
8
+ export { default as Banner } from './slots/banner-slot';
9
9
  export { default as TopNavigation } from './slots/top-navigation';
10
10
  export { default as Content } from './slots/content';
11
11
  export { default as ResizeControl } from './resize-control';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atlaskit/page-layout",
3
- "version": "1.3.1",
3
+ "version": "1.3.2",
4
4
  "description": "A collection of components which let you compose an application's page layout.",
5
5
  "publishConfig": {
6
6
  "registry": "https://registry.npmjs.org/"
@@ -33,7 +33,7 @@
33
33
  "homepage": "https://atlassian.design/components/page-layout/",
34
34
  "dependencies": {
35
35
  "@atlaskit/ds-lib": "^2.1.0",
36
- "@atlaskit/icon": "^21.10.0",
36
+ "@atlaskit/icon": "^21.11.0",
37
37
  "@atlaskit/motion": "^1.2.0",
38
38
  "@atlaskit/theme": "^12.2.0",
39
39
  "@atlaskit/tokens": "^0.10.0",
@@ -51,16 +51,16 @@
51
51
  "@atlaskit/atlassian-notifications": "^0.3.0",
52
52
  "@atlaskit/button": "^16.3.0",
53
53
  "@atlaskit/docs": "*",
54
- "@atlaskit/drawer": "^7.2.0",
54
+ "@atlaskit/drawer": "^7.3.0",
55
55
  "@atlaskit/icon": "*",
56
- "@atlaskit/logo": "^13.9.0",
56
+ "@atlaskit/logo": "^13.10.0",
57
57
  "@atlaskit/menu": "^1.3.0",
58
58
  "@atlaskit/notification-indicator": "^9.0.0",
59
59
  "@atlaskit/notification-log-client": "^6.0.0",
60
- "@atlaskit/onboarding": "^10.5.0",
61
- "@atlaskit/popup": "^1.4.0",
62
- "@atlaskit/section-message": "^6.2.0",
63
- "@atlaskit/side-navigation": "^1.2.0",
60
+ "@atlaskit/onboarding": "^10.6.0",
61
+ "@atlaskit/popup": "^1.5.0",
62
+ "@atlaskit/section-message": "^6.3.0",
63
+ "@atlaskit/side-navigation": "^1.3.0",
64
64
  "@atlaskit/ssr": "*",
65
65
  "@atlaskit/tooltip": "*",
66
66
  "@atlaskit/visual-regression": "*",
package/report.api.md CHANGED
@@ -1,29 +1,48 @@
1
- ## API Report File for "@atlaskit/page-layout"
1
+ ## API Report File for "@atlaskit/page-layout".
2
2
 
3
- > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
3
+ > Do not edit this file. This report is auto-generated by [API Extractor](https://api-extractor.com/).
4
4
 
5
- ```ts
6
- /// <reference types="react" />
5
+ [Learn more about API reports](https://hello.atlassian.net/wiki/spaces/UR/pages/1825484529/Package+API+Reports)
7
6
 
7
+ ```ts
8
8
  import { ButtonHTMLAttributes } from 'react';
9
9
  import { ElementType } from 'react';
10
+ import { jsx } from '@emotion/react';
10
11
  import { KeyboardEvent as KeyboardEvent_2 } from 'react';
11
12
  import { MouseEvent as MouseEvent_2 } from 'react';
12
13
  import { ReactElement } from 'react';
13
14
  import { ReactNode } from 'react';
14
15
 
15
- export declare const Banner: (props: SlotHeightProps) => JSX.Element;
16
+ /**
17
+ * __Banner__
18
+ *
19
+ * Provides a slot for a Banner within the PageLayout.
20
+ *
21
+ * - [Examples](https://atlassian.design/components/page-layout/examples)
22
+ * - [Code](https://atlassian.design/components/page-layout/code)
23
+ */
24
+ export declare const Banner: (props: SlotHeightProps) => jsx.JSX.Element;
16
25
 
17
26
  export declare const BANNER_HEIGHT: string;
18
27
 
19
- export declare const Content: (props: ContentProps) => JSX.Element;
28
+ /**
29
+ * __Content__
30
+ *
31
+ * Provides a slot for your application content within the PageLayout.
32
+ *
33
+ * - [Examples](https://atlassian.design/components/page-layout/examples)
34
+ * - [Code](https://atlassian.design/components/page-layout/code)
35
+ */
36
+ export declare const Content: (props: ContentProps) => jsx.JSX.Element;
20
37
 
21
38
  declare interface ContentProps {
22
- /** React children! */
39
+ /**
40
+ * React children
41
+ */
23
42
  children: ReactNode;
24
43
  /**
25
44
  * A `testId` prop is provided for specified elements, which is a unique string that appears as a data attribute `data-testid` in the rendered code, serving as a hook for automated tests.
26
- **/
45
+ */
27
46
  testId?: string;
28
47
  }
29
48
 
@@ -42,16 +61,34 @@ export declare const LEFT_PANEL_WIDTH: string;
42
61
 
43
62
  export declare const LEFT_SIDEBAR_WIDTH: string;
44
63
 
45
- export declare const LeftPanel: (props: SlotWidthProps) => JSX.Element;
64
+ /**
65
+ * __Left panel__
66
+ *
67
+ * Provides a slot for a left panel within the PageLayout.
68
+ *
69
+ * - [Examples](https://atlassian.design/components/page-layout/examples)
70
+ * - [Code](https://atlassian.design/components/page-layout/code)
71
+ */
72
+ export declare const LeftPanel: (props: SlotWidthProps) => jsx.JSX.Element;
46
73
 
47
- export declare const LeftSidebar: (props: LeftSidebarProps) => JSX.Element;
74
+ /**
75
+ * __Left sidebar__
76
+ *
77
+ * Provides a slot for a left sidebar within the PageLayout.
78
+ *
79
+ * - [Examples](https://atlassian.design/components/page-layout/examples)
80
+ * - [Code](https://atlassian.design/components/page-layout/code)
81
+ */
82
+ export declare const LeftSidebar: (props: LeftSidebarProps) => jsx.JSX.Element;
48
83
 
49
84
  declare interface LeftSidebarProps extends SlotWidthProps {
50
85
  /**
51
86
  * A `testId` prop is provided for specified elements, which is a unique string that appears as a data attribute `data-testid` in the rendered code, serving as a hook for automated tests.
52
87
  */
53
88
  testId?: string;
54
- /** You can override prop(s) for the mentioned component(s). */
89
+ /**
90
+ * You can override prop(s) for the mentioned component(s).
91
+ */
55
92
  overrides?: {
56
93
  ResizeButton?: {
57
94
  render?: (
@@ -60,25 +97,45 @@ declare interface LeftSidebarProps extends SlotWidthProps {
60
97
  ) => ReactElement;
61
98
  };
62
99
  };
63
- /** Display label for grab area. This will be announced to the screenreaders when the grab area receives focus */
100
+ /**
101
+ * Display label for grab area. This will be announced to the screenreaders when the grab area receives focus
102
+ */
64
103
  resizeGrabAreaLabel?: string;
65
- /** Display label for resize button. */
104
+ /**
105
+ * Display label for resize button.
106
+ */
66
107
  resizeButtonLabel?: string;
67
- /** Called when left-sidebar is collapsed. */
108
+ /**
109
+ * Called when left-sidebar is collapsed.
110
+ */
68
111
  onCollapse?: () => void;
69
- /** Called when left-sidebar is expanded. */
112
+ /**
113
+ * Called when left-sidebar is expanded.
114
+ */
70
115
  onExpand?: () => void;
71
- /** Called when left-sidebar resize starts using mouse or touch. */
116
+ /**
117
+ * Called when left-sidebar resize starts using mouse or touch.
118
+ */
72
119
  onResizeStart?: (leftSidebarState: LeftSidebarState) => void;
73
- /** Called when left-sidebar resize ends using mouse or touch. */
120
+ /**
121
+ * Called when left-sidebar resize ends using mouse or touch.
122
+ */
74
123
  onResizeEnd?: (leftSidebarState: LeftSidebarState) => void;
75
- /** Called when left-sidebar is collapsed and mouse leaves the area. */
124
+ /**
125
+ * Called when left-sidebar is collapsed and mouse leaves the area.
126
+ */
76
127
  onFlyoutCollapse?: () => void;
77
- /** Called after flyout delay when left-sidebar is collapsed and mouse enters the area. */
128
+ /**
129
+ * Called after flyout delay when left-sidebar is collapsed and mouse enters the area.
130
+ */
78
131
  onFlyoutExpand?: () => void;
79
- /** Controls whether the LeftSidebar mounts in a collapsed state, this will override the setting in localStorage */
132
+ /**
133
+ * Controls whether the LeftSidebar mounts in a collapsed state, this will override the setting in localStorage
134
+ */
80
135
  collapsedState?: 'collapsed' | 'expanded';
81
- /** Controls the width when LeftSidebar mounts, this will override the setting in localStorage */
136
+ /**
137
+ * Controls the width when LeftSidebar mounts, this will override the setting in localStorage
138
+ */
82
139
  width?: number;
83
140
  }
84
141
 
@@ -92,27 +149,53 @@ export declare type LeftSidebarState = {
92
149
  isFixed: boolean;
93
150
  };
94
151
 
152
+ /**
153
+ * __Left sidebar without resize__
154
+ *
155
+ * Provides a slot for a left sidebar without resize within the PageLayout.
156
+ *
157
+ * - [Examples](https://atlassian.design/components/page-layout/examples)
158
+ * - [Code](https://atlassian.design/components/page-layout/code)
159
+ */
95
160
  export declare const LeftSidebarWithoutResize: (
96
161
  props: SlotWidthProps,
97
- ) => JSX.Element;
162
+ ) => jsx.JSX.Element;
98
163
 
99
- export declare const Main: (props: SlotWidthProps) => JSX.Element;
164
+ /**
165
+ * __Main__
166
+ *
167
+ * Provides a slot for main content within the PageLayout.
168
+ *
169
+ * - [Examples](https://atlassian.design/components/page-layout/examples)
170
+ * - [Code](https://atlassian.design/components/page-layout/code)
171
+ */
172
+ export declare const Main: (props: SlotWidthProps) => jsx.JSX.Element;
100
173
 
174
+ /**
175
+ * __Page layout__
176
+ *
177
+ * A collection of components which let you compose an application's page layout.
178
+ *
179
+ * - [Examples](https://atlassian.design/components/page-layout/examples)
180
+ * - [Code](https://atlassian.design/components/page-layout/code)
181
+ */
101
182
  export declare const PageLayout: ({
102
183
  skipLinksLabel,
103
184
  children,
104
185
  testId,
105
186
  onLeftSidebarExpand,
106
187
  onLeftSidebarCollapse,
107
- }: PageLayoutProps) => JSX.Element;
188
+ }: PageLayoutProps) => jsx.JSX.Element;
108
189
 
109
190
  declare interface PageLayoutProps extends SidebarResizeControllerProps {
110
- /** React children! */
191
+ /**
192
+ * React children!
193
+ */
111
194
  children: ReactNode;
112
195
  skipLinksLabel?: string;
113
196
  /**
114
197
  * A `testId` prop is provided for specified elements, which is a unique string that appears as a data attribute `data-testid` in the rendered code, serving as a hook for automated tests.
115
- **/
198
+ */
116
199
  testId?: string;
117
200
  }
118
201
 
@@ -126,56 +209,102 @@ export declare const RIGHT_PANEL_WIDTH: string;
126
209
 
127
210
  export declare const RIGHT_SIDEBAR_WIDTH: string;
128
211
 
129
- export declare const RightPanel: (props: SlotWidthProps) => JSX.Element;
212
+ /**
213
+ * __Right panel__
214
+ *
215
+ * Provides a slot for a right panel within the PageLayout.
216
+ *
217
+ * - [Examples](https://atlassian.design/components/page-layout/examples)
218
+ * - [Code](https://atlassian.design/components/page-layout/code)
219
+ */
220
+ export declare const RightPanel: (props: SlotWidthProps) => jsx.JSX.Element;
130
221
 
131
- export declare const RightSidebar: (props: SlotWidthProps) => JSX.Element;
222
+ /**
223
+ * __Right sidebar__
224
+ *
225
+ * Provides a slot for a right sidebar within the PageLayout.
226
+ *
227
+ * - [Examples](https://atlassian.design/components/page-layout/examples)
228
+ * - [Code](https://atlassian.design/components/page-layout/code)
229
+ */
230
+ export declare const RightSidebar: (props: SlotWidthProps) => jsx.JSX.Element;
132
231
 
133
232
  declare type SidebarResizeControllerProps = {
134
- /** Called when left-sidebar expanded. */
233
+ /**
234
+ * Called when left-sidebar expanded.
235
+ */
135
236
  onLeftSidebarExpand?: (leftSidebarState: LeftSidebarState) => void;
136
- /** Called when left-sidebar collapsed. */
237
+ /**
238
+ * Called when left-sidebar collapsed.
239
+ */
137
240
  onLeftSidebarCollapse?: (leftSidebarState: LeftSidebarState) => void;
138
241
  };
139
242
 
140
243
  declare type SkipLinkData = {
141
- /** id for the element that will be skipped to */
244
+ /**
245
+ * id for the element that will be skipped to
246
+ */
142
247
  id: string;
143
- /** Text for the link that will appear in the skip link menu */
248
+ /**
249
+ * Text for the link that will appear in the skip link menu
250
+ */
144
251
  skipLinkTitle: string;
145
- /** Desired position in the skip link menu */
252
+ /**
253
+ * Desired position in the skip link menu
254
+ */
146
255
  listIndex?: number;
147
256
  };
148
257
 
149
258
  export declare interface SlotHeightProps extends SlotProps {
150
- /** It save height in local storage. */
259
+ /**
260
+ * It save height in local storage.
261
+ */
151
262
  shouldPersistHeight?: boolean;
152
- /** Height! */
263
+ /**
264
+ * Height!
265
+ */
153
266
  height?: number;
154
267
  }
155
268
 
156
269
  declare interface SlotProps {
157
- /** Sets positon to fixed. */
270
+ /**
271
+ * Sets positon to fixed.
272
+ */
158
273
  isFixed?: boolean;
159
274
  /**
160
275
  * A `testId` prop is provided for specified elements, which is a unique string that appears as a data attribute `data-testid` in the rendered code, serving as a hook for automated tests .
161
276
  */
162
277
  testId?: string;
163
- /** React Children! */
278
+ /**
279
+ * React Children!
280
+ */
164
281
  children: ReactNode;
165
282
  id?: string;
166
283
  skipLinkTitle?: string;
167
284
  }
168
285
 
169
286
  export declare interface SlotWidthProps extends SlotProps {
170
- /** It save width in local storage. */
287
+ /**
288
+ * It save width in local storage.
289
+ */
171
290
  shouldPersistWidth?: boolean;
172
- /** Width! */
291
+ /**
292
+ * Width!
293
+ */
173
294
  width?: number;
174
295
  }
175
296
 
176
297
  export declare const TOP_NAVIGATION_HEIGHT: string;
177
298
 
178
- export declare const TopNavigation: (props: SlotHeightProps) => JSX.Element;
299
+ /**
300
+ * __Top navigation__
301
+ *
302
+ * Provides a slot for top navigation within the PageLayout.
303
+ *
304
+ * - [Examples](https://atlassian.design/components/page-layout/examples)
305
+ * - [Code](https://atlassian.design/components/page-layout/code)
306
+ */
307
+ export declare const TopNavigation: (props: SlotHeightProps) => jsx.JSX.Element;
179
308
 
180
309
  export declare const useCustomSkipLink: (
181
310
  id: SkipLinkData['id'],
@@ -184,7 +313,7 @@ export declare const useCustomSkipLink: (
184
313
  ) => void;
185
314
 
186
315
  /**
187
- * **WARNING:** This hook is intended as a temporary solution and
316
+ * _**WARNING:**_ This hook is intended as a temporary solution and
188
317
  * is likely to be removed in a future version of page-layout.
189
318
  *
190
319
  * ---