@atlaskit/page-header 12.2.0 → 13.0.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.
- package/CHANGELOG.md +26 -0
- package/package.json +15 -22
- package/page-header/package.json +1 -8
- package/page-header.docs.tsx +42 -40
- package/dist/types-ts4.5/PageHeader/actions-wrapper.d.ts +0 -15
- package/dist/types-ts4.5/PageHeader/bottom-bar.d.ts +0 -15
- package/dist/types-ts4.5/PageHeader/index.d.ts +0 -51
- package/dist/types-ts4.5/PageHeader/outer-wrapper.d.ts +0 -16
- package/dist/types-ts4.5/PageHeader/title-container.d.ts +0 -17
- package/dist/types-ts4.5/PageHeader/title-wrapper.d.ts +0 -17
- package/dist/types-ts4.5/PageHeader/title.d.ts +0 -19
- package/dist/types-ts4.5/entry-points/page-header.d.ts +0 -1
- package/dist/types-ts4.5/index.d.ts +0 -1
- package/offerings.json +0 -34
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,31 @@
|
|
|
1
1
|
# @atlaskit/page-header
|
|
2
2
|
|
|
3
|
+
## 13.0.0
|
|
4
|
+
|
|
5
|
+
### Major Changes
|
|
6
|
+
|
|
7
|
+
- [`f2dc9097319f0`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/f2dc9097319f0) - ###
|
|
8
|
+
Dropped support for _legacy_ Typescript 4 types. **Typescript 5 is now the new minimum**.
|
|
9
|
+
|
|
10
|
+
Removes the `typesVersions` property and `dist/types-ts4.5` directory from the dist.
|
|
11
|
+
|
|
12
|
+
Types are now exclusively via the `"types": "dist/types/index.d.ts"` property.
|
|
13
|
+
|
|
14
|
+
```diff
|
|
15
|
+
- "typesVersions": {
|
|
16
|
+
- ">=4.5 <4.9": {
|
|
17
|
+
- "*": [
|
|
18
|
+
- "dist/types-ts4.5/*",
|
|
19
|
+
- "dist/types-ts4.5/index.d.ts"
|
|
20
|
+
- ]
|
|
21
|
+
- }
|
|
22
|
+
- },
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### Patch Changes
|
|
26
|
+
|
|
27
|
+
- Updated dependencies
|
|
28
|
+
|
|
3
29
|
## 12.2.0
|
|
4
30
|
|
|
5
31
|
### Minor Changes
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@atlaskit/page-header",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "13.0.0",
|
|
4
4
|
"description": "A page header defines the top of a page. It contains a title and can be optionally combined with breadcrumbs buttons, search, and filters.",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"registry": "https://registry.npmjs.org/"
|
|
@@ -31,9 +31,9 @@
|
|
|
31
31
|
}
|
|
32
32
|
},
|
|
33
33
|
"dependencies": {
|
|
34
|
-
"@atlaskit/css": "^0.
|
|
35
|
-
"@atlaskit/primitives": "^
|
|
36
|
-
"@atlaskit/tokens": "^
|
|
34
|
+
"@atlaskit/css": "^1.0.0",
|
|
35
|
+
"@atlaskit/primitives": "^20.0.0",
|
|
36
|
+
"@atlaskit/tokens": "^14.0.0",
|
|
37
37
|
"@babel/runtime": "^7.0.0",
|
|
38
38
|
"@compiled/react": "^0.20.0"
|
|
39
39
|
},
|
|
@@ -45,20 +45,21 @@
|
|
|
45
45
|
"@af/accessibility-testing": "workspace:^",
|
|
46
46
|
"@af/integration-testing": "workspace:^",
|
|
47
47
|
"@af/visual-regression": "workspace:^",
|
|
48
|
-
"@atlaskit/breadcrumbs": "^
|
|
49
|
-
"@atlaskit/button": "^
|
|
50
|
-
"@atlaskit/docs": "^
|
|
51
|
-
"@atlaskit/ds-lib": "^
|
|
52
|
-
"@atlaskit/inline-edit": "^
|
|
53
|
-
"@atlaskit/link": "^
|
|
54
|
-
"@atlaskit/page": "^
|
|
55
|
-
"@atlaskit/section-message": "^
|
|
56
|
-
"@atlaskit/select": "^
|
|
57
|
-
"@atlaskit/textfield": "^
|
|
48
|
+
"@atlaskit/breadcrumbs": "^17.0.0",
|
|
49
|
+
"@atlaskit/button": "^24.0.0",
|
|
50
|
+
"@atlaskit/docs": "^12.0.0",
|
|
51
|
+
"@atlaskit/ds-lib": "^8.0.0",
|
|
52
|
+
"@atlaskit/inline-edit": "^16.0.0",
|
|
53
|
+
"@atlaskit/link": "^4.0.0",
|
|
54
|
+
"@atlaskit/page": "^15.0.0",
|
|
55
|
+
"@atlaskit/section-message": "^9.0.0",
|
|
56
|
+
"@atlaskit/select": "^22.0.0",
|
|
57
|
+
"@atlaskit/textfield": "^9.0.0",
|
|
58
58
|
"@atlassian/react-compiler-gating": "workspace:^",
|
|
59
59
|
"@atlassian/ssr-tests": "workspace:^",
|
|
60
60
|
"@atlassian/structured-docs-types": "workspace:^",
|
|
61
61
|
"@testing-library/react": "^16.3.0",
|
|
62
|
+
"react": "^18.2.0",
|
|
62
63
|
"react-dom": "^18.2.0"
|
|
63
64
|
},
|
|
64
65
|
"keywords": [
|
|
@@ -88,13 +89,5 @@
|
|
|
88
89
|
"deprecation": "no-deprecated-imports"
|
|
89
90
|
}
|
|
90
91
|
},
|
|
91
|
-
"typesVersions": {
|
|
92
|
-
">=4.5 <4.9": {
|
|
93
|
-
"*": [
|
|
94
|
-
"dist/types-ts4.5/*",
|
|
95
|
-
"dist/types-ts4.5/index.d.ts"
|
|
96
|
-
]
|
|
97
|
-
}
|
|
98
|
-
},
|
|
99
92
|
"homepage": "https://atlassian.design/components/page-header"
|
|
100
93
|
}
|
package/page-header/package.json
CHANGED
|
@@ -6,12 +6,5 @@
|
|
|
6
6
|
"sideEffects": [
|
|
7
7
|
"**/*.compiled.css"
|
|
8
8
|
],
|
|
9
|
-
"types": "../dist/types/entry-points/page-header.d.ts"
|
|
10
|
-
"typesVersions": {
|
|
11
|
-
">=4.5 <5.9": {
|
|
12
|
-
"*": [
|
|
13
|
-
"../dist/types-ts4.5/entry-points/page-header.d.ts"
|
|
14
|
-
]
|
|
15
|
-
}
|
|
16
|
-
}
|
|
9
|
+
"types": "../dist/types/entry-points/page-header.d.ts"
|
|
17
10
|
}
|
package/page-header.docs.tsx
CHANGED
|
@@ -1,47 +1,49 @@
|
|
|
1
1
|
import path from 'path';
|
|
2
2
|
|
|
3
|
-
import type {
|
|
3
|
+
import type { StructuredContentSource } from '@atlassian/structured-docs-types/types';
|
|
4
4
|
|
|
5
|
-
const documentation:
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
description: 'A component for page headers.',
|
|
9
|
-
status: 'general-availability',
|
|
10
|
-
import: {
|
|
5
|
+
const documentation: StructuredContentSource = {
|
|
6
|
+
components: [
|
|
7
|
+
{
|
|
11
8
|
name: 'PageHeader',
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
'Provide relevant page actions',
|
|
21
|
-
'Use appropriate header hierarchy',
|
|
22
|
-
],
|
|
23
|
-
contentGuidelines: [
|
|
24
|
-
'Use clear, descriptive page titles',
|
|
25
|
-
'Provide meaningful breadcrumb labels',
|
|
26
|
-
'Use action-oriented button text',
|
|
27
|
-
'Keep header content focused',
|
|
28
|
-
],
|
|
29
|
-
accessibilityGuidelines: [
|
|
30
|
-
'Provide clear page titles',
|
|
31
|
-
'Use appropriate heading hierarchy',
|
|
32
|
-
'Ensure breadcrumb navigation is accessible',
|
|
33
|
-
'Provide clear action labels',
|
|
34
|
-
],
|
|
35
|
-
examples: [
|
|
36
|
-
{
|
|
37
|
-
name: 'Page Header',
|
|
38
|
-
description: 'Page Header example',
|
|
39
|
-
source: path.resolve(__dirname, './examples/ai/page-header.tsx'),
|
|
9
|
+
description: 'A component for page headers.',
|
|
10
|
+
status: 'general-availability',
|
|
11
|
+
import: {
|
|
12
|
+
name: 'PageHeader',
|
|
13
|
+
package: '@atlaskit/page-header',
|
|
14
|
+
type: 'default',
|
|
15
|
+
packagePath: path.resolve(__dirname),
|
|
16
|
+
packageJson: require('./package.json'),
|
|
40
17
|
},
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
18
|
+
usageGuidelines: [
|
|
19
|
+
'Use for consistent page header layout',
|
|
20
|
+
'Include breadcrumbs for navigation context',
|
|
21
|
+
'Provide relevant page actions',
|
|
22
|
+
'Use appropriate header hierarchy',
|
|
23
|
+
],
|
|
24
|
+
contentGuidelines: [
|
|
25
|
+
'Use clear, descriptive page titles',
|
|
26
|
+
'Provide meaningful breadcrumb labels',
|
|
27
|
+
'Use action-oriented button text',
|
|
28
|
+
'Keep header content focused',
|
|
29
|
+
],
|
|
30
|
+
accessibilityGuidelines: [
|
|
31
|
+
'Provide clear page titles',
|
|
32
|
+
'Use appropriate heading hierarchy',
|
|
33
|
+
'Ensure breadcrumb navigation is accessible',
|
|
34
|
+
'Provide clear action labels',
|
|
35
|
+
],
|
|
36
|
+
examples: [
|
|
37
|
+
{
|
|
38
|
+
name: 'Page Header',
|
|
39
|
+
description: 'Page Header example',
|
|
40
|
+
source: path.resolve(__dirname, './examples/ai/page-header.tsx'),
|
|
41
|
+
},
|
|
42
|
+
],
|
|
43
|
+
keywords: ['page', 'header', 'title', 'breadcrumbs', 'actions'],
|
|
44
|
+
categories: ['layout'],
|
|
45
|
+
},
|
|
46
|
+
],
|
|
47
|
+
};
|
|
46
48
|
|
|
47
49
|
export default documentation;
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @jsxRuntime classic
|
|
3
|
-
* @jsx jsx
|
|
4
|
-
*/
|
|
5
|
-
import { type ReactNode } from 'react';
|
|
6
|
-
/**
|
|
7
|
-
* __Actions wrapper__.
|
|
8
|
-
*
|
|
9
|
-
* An actions wrapper is a wrapper for the actions, which appear on the top right of the PageHeader component.
|
|
10
|
-
*
|
|
11
|
-
*/
|
|
12
|
-
declare const ActionsWrapper: ({ children }: {
|
|
13
|
-
children: ReactNode;
|
|
14
|
-
}) => JSX.Element;
|
|
15
|
-
export default ActionsWrapper;
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @jsxRuntime classic
|
|
3
|
-
* @jsx jsx
|
|
4
|
-
*/
|
|
5
|
-
import { type ReactNode } from 'react';
|
|
6
|
-
/**
|
|
7
|
-
* __Bottom bar__.
|
|
8
|
-
*
|
|
9
|
-
* A bottom bar is a wrapper for the bottom bar, which appears at the bottom of the PageHeader component.
|
|
10
|
-
*
|
|
11
|
-
*/
|
|
12
|
-
declare const BottomBar: ({ children }: {
|
|
13
|
-
children: ReactNode;
|
|
14
|
-
}) => JSX.Element;
|
|
15
|
-
export default BottomBar;
|
|
@@ -1,51 +0,0 @@
|
|
|
1
|
-
import React, { type ReactElement, type ReactNode } from 'react';
|
|
2
|
-
type PageHeaderProps = {
|
|
3
|
-
/**
|
|
4
|
-
* Contents of the action bar to be rendered next to the page title.
|
|
5
|
-
*/
|
|
6
|
-
actions?: ReactElement;
|
|
7
|
-
/**
|
|
8
|
-
* Contents of the action bar to be rendered next to the page title. Typically a button group.
|
|
9
|
-
*/
|
|
10
|
-
bottomBar?: ReactElement;
|
|
11
|
-
/**
|
|
12
|
-
* Page breadcrumbs to be rendered above the title.
|
|
13
|
-
*/
|
|
14
|
-
breadcrumbs?: ReactElement;
|
|
15
|
-
/**
|
|
16
|
-
* Contents of the bottom bar to be rendered below the page title. Typically contains a search bar and/or filters.
|
|
17
|
-
*/
|
|
18
|
-
children?: ReactNode;
|
|
19
|
-
/**
|
|
20
|
-
* Content of the page title. The text wraps by default.
|
|
21
|
-
*/
|
|
22
|
-
disableTitleStyles?: boolean;
|
|
23
|
-
/**
|
|
24
|
-
* Returns the inner ref to the DOM element of the title. This is exposed so the focus can be set.
|
|
25
|
-
*/
|
|
26
|
-
innerRef?: (element: HTMLElement) => void;
|
|
27
|
-
/**
|
|
28
|
-
* Prevent the title from wrapping across lines. Avoid using this wherever possible, as truncation can make page headings inaccessible.
|
|
29
|
-
*/
|
|
30
|
-
truncateTitle?: boolean;
|
|
31
|
-
/**
|
|
32
|
-
* Used as the ID of the inner h1 tag. This is exposed so the header text can be used as label of other elements by aria-labelledby.
|
|
33
|
-
*/
|
|
34
|
-
id?: string;
|
|
35
|
-
/**
|
|
36
|
-
* 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.
|
|
37
|
-
*/
|
|
38
|
-
testId?: string;
|
|
39
|
-
};
|
|
40
|
-
/**
|
|
41
|
-
* __Page header__
|
|
42
|
-
*
|
|
43
|
-
* A page header defines the top of a page. It contains a title and can be optionally combined with
|
|
44
|
-
* breadcrumbs buttons, search, and filters.
|
|
45
|
-
*
|
|
46
|
-
* - [Examples](https://atlassian.design/components/page-header/examples)
|
|
47
|
-
* - [Code](https://atlassian.design/components/page-header/code)
|
|
48
|
-
* - [Usage](https://atlassian.design/components/page-header/usage)
|
|
49
|
-
*/
|
|
50
|
-
declare const PageHeader: ({ innerRef, breadcrumbs, actions, bottomBar, children, id, disableTitleStyles, truncateTitle, testId, }: PageHeaderProps) => React.JSX.Element;
|
|
51
|
-
export default PageHeader;
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @jsxRuntime classic
|
|
3
|
-
* @jsx jsx
|
|
4
|
-
*/
|
|
5
|
-
import { type ReactNode } from 'react';
|
|
6
|
-
/**
|
|
7
|
-
* __Outer wrapper__.
|
|
8
|
-
*
|
|
9
|
-
* An outer wrapper that is the outermost component of the PageHeader component. It wraps around the PageHeader, its Actions,
|
|
10
|
-
* the BottomBar and its Breadcrumbs.
|
|
11
|
-
*
|
|
12
|
-
*/
|
|
13
|
-
declare const OuterWrapper: ({ children }: {
|
|
14
|
-
children: ReactNode;
|
|
15
|
-
}) => JSX.Element;
|
|
16
|
-
export default OuterWrapper;
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @jsxRuntime classic
|
|
3
|
-
* @jsx jsx
|
|
4
|
-
*/
|
|
5
|
-
import { type ReactNode } from 'react';
|
|
6
|
-
interface TitleProps {
|
|
7
|
-
truncateTitle?: boolean;
|
|
8
|
-
children?: ReactNode;
|
|
9
|
-
}
|
|
10
|
-
/**
|
|
11
|
-
* Title container.
|
|
12
|
-
*
|
|
13
|
-
* A title container is a container that wraps around the title and its styles (if applied).
|
|
14
|
-
*
|
|
15
|
-
*/
|
|
16
|
-
declare const TitleContainer: ({ children, truncateTitle }: TitleProps) => JSX.Element;
|
|
17
|
-
export default TitleContainer;
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @jsxRuntime classic
|
|
3
|
-
* @jsx jsx
|
|
4
|
-
*/
|
|
5
|
-
import { type ReactNode } from 'react';
|
|
6
|
-
interface TitleProps {
|
|
7
|
-
truncateTitle?: boolean;
|
|
8
|
-
children?: ReactNode;
|
|
9
|
-
}
|
|
10
|
-
/**
|
|
11
|
-
* __Title wrapper__.
|
|
12
|
-
*
|
|
13
|
-
* A title wrapper is a wrapper around the title and the actions.
|
|
14
|
-
*
|
|
15
|
-
*/
|
|
16
|
-
declare const TitleWrapper: ({ children, truncateTitle }: TitleProps) => JSX.Element;
|
|
17
|
-
export default TitleWrapper;
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @jsxRuntime classic
|
|
3
|
-
* @jsx jsx
|
|
4
|
-
*/
|
|
5
|
-
import React from 'react';
|
|
6
|
-
interface TitleProps {
|
|
7
|
-
children?: React.ReactNode;
|
|
8
|
-
id?: string;
|
|
9
|
-
truncateTitle?: boolean;
|
|
10
|
-
testId?: string;
|
|
11
|
-
}
|
|
12
|
-
/**
|
|
13
|
-
* __Styled title wrapper__.
|
|
14
|
-
*
|
|
15
|
-
* A styled title wrapper is a wrapper around the title that controls its the styles exclusively.
|
|
16
|
-
*
|
|
17
|
-
*/
|
|
18
|
-
declare const Title: React.ForwardRefExoticComponent<React.PropsWithoutRef<TitleProps> & React.RefAttributes<HTMLHeadingElement>>;
|
|
19
|
-
export default Title;
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
export { default } from '../PageHeader/index';
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
export { default } from './PageHeader';
|
package/offerings.json
DELETED
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
[
|
|
2
|
-
{
|
|
3
|
-
"name": "PageHeader",
|
|
4
|
-
"package": "@atlaskit/page-header",
|
|
5
|
-
"import": {
|
|
6
|
-
"name": "PageHeader",
|
|
7
|
-
"package": "@atlaskit/page-header",
|
|
8
|
-
"type": "default"
|
|
9
|
-
},
|
|
10
|
-
"keywords": ["page", "header", "title", "breadcrumbs", "actions"],
|
|
11
|
-
"categories": ["layout"],
|
|
12
|
-
"shortDescription": "A component for page headers.",
|
|
13
|
-
"status": "general-availability",
|
|
14
|
-
"accessibilityGuidelines": [
|
|
15
|
-
"Provide clear page titles",
|
|
16
|
-
"Use appropriate heading hierarchy",
|
|
17
|
-
"Ensure breadcrumb navigation is accessible",
|
|
18
|
-
"Provide clear action labels"
|
|
19
|
-
],
|
|
20
|
-
"usageGuidelines": [
|
|
21
|
-
"Use for consistent page header layout",
|
|
22
|
-
"Include breadcrumbs for navigation context",
|
|
23
|
-
"Provide relevant page actions",
|
|
24
|
-
"Use appropriate header hierarchy"
|
|
25
|
-
],
|
|
26
|
-
"contentGuidelines": [
|
|
27
|
-
"Use clear, descriptive page titles",
|
|
28
|
-
"Provide meaningful breadcrumb labels",
|
|
29
|
-
"Use action-oriented button text",
|
|
30
|
-
"Keep header content focused"
|
|
31
|
-
],
|
|
32
|
-
"examples": ["./examples/ai/page-header.tsx"]
|
|
33
|
-
}
|
|
34
|
-
]
|