@primer/components 29.1.0-rc.79e8b21e → 29.1.0
Sign up to get free protection for your applications and to get access to all the features.
- package/package.json +1 -1
- package/.changeset/README.md +0 -8
- package/.changeset/config.json +0 -10
- package/.devcontainer/devcontainer.json +0 -8
- package/.eslintrc.json +0 -106
- package/.github/ISSUE_TEMPLATE/bug_report.md +0 -38
- package/.github/ISSUE_TEMPLATE/new_component_proposal_template.md +0 -41
- package/.github/dependabot.yml +0 -18
- package/.github/pull_request_template.md +0 -18
- package/.github/workflows/ci.yml +0 -31
- package/.github/workflows/deploy_preview.yml +0 -47
- package/.github/workflows/deploy_production.yml +0 -70
- package/.github/workflows/release.yml +0 -35
- package/.github/workflows/release_canary.yml +0 -70
- package/.github/workflows/release_candidate.yml +0 -60
- package/.github/workflows/size.yml +0 -13
- package/.github/workflows/stale.yml +0 -26
- package/.gitignore +0 -10
- package/.npmrc +0 -4
- package/.nvmrc +0 -1
- package/.storybook/main.js +0 -11
- package/.storybook/preview.js +0 -11
- package/.vscode/launch.json +0 -21
- package/.vscode/settings.json +0 -13
- package/@types/@styled-system/index.d.ts +0 -0
- package/@types/@styled-system/prop-types/index.d.ts +0 -1
- package/@types/@styled-system/props/index.d.ts +0 -1
- package/@types/jest-styled-components/index.d.ts +0 -1
- package/CODEOWNERS +0 -2
- package/babel-defines.js +0 -13
- package/babel.config.js +0 -39
- package/contributor-docs/CODE_OF_CONDUCT.md +0 -76
- package/contributor-docs/CONTRIBUTING.md +0 -274
- package/contributor-docs/adrs/adr-001-typescript.md +0 -23
- package/contributor-docs/adrs/adr-002-behavior-isolation.md +0 -106
- package/contributor-docs/behaviors.md +0 -132
- package/contributor-docs/component-contents-api-patterns.md +0 -315
- package/contributor-docs/principles.md +0 -39
- package/docs/.eslintrc +0 -0
- package/docs/.gitignore +0 -91
- package/docs/components/PropsList.js +0 -5
- package/docs/components/State.js +0 -9
- package/docs/components/constants.js +0 -34
- package/docs/components/index.js +0 -2
- package/docs/content/ActionList.mdx +0 -72
- package/docs/content/ActionMenu.mdx +0 -80
- package/docs/content/AnchoredOverlay.mdx +0 -37
- package/docs/content/Avatar.mdx +0 -33
- package/docs/content/AvatarStack.mdx +0 -43
- package/docs/content/BorderBox.md +0 -46
- package/docs/content/Box.md +0 -74
- package/docs/content/BranchName.md +0 -18
- package/docs/content/Breadcrumbs.md +0 -52
- package/docs/content/Buttons.md +0 -54
- package/docs/content/CircleBadge.md +0 -45
- package/docs/content/CircleOcticon.md +0 -18
- package/docs/content/CounterLabel.md +0 -30
- package/docs/content/Details.md +0 -105
- package/docs/content/Dialog.md +0 -108
- package/docs/content/Dialog2.mdx +0 -179
- package/docs/content/Dropdown.md +0 -72
- package/docs/content/DropdownMenu.mdx +0 -49
- package/docs/content/FilterList.md +0 -44
- package/docs/content/FilteredSearch.md +0 -39
- package/docs/content/Flash.md +0 -42
- package/docs/content/Flex.md +0 -58
- package/docs/content/FormGroup.md +0 -44
- package/docs/content/Grid.md +0 -59
- package/docs/content/Header.md +0 -79
- package/docs/content/Heading.md +0 -22
- package/docs/content/Label.md +0 -40
- package/docs/content/LabelGroup.md +0 -31
- package/docs/content/Link.md +0 -37
- package/docs/content/Overlay.mdx +0 -94
- package/docs/content/Pagehead.md +0 -27
- package/docs/content/Pagination.md +0 -187
- package/docs/content/PointerBox.md +0 -81
- package/docs/content/Popover.md +0 -137
- package/docs/content/Portal.mdx +0 -73
- package/docs/content/Position.md +0 -97
- package/docs/content/ProgressBar.mdx +0 -29
- package/docs/content/SelectMenu.md +0 -433
- package/docs/content/SelectPanel.mdx +0 -67
- package/docs/content/SideNav.md +0 -179
- package/docs/content/Spinner.mdx +0 -32
- package/docs/content/StateLabel.md +0 -33
- package/docs/content/StyledOcticon.md +0 -34
- package/docs/content/SubNav.md +0 -102
- package/docs/content/TabNav.md +0 -50
- package/docs/content/Text.md +0 -29
- package/docs/content/TextInput.md +0 -32
- package/docs/content/Timeline.md +0 -138
- package/docs/content/Tooltip.md +0 -41
- package/docs/content/Truncate.md +0 -65
- package/docs/content/UnderlineNav.md +0 -53
- package/docs/content/anchoredPosition.mdx +0 -163
- package/docs/content/core-concepts.md +0 -70
- package/docs/content/focusTrap.mdx +0 -103
- package/docs/content/focusZone.mdx +0 -145
- package/docs/content/getting-started.md +0 -134
- package/docs/content/index.md +0 -33
- package/docs/content/linting.md +0 -35
- package/docs/content/overriding-styles.mdx +0 -79
- package/docs/content/philosophy.md +0 -23
- package/docs/content/primer-theme.md +0 -89
- package/docs/content/ssr.mdx +0 -43
- package/docs/content/system-props.mdx +0 -37
- package/docs/content/theme-reference.md +0 -16
- package/docs/content/theming.md +0 -249
- package/docs/content/useOnEscapePress.mdx +0 -56
- package/docs/content/useOnOutsideClick.mdx +0 -57
- package/docs/content/useOpenAndCloseFocus.mdx +0 -49
- package/docs/content/useOverlay.mdx +0 -62
- package/docs/content/useSafeTimeout.mdx +0 -32
- package/docs/gatsby-config.js +0 -30
- package/docs/gatsby-node.js +0 -101
- package/docs/package-lock.json +0 -20979
- package/docs/package.json +0 -35
- package/docs/src/@primer/gatsby-theme-doctocat/components/hero.js +0 -21
- package/docs/src/@primer/gatsby-theme-doctocat/components/live-code.js +0 -84
- package/docs/src/@primer/gatsby-theme-doctocat/components/live-preview-wrapper.js +0 -39
- package/docs/src/@primer/gatsby-theme-doctocat/components/nav-dropdown.js +0 -48
- package/docs/src/@primer/gatsby-theme-doctocat/components/wrap-page-element.js +0 -25
- package/docs/src/@primer/gatsby-theme-doctocat/live-code-scope.js +0 -54
- package/docs/src/@primer/gatsby-theme-doctocat/nav.yml +0 -127
- package/docs/src/@primer/gatsby-theme-doctocat/primer-components-hero.svg +0 -1411
- package/docs/src/props.js +0 -77
- package/jest.config.js +0 -13
- package/lib/__tests__/ActionList.d.ts +0 -1
- package/lib/__tests__/ActionList.js +0 -67
- package/lib/__tests__/ActionMenu.d.ts +0 -1
- package/lib/__tests__/ActionMenu.js +0 -154
- package/lib/__tests__/AnchoredOverlay.d.ts +0 -1
- package/lib/__tests__/AnchoredOverlay.js +0 -161
- package/lib/__tests__/Avatar.d.ts +0 -1
- package/lib/__tests__/Avatar.js +0 -70
- package/lib/__tests__/AvatarStack.d.ts +0 -1
- package/lib/__tests__/AvatarStack.js +0 -71
- package/lib/__tests__/BorderBox.d.ts +0 -1
- package/lib/__tests__/BorderBox.js +0 -61
- package/lib/__tests__/Box.d.ts +0 -1
- package/lib/__tests__/Box.js +0 -81
- package/lib/__tests__/BranchName.d.ts +0 -1
- package/lib/__tests__/BranchName.js +0 -39
- package/lib/__tests__/Breadcrumb.d.ts +0 -1
- package/lib/__tests__/Breadcrumb.js +0 -42
- package/lib/__tests__/BreadcrumbItem.d.ts +0 -1
- package/lib/__tests__/BreadcrumbItem.js +0 -52
- package/lib/__tests__/Button.d.ts +0 -1
- package/lib/__tests__/Button.js +0 -152
- package/lib/__tests__/Caret.d.ts +0 -1
- package/lib/__tests__/Caret.js +0 -52
- package/lib/__tests__/CircleBadge.d.ts +0 -1
- package/lib/__tests__/CircleBadge.js +0 -87
- package/lib/__tests__/CircleOcticon.d.ts +0 -1
- package/lib/__tests__/CircleOcticon.js +0 -74
- package/lib/__tests__/CounterLabel.d.ts +0 -1
- package/lib/__tests__/CounterLabel.js +0 -61
- package/lib/__tests__/Details.d.ts +0 -1
- package/lib/__tests__/Details.js +0 -120
- package/lib/__tests__/Dialog.d.ts +0 -1
- package/lib/__tests__/Dialog.js +0 -188
- package/lib/__tests__/Dropdown.d.ts +0 -1
- package/lib/__tests__/Dropdown.js +0 -70
- package/lib/__tests__/DropdownMenu.d.ts +0 -1
- package/lib/__tests__/DropdownMenu.js +0 -153
- package/lib/__tests__/FilterList.d.ts +0 -1
- package/lib/__tests__/FilterList.js +0 -39
- package/lib/__tests__/FilterListItem.d.ts +0 -1
- package/lib/__tests__/FilterListItem.js +0 -49
- package/lib/__tests__/FilteredSearch.d.ts +0 -1
- package/lib/__tests__/FilteredSearch.js +0 -39
- package/lib/__tests__/Flash.d.ts +0 -1
- package/lib/__tests__/Flash.js +0 -65
- package/lib/__tests__/Flex.d.ts +0 -1
- package/lib/__tests__/Flex.js +0 -77
- package/lib/__tests__/FormGroup.d.ts +0 -1
- package/lib/__tests__/FormGroup.js +0 -58
- package/lib/__tests__/Grid.d.ts +0 -1
- package/lib/__tests__/Grid.js +0 -107
- package/lib/__tests__/Header.d.ts +0 -1
- package/lib/__tests__/Header.js +0 -63
- package/lib/__tests__/Heading.d.ts +0 -1
- package/lib/__tests__/Heading.js +0 -112
- package/lib/__tests__/Label.d.ts +0 -1
- package/lib/__tests__/Label.js +0 -49
- package/lib/__tests__/LabelGroup.d.ts +0 -1
- package/lib/__tests__/LabelGroup.js +0 -41
- package/lib/__tests__/Link.d.ts +0 -1
- package/lib/__tests__/Link.js +0 -73
- package/lib/__tests__/Overlay.d.ts +0 -1
- package/lib/__tests__/Overlay.js +0 -145
- package/lib/__tests__/Pagehead.d.ts +0 -1
- package/lib/__tests__/Pagehead.js +0 -40
- package/lib/__tests__/Pagination/Pagination.d.ts +0 -1
- package/lib/__tests__/Pagination/Pagination.js +0 -50
- package/lib/__tests__/Pagination/PaginationModel.d.ts +0 -1
- package/lib/__tests__/Pagination/PaginationModel.js +0 -186
- package/lib/__tests__/PointerBox.d.ts +0 -1
- package/lib/__tests__/PointerBox.js +0 -49
- package/lib/__tests__/Popover.d.ts +0 -1
- package/lib/__tests__/Popover.js +0 -70
- package/lib/__tests__/Portal.d.ts +0 -1
- package/lib/__tests__/Portal.js +0 -124
- package/lib/__tests__/Position.d.ts +0 -1
- package/lib/__tests__/Position.js +0 -149
- package/lib/__tests__/ProgressBar.d.ts +0 -1
- package/lib/__tests__/ProgressBar.js +0 -71
- package/lib/__tests__/SelectMenu.d.ts +0 -1
- package/lib/__tests__/SelectMenu.js +0 -155
- package/lib/__tests__/SelectPanel.d.ts +0 -1
- package/lib/__tests__/SelectPanel.js +0 -83
- package/lib/__tests__/SideNav.d.ts +0 -1
- package/lib/__tests__/SideNav.js +0 -75
- package/lib/__tests__/Spinner.d.ts +0 -1
- package/lib/__tests__/Spinner.js +0 -56
- package/lib/__tests__/StateLabel.d.ts +0 -1
- package/lib/__tests__/StateLabel.js +0 -74
- package/lib/__tests__/StyledOcticon.d.ts +0 -1
- package/lib/__tests__/StyledOcticon.js +0 -43
- package/lib/__tests__/SubNav.d.ts +0 -1
- package/lib/__tests__/SubNav.js +0 -65
- package/lib/__tests__/SubNavLink.d.ts +0 -1
- package/lib/__tests__/SubNavLink.js +0 -52
- package/lib/__tests__/TabNav.d.ts +0 -1
- package/lib/__tests__/TabNav.js +0 -53
- package/lib/__tests__/Text.d.ts +0 -1
- package/lib/__tests__/Text.js +0 -108
- package/lib/__tests__/TextInput.d.ts +0 -1
- package/lib/__tests__/TextInput.js +0 -81
- package/lib/__tests__/ThemeProvider.d.ts +0 -1
- package/lib/__tests__/ThemeProvider.js +0 -444
- package/lib/__tests__/Timeline.d.ts +0 -1
- package/lib/__tests__/Timeline.js +0 -80
- package/lib/__tests__/Tooltip.d.ts +0 -1
- package/lib/__tests__/Tooltip.js +0 -72
- package/lib/__tests__/Truncate.d.ts +0 -1
- package/lib/__tests__/Truncate.js +0 -66
- package/lib/__tests__/UnderlineNav.d.ts +0 -1
- package/lib/__tests__/UnderlineNav.js +0 -75
- package/lib/__tests__/UnderlineNavLink.d.ts +0 -1
- package/lib/__tests__/UnderlineNavLink.js +0 -54
- package/lib/__tests__/behaviors/anchoredPosition.d.ts +0 -1
- package/lib/__tests__/behaviors/anchoredPosition.js +0 -390
- package/lib/__tests__/behaviors/focusTrap.d.ts +0 -1
- package/lib/__tests__/behaviors/focusTrap.js +0 -234
- package/lib/__tests__/behaviors/focusZone.d.ts +0 -1
- package/lib/__tests__/behaviors/focusZone.js +0 -570
- package/lib/__tests__/behaviors/iterateFocusableElements.d.ts +0 -1
- package/lib/__tests__/behaviors/iterateFocusableElements.js +0 -55
- package/lib/__tests__/filterObject.d.ts +0 -1
- package/lib/__tests__/filterObject.js +0 -30
- package/lib/__tests__/hooks/useAnchoredPosition.d.ts +0 -1
- package/lib/__tests__/hooks/useAnchoredPosition.js +0 -54
- package/lib/__tests__/hooks/useOnEscapePress.d.ts +0 -1
- package/lib/__tests__/hooks/useOnEscapePress.js +0 -32
- package/lib/__tests__/hooks/useOnOutsideClick.d.ts +0 -1
- package/lib/__tests__/hooks/useOnOutsideClick.js +0 -87
- package/lib/__tests__/hooks/useOpenAndCloseFocus.d.ts +0 -1
- package/lib/__tests__/hooks/useOpenAndCloseFocus.js +0 -60
- package/lib/__tests__/hooks/useProvidedStateOrCreate.d.ts +0 -1
- package/lib/__tests__/hooks/useProvidedStateOrCreate.js +0 -45
- package/lib/__tests__/theme.d.ts +0 -1
- package/lib/__tests__/theme.js +0 -36
- package/lib/__tests__/themeGet.d.ts +0 -1
- package/lib/__tests__/themeGet.js +0 -25
- package/lib/__tests__/useSafeTimeout.d.ts +0 -1
- package/lib/__tests__/useSafeTimeout.js +0 -45
- package/lib/stories/ActionList.stories.d.ts +0 -40
- package/lib/stories/ActionList.stories.js +0 -382
- package/lib/stories/ActionMenu.stories.d.ts +0 -29
- package/lib/stories/ActionMenu.stories.js +0 -338
- package/lib/stories/AnchoredOverlay.stories.d.ts +0 -6
- package/lib/stories/AnchoredOverlay.stories.js +0 -127
- package/lib/stories/AvatarStack.stories.d.ts +0 -8
- package/lib/stories/AvatarStack.stories.js +0 -49
- package/lib/stories/Button.stories.d.ts +0 -57
- package/lib/stories/Button.stories.js +0 -114
- package/lib/stories/ConfirmationDialog.stories.d.ts +0 -7
- package/lib/stories/ConfirmationDialog.stories.js +0 -111
- package/lib/stories/Dialog.stories.d.ts +0 -13
- package/lib/stories/Dialog.stories.js +0 -265
- package/lib/stories/DropdownMenu.stories.d.ts +0 -12
- package/lib/stories/DropdownMenu.stories.js +0 -122
- package/lib/stories/Overlay.stories.d.ts +0 -7
- package/lib/stories/Overlay.stories.js +0 -185
- package/lib/stories/Portal.stories.d.ts +0 -8
- package/lib/stories/Portal.stories.js +0 -104
- package/lib/stories/SelectPanel.stories.d.ts +0 -32
- package/lib/stories/SelectPanel.stories.js +0 -342
- package/lib/stories/ThemeProvider.stories.d.ts +0 -6
- package/lib/stories/ThemeProvider.stories.js +0 -102
- package/lib/stories/useAnchoredPosition.stories.d.ts +0 -8
- package/lib/stories/useAnchoredPosition.stories.js +0 -351
- package/lib/stories/useFocusTrap.stories.d.ts +0 -9
- package/lib/stories/useFocusTrap.stories.js +0 -356
- package/lib/stories/useFocusZone.stories.d.ts +0 -12
- package/lib/stories/useFocusZone.stories.js +0 -599
- package/lib-esm/__tests__/ActionList.d.ts +0 -1
- package/lib-esm/__tests__/ActionList.js +0 -54
- package/lib-esm/__tests__/ActionMenu.d.ts +0 -1
- package/lib-esm/__tests__/ActionMenu.js +0 -141
- package/lib-esm/__tests__/AnchoredOverlay.d.ts +0 -1
- package/lib-esm/__tests__/AnchoredOverlay.js +0 -135
- package/lib-esm/__tests__/Avatar.d.ts +0 -1
- package/lib-esm/__tests__/Avatar.js +0 -58
- package/lib-esm/__tests__/AvatarStack.d.ts +0 -1
- package/lib-esm/__tests__/AvatarStack.js +0 -57
- package/lib-esm/__tests__/BorderBox.d.ts +0 -1
- package/lib-esm/__tests__/BorderBox.js +0 -49
- package/lib-esm/__tests__/Box.d.ts +0 -1
- package/lib-esm/__tests__/Box.js +0 -69
- package/lib-esm/__tests__/BranchName.d.ts +0 -1
- package/lib-esm/__tests__/BranchName.js +0 -28
- package/lib-esm/__tests__/Breadcrumb.d.ts +0 -1
- package/lib-esm/__tests__/Breadcrumb.js +0 -31
- package/lib-esm/__tests__/BreadcrumbItem.d.ts +0 -1
- package/lib-esm/__tests__/BreadcrumbItem.js +0 -41
- package/lib-esm/__tests__/Button.d.ts +0 -1
- package/lib-esm/__tests__/Button.js +0 -141
- package/lib-esm/__tests__/Caret.d.ts +0 -1
- package/lib-esm/__tests__/Caret.js +0 -42
- package/lib-esm/__tests__/CircleBadge.d.ts +0 -1
- package/lib-esm/__tests__/CircleBadge.js +0 -73
- package/lib-esm/__tests__/CircleOcticon.d.ts +0 -1
- package/lib-esm/__tests__/CircleOcticon.js +0 -61
- package/lib-esm/__tests__/CounterLabel.d.ts +0 -1
- package/lib-esm/__tests__/CounterLabel.js +0 -49
- package/lib-esm/__tests__/Details.d.ts +0 -1
- package/lib-esm/__tests__/Details.js +0 -109
- package/lib-esm/__tests__/Dialog.d.ts +0 -1
- package/lib-esm/__tests__/Dialog.js +0 -174
- package/lib-esm/__tests__/Dropdown.d.ts +0 -1
- package/lib-esm/__tests__/Dropdown.js +0 -59
- package/lib-esm/__tests__/DropdownMenu.d.ts +0 -1
- package/lib-esm/__tests__/DropdownMenu.js +0 -139
- package/lib-esm/__tests__/FilterList.d.ts +0 -1
- package/lib-esm/__tests__/FilterList.js +0 -28
- package/lib-esm/__tests__/FilterListItem.d.ts +0 -1
- package/lib-esm/__tests__/FilterListItem.js +0 -38
- package/lib-esm/__tests__/FilteredSearch.d.ts +0 -1
- package/lib-esm/__tests__/FilteredSearch.js +0 -28
- package/lib-esm/__tests__/Flash.d.ts +0 -1
- package/lib-esm/__tests__/Flash.js +0 -53
- package/lib-esm/__tests__/Flex.d.ts +0 -1
- package/lib-esm/__tests__/Flex.js +0 -66
- package/lib-esm/__tests__/FormGroup.d.ts +0 -1
- package/lib-esm/__tests__/FormGroup.js +0 -47
- package/lib-esm/__tests__/Grid.d.ts +0 -1
- package/lib-esm/__tests__/Grid.js +0 -96
- package/lib-esm/__tests__/Header.d.ts +0 -1
- package/lib-esm/__tests__/Header.js +0 -52
- package/lib-esm/__tests__/Heading.d.ts +0 -1
- package/lib-esm/__tests__/Heading.js +0 -101
- package/lib-esm/__tests__/Label.d.ts +0 -1
- package/lib-esm/__tests__/Label.js +0 -38
- package/lib-esm/__tests__/LabelGroup.d.ts +0 -1
- package/lib-esm/__tests__/LabelGroup.js +0 -28
- package/lib-esm/__tests__/Link.d.ts +0 -1
- package/lib-esm/__tests__/Link.js +0 -62
- package/lib-esm/__tests__/Overlay.d.ts +0 -1
- package/lib-esm/__tests__/Overlay.js +0 -123
- package/lib-esm/__tests__/Pagehead.d.ts +0 -1
- package/lib-esm/__tests__/Pagehead.js +0 -28
- package/lib-esm/__tests__/Pagination/Pagination.d.ts +0 -1
- package/lib-esm/__tests__/Pagination/Pagination.js +0 -37
- package/lib-esm/__tests__/Pagination/PaginationModel.d.ts +0 -1
- package/lib-esm/__tests__/Pagination/PaginationModel.js +0 -182
- package/lib-esm/__tests__/PointerBox.d.ts +0 -1
- package/lib-esm/__tests__/PointerBox.js +0 -38
- package/lib-esm/__tests__/Popover.d.ts +0 -1
- package/lib-esm/__tests__/Popover.js +0 -56
- package/lib-esm/__tests__/Portal.d.ts +0 -1
- package/lib-esm/__tests__/Portal.js +0 -104
- package/lib-esm/__tests__/Position.d.ts +0 -1
- package/lib-esm/__tests__/Position.js +0 -138
- package/lib-esm/__tests__/ProgressBar.d.ts +0 -1
- package/lib-esm/__tests__/ProgressBar.js +0 -60
- package/lib-esm/__tests__/SelectMenu.d.ts +0 -1
- package/lib-esm/__tests__/SelectMenu.js +0 -145
- package/lib-esm/__tests__/SelectPanel.d.ts +0 -1
- package/lib-esm/__tests__/SelectPanel.js +0 -67
- package/lib-esm/__tests__/SideNav.d.ts +0 -1
- package/lib-esm/__tests__/SideNav.js +0 -63
- package/lib-esm/__tests__/Spinner.d.ts +0 -1
- package/lib-esm/__tests__/Spinner.js +0 -45
- package/lib-esm/__tests__/StateLabel.d.ts +0 -1
- package/lib-esm/__tests__/StateLabel.js +0 -63
- package/lib-esm/__tests__/StyledOcticon.d.ts +0 -1
- package/lib-esm/__tests__/StyledOcticon.js +0 -31
- package/lib-esm/__tests__/SubNav.d.ts +0 -1
- package/lib-esm/__tests__/SubNav.js +0 -52
- package/lib-esm/__tests__/SubNavLink.d.ts +0 -1
- package/lib-esm/__tests__/SubNavLink.js +0 -41
- package/lib-esm/__tests__/TabNav.d.ts +0 -1
- package/lib-esm/__tests__/TabNav.js +0 -42
- package/lib-esm/__tests__/Text.d.ts +0 -1
- package/lib-esm/__tests__/Text.js +0 -95
- package/lib-esm/__tests__/TextInput.d.ts +0 -1
- package/lib-esm/__tests__/TextInput.js +0 -70
- package/lib-esm/__tests__/ThemeProvider.d.ts +0 -1
- package/lib-esm/__tests__/ThemeProvider.js +0 -408
- package/lib-esm/__tests__/Timeline.d.ts +0 -1
- package/lib-esm/__tests__/Timeline.js +0 -69
- package/lib-esm/__tests__/Tooltip.d.ts +0 -1
- package/lib-esm/__tests__/Tooltip.js +0 -61
- package/lib-esm/__tests__/Truncate.d.ts +0 -1
- package/lib-esm/__tests__/Truncate.js +0 -55
- package/lib-esm/__tests__/UnderlineNav.d.ts +0 -1
- package/lib-esm/__tests__/UnderlineNav.js +0 -62
- package/lib-esm/__tests__/UnderlineNavLink.d.ts +0 -1
- package/lib-esm/__tests__/UnderlineNavLink.js +0 -43
- package/lib-esm/__tests__/behaviors/anchoredPosition.d.ts +0 -1
- package/lib-esm/__tests__/behaviors/anchoredPosition.js +0 -388
- package/lib-esm/__tests__/behaviors/focusTrap.d.ts +0 -1
- package/lib-esm/__tests__/behaviors/focusTrap.js +0 -227
- package/lib-esm/__tests__/behaviors/focusZone.d.ts +0 -1
- package/lib-esm/__tests__/behaviors/focusZone.js +0 -487
- package/lib-esm/__tests__/behaviors/iterateFocusableElements.d.ts +0 -1
- package/lib-esm/__tests__/behaviors/iterateFocusableElements.js +0 -48
- package/lib-esm/__tests__/filterObject.d.ts +0 -1
- package/lib-esm/__tests__/filterObject.js +0 -27
- package/lib-esm/__tests__/hooks/useAnchoredPosition.d.ts +0 -1
- package/lib-esm/__tests__/hooks/useAnchoredPosition.js +0 -46
- package/lib-esm/__tests__/hooks/useOnEscapePress.d.ts +0 -1
- package/lib-esm/__tests__/hooks/useOnEscapePress.js +0 -23
- package/lib-esm/__tests__/hooks/useOnOutsideClick.d.ts +0 -1
- package/lib-esm/__tests__/hooks/useOnOutsideClick.js +0 -68
- package/lib-esm/__tests__/hooks/useOpenAndCloseFocus.d.ts +0 -1
- package/lib-esm/__tests__/hooks/useOpenAndCloseFocus.js +0 -52
- package/lib-esm/__tests__/hooks/useProvidedStateOrCreate.d.ts +0 -1
- package/lib-esm/__tests__/hooks/useProvidedStateOrCreate.js +0 -36
- package/lib-esm/__tests__/theme.d.ts +0 -1
- package/lib-esm/__tests__/theme.js +0 -33
- package/lib-esm/__tests__/themeGet.d.ts +0 -1
- package/lib-esm/__tests__/themeGet.js +0 -22
- package/lib-esm/__tests__/useSafeTimeout.d.ts +0 -1
- package/lib-esm/__tests__/useSafeTimeout.js +0 -39
- package/lib-esm/stories/ActionList.stories.d.ts +0 -40
- package/lib-esm/stories/ActionList.stories.js +0 -334
- package/lib-esm/stories/ActionMenu.stories.d.ts +0 -29
- package/lib-esm/stories/ActionMenu.stories.js +0 -293
- package/lib-esm/stories/AnchoredOverlay.stories.d.ts +0 -6
- package/lib-esm/stories/AnchoredOverlay.stories.js +0 -101
- package/lib-esm/stories/AvatarStack.stories.d.ts +0 -8
- package/lib-esm/stories/AvatarStack.stories.js +0 -32
- package/lib-esm/stories/Button.stories.d.ts +0 -57
- package/lib-esm/stories/Button.stories.js +0 -78
- package/lib-esm/stories/ConfirmationDialog.stories.d.ts +0 -7
- package/lib-esm/stories/ConfirmationDialog.stories.js +0 -86
- package/lib-esm/stories/Dialog.stories.d.ts +0 -13
- package/lib-esm/stories/Dialog.stories.js +0 -240
- package/lib-esm/stories/DropdownMenu.stories.d.ts +0 -12
- package/lib-esm/stories/DropdownMenu.stories.js +0 -94
- package/lib-esm/stories/Overlay.stories.d.ts +0 -7
- package/lib-esm/stories/Overlay.stories.js +0 -154
- package/lib-esm/stories/Portal.stories.d.ts +0 -8
- package/lib-esm/stories/Portal.stories.js +0 -68
- package/lib-esm/stories/SelectPanel.stories.d.ts +0 -32
- package/lib-esm/stories/SelectPanel.stories.js +0 -284
- package/lib-esm/stories/ThemeProvider.stories.d.ts +0 -6
- package/lib-esm/stories/ThemeProvider.stories.js +0 -83
- package/lib-esm/stories/useAnchoredPosition.stories.d.ts +0 -8
- package/lib-esm/stories/useAnchoredPosition.stories.js +0 -313
- package/lib-esm/stories/useFocusTrap.stories.d.ts +0 -9
- package/lib-esm/stories/useFocusTrap.stories.js +0 -309
- package/lib-esm/stories/useFocusZone.stories.d.ts +0 -12
- package/lib-esm/stories/useFocusZone.stories.js +0 -554
- package/migrating.md +0 -250
- package/now.json +0 -17
- package/package-lock.json +0 -28661
- package/rollup.config.js +0 -36
- package/script/build +0 -19
- package/script/setup +0 -12
- package/src/ActionList/Divider.tsx +0 -25
- package/src/ActionList/Group.tsx +0 -45
- package/src/ActionList/Header.tsx +0 -74
- package/src/ActionList/Item.tsx +0 -460
- package/src/ActionList/List.tsx +0 -253
- package/src/ActionList/index.ts +0 -21
- package/src/ActionMenu.tsx +0 -106
- package/src/AnchoredOverlay/AnchoredOverlay.tsx +0 -180
- package/src/AnchoredOverlay/index.ts +0 -2
- package/src/Avatar.tsx +0 -46
- package/src/AvatarPair.tsx +0 -35
- package/src/AvatarStack.tsx +0 -161
- package/src/BaseStyles.tsx +0 -53
- package/src/BorderBox.tsx +0 -18
- package/src/Box.tsx +0 -54
- package/src/BranchName.tsx +0 -19
- package/src/Breadcrumb.tsx +0 -87
- package/src/Button/Button.tsx +0 -40
- package/src/Button/ButtonBase.tsx +0 -43
- package/src/Button/ButtonClose.tsx +0 -40
- package/src/Button/ButtonDanger.tsx +0 -43
- package/src/Button/ButtonGroup.tsx +0 -55
- package/src/Button/ButtonInvisible.tsx +0 -27
- package/src/Button/ButtonOutline.tsx +0 -43
- package/src/Button/ButtonPrimary.tsx +0 -41
- package/src/Button/ButtonStyles.tsx +0 -36
- package/src/Button/ButtonTableList.tsx +0 -58
- package/src/Button/index.ts +0 -16
- package/src/Caret.tsx +0 -133
- package/src/CircleBadge.tsx +0 -55
- package/src/CircleOcticon.tsx +0 -37
- package/src/CounterLabel.tsx +0 -52
- package/src/Details.tsx +0 -23
- package/src/Dialog/ConfirmationDialog.tsx +0 -184
- package/src/Dialog/Dialog.tsx +0 -419
- package/src/Dialog.tsx +0 -149
- package/src/Dropdown.tsx +0 -158
- package/src/DropdownMenu/DropdownButton.tsx +0 -15
- package/src/DropdownMenu/DropdownMenu.tsx +0 -115
- package/src/DropdownMenu/index.ts +0 -4
- package/src/DropdownStyles.ts +0 -128
- package/src/FilterList.tsx +0 -81
- package/src/FilteredActionList/FilteredActionList.tsx +0 -152
- package/src/FilteredActionList/index.ts +0 -2
- package/src/FilteredSearch.tsx +0 -28
- package/src/Flash.tsx +0 -77
- package/src/Flex.tsx +0 -15
- package/src/FormGroup.tsx +0 -27
- package/src/Grid.tsx +0 -15
- package/src/Header.tsx +0 -84
- package/src/Heading.tsx +0 -21
- package/src/Label.tsx +0 -75
- package/src/LabelGroup.tsx +0 -18
- package/src/Link.tsx +0 -46
- package/src/Overlay.tsx +0 -194
- package/src/Pagehead.tsx +0 -17
- package/src/Pagination/Pagination.tsx +0 -214
- package/src/Pagination/index.ts +0 -4
- package/src/Pagination/model.tsx +0 -187
- package/src/PointerBox.tsx +0 -31
- package/src/Popover.tsx +0 -236
- package/src/Portal/Portal.tsx +0 -96
- package/src/Portal/index.ts +0 -5
- package/src/Position.tsx +0 -63
- package/src/ProgressBar.tsx +0 -52
- package/src/SelectMenu/SelectMenu.tsx +0 -125
- package/src/SelectMenu/SelectMenuContext.tsx +0 -9
- package/src/SelectMenu/SelectMenuDivider.tsx +0 -25
- package/src/SelectMenu/SelectMenuFilter.tsx +0 -51
- package/src/SelectMenu/SelectMenuFooter.tsx +0 -28
- package/src/SelectMenu/SelectMenuHeader.tsx +0 -50
- package/src/SelectMenu/SelectMenuItem.tsx +0 -137
- package/src/SelectMenu/SelectMenuList.tsx +0 -42
- package/src/SelectMenu/SelectMenuLoadingAnimation.tsx +0 -24
- package/src/SelectMenu/SelectMenuModal.tsx +0 -121
- package/src/SelectMenu/SelectMenuTab.tsx +0 -88
- package/src/SelectMenu/SelectMenuTabPanel.tsx +0 -30
- package/src/SelectMenu/SelectMenuTabs.tsx +0 -44
- package/src/SelectMenu/hooks/useKeyboardNav.js +0 -90
- package/src/SelectMenu/index.ts +0 -15
- package/src/SelectPanel/SelectPanel.tsx +0 -173
- package/src/SelectPanel/index.ts +0 -2
- package/src/SideNav.tsx +0 -193
- package/src/Spinner.tsx +0 -59
- package/src/StateLabel.tsx +0 -110
- package/src/StyledOcticon.tsx +0 -24
- package/src/SubNav.tsx +0 -129
- package/src/TabNav.tsx +0 -77
- package/src/Text.tsx +0 -13
- package/src/TextInput.tsx +0 -183
- package/src/ThemeProvider.tsx +0 -176
- package/src/Timeline.tsx +0 -141
- package/src/Tooltip.tsx +0 -263
- package/src/Truncate.tsx +0 -36
- package/src/UnderlineNav.tsx +0 -110
- package/src/__tests__/.eslintrc.json +0 -11
- package/src/__tests__/ActionList.tsx +0 -49
- package/src/__tests__/ActionMenu.tsx +0 -138
- package/src/__tests__/AnchoredOverlay.tsx +0 -151
- package/src/__tests__/Avatar.tsx +0 -45
- package/src/__tests__/AvatarStack.tsx +0 -45
- package/src/__tests__/BorderBox.tsx +0 -44
- package/src/__tests__/Box.tsx +0 -43
- package/src/__tests__/BranchName.tsx +0 -27
- package/src/__tests__/Breadcrumb.tsx +0 -31
- package/src/__tests__/BreadcrumbItem.tsx +0 -32
- package/src/__tests__/Button.tsx +0 -129
- package/src/__tests__/Caret.tsx +0 -36
- package/src/__tests__/CircleBadge.tsx +0 -69
- package/src/__tests__/CircleOcticon.tsx +0 -52
- package/src/__tests__/CounterLabel.tsx +0 -51
- package/src/__tests__/Details.tsx +0 -116
- package/src/__tests__/Dialog.tsx +0 -157
- package/src/__tests__/Dropdown.tsx +0 -57
- package/src/__tests__/DropdownMenu.tsx +0 -138
- package/src/__tests__/FilterList.tsx +0 -27
- package/src/__tests__/FilterListItem.tsx +0 -32
- package/src/__tests__/FilteredSearch.tsx +0 -27
- package/src/__tests__/Flash.tsx +0 -46
- package/src/__tests__/Flex.tsx +0 -59
- package/src/__tests__/FormGroup.tsx +0 -39
- package/src/__tests__/Grid.tsx +0 -83
- package/src/__tests__/Header.tsx +0 -50
- package/src/__tests__/Heading.tsx +0 -92
- package/src/__tests__/Label.tsx +0 -35
- package/src/__tests__/LabelGroup.tsx +0 -31
- package/src/__tests__/Link.tsx +0 -48
- package/src/__tests__/Overlay.tsx +0 -103
- package/src/__tests__/Pagehead.tsx +0 -24
- package/src/__tests__/Pagination/Pagination.tsx +0 -31
- package/src/__tests__/Pagination/PaginationModel.tsx +0 -133
- package/src/__tests__/Pagination/__snapshots__/Pagination.tsx.snap +0 -184
- package/src/__tests__/PointerBox.tsx +0 -35
- package/src/__tests__/Popover.tsx +0 -69
- package/src/__tests__/Portal.tsx +0 -103
- package/src/__tests__/Position.tsx +0 -118
- package/src/__tests__/ProgressBar.tsx +0 -41
- package/src/__tests__/SelectMenu.tsx +0 -142
- package/src/__tests__/SelectPanel.tsx +0 -65
- package/src/__tests__/SideNav.tsx +0 -63
- package/src/__tests__/Spinner.tsx +0 -44
- package/src/__tests__/StateLabel.tsx +0 -50
- package/src/__tests__/StyledOcticon.tsx +0 -28
- package/src/__tests__/SubNav.tsx +0 -51
- package/src/__tests__/SubNavLink.tsx +0 -32
- package/src/__tests__/TabNav.tsx +0 -33
- package/src/__tests__/Text.tsx +0 -79
- package/src/__tests__/TextInput.tsx +0 -50
- package/src/__tests__/ThemeProvider.tsx +0 -441
- package/src/__tests__/Timeline.tsx +0 -59
- package/src/__tests__/Tooltip.tsx +0 -53
- package/src/__tests__/Truncate.tsx +0 -45
- package/src/__tests__/UnderlineNav.tsx +0 -59
- package/src/__tests__/UnderlineNavLink.tsx +0 -32
- package/src/__tests__/__snapshots__/ActionList.tsx.snap +0 -27
- package/src/__tests__/__snapshots__/ActionMenu.tsx.snap +0 -80
- package/src/__tests__/__snapshots__/AnchoredOverlay.tsx.snap +0 -332
- package/src/__tests__/__snapshots__/Avatar.tsx.snap +0 -19
- package/src/__tests__/__snapshots__/AvatarStack.tsx.snap +0 -377
- package/src/__tests__/__snapshots__/BorderBox.tsx.snap +0 -14
- package/src/__tests__/__snapshots__/Box.tsx.snap +0 -201
- package/src/__tests__/__snapshots__/BranchName.tsx.snap +0 -17
- package/src/__tests__/__snapshots__/Breadcrumb.tsx.snap +0 -29
- package/src/__tests__/__snapshots__/BreadcrumbItem.tsx.snap +0 -79
- package/src/__tests__/__snapshots__/Button.tsx.snap +0 -832
- package/src/__tests__/__snapshots__/Caret.tsx.snap +0 -373
- package/src/__tests__/__snapshots__/CircleBadge.tsx.snap +0 -141
- package/src/__tests__/__snapshots__/CircleOcticon.tsx.snap +0 -64
- package/src/__tests__/__snapshots__/CounterLabel.tsx.snap +0 -22
- package/src/__tests__/__snapshots__/Details.tsx.snap +0 -15
- package/src/__tests__/__snapshots__/Dialog.tsx.snap +0 -200
- package/src/__tests__/__snapshots__/Dropdown.tsx.snap +0 -249
- package/src/__tests__/__snapshots__/DropdownMenu.tsx.snap +0 -106
- package/src/__tests__/__snapshots__/FilterList.tsx.snap +0 -13
- package/src/__tests__/__snapshots__/FilterListItem.tsx.snap +0 -80
- package/src/__tests__/__snapshots__/FilteredSearch.tsx.snap +0 -32
- package/src/__tests__/__snapshots__/Flash.tsx.snap +0 -32
- package/src/__tests__/__snapshots__/Flex.tsx.snap +0 -130
- package/src/__tests__/__snapshots__/FormGroup.tsx.snap +0 -25
- package/src/__tests__/__snapshots__/Grid.tsx.snap +0 -178
- package/src/__tests__/__snapshots__/Header.tsx.snap +0 -79
- package/src/__tests__/__snapshots__/Heading.tsx.snap +0 -13
- package/src/__tests__/__snapshots__/Label.tsx.snap +0 -74
- package/src/__tests__/__snapshots__/LabelGroup.tsx.snap +0 -15
- package/src/__tests__/__snapshots__/Link.tsx.snap +0 -213
- package/src/__tests__/__snapshots__/Pagehead.tsx.snap +0 -15
- package/src/__tests__/__snapshots__/PointerBox.tsx.snap +0 -174
- package/src/__tests__/__snapshots__/Popover.tsx.snap +0 -4687
- package/src/__tests__/__snapshots__/Position.tsx.snap +0 -44
- package/src/__tests__/__snapshots__/ProgressBar.tsx.snap +0 -53
- package/src/__tests__/__snapshots__/SelectMenu.tsx.snap +0 -469
- package/src/__tests__/__snapshots__/SelectPanel.tsx.snap +0 -123
- package/src/__tests__/__snapshots__/SideNav.tsx.snap +0 -143
- package/src/__tests__/__snapshots__/Spinner.tsx.snap +0 -33
- package/src/__tests__/__snapshots__/StateLabel.tsx.snap +0 -409
- package/src/__tests__/__snapshots__/StyledOcticon.tsx.snap +0 -25
- package/src/__tests__/__snapshots__/SubNav.tsx.snap +0 -44
- package/src/__tests__/__snapshots__/SubNavLink.tsx.snap +0 -199
- package/src/__tests__/__snapshots__/TabNav.tsx.snap +0 -58
- package/src/__tests__/__snapshots__/Text.tsx.snap +0 -7
- package/src/__tests__/__snapshots__/TextInput.tsx.snap +0 -440
- package/src/__tests__/__snapshots__/ThemeProvider.tsx.snap +0 -15
- package/src/__tests__/__snapshots__/Timeline.tsx.snap +0 -159
- package/src/__tests__/__snapshots__/Tooltip.tsx.snap +0 -227
- package/src/__tests__/__snapshots__/Truncate.tsx.snap +0 -17
- package/src/__tests__/__snapshots__/UnderlineNav.tsx.snap +0 -59
- package/src/__tests__/__snapshots__/UnderlineNavLink.tsx.snap +0 -130
- package/src/__tests__/behaviors/anchoredPosition.ts +0 -295
- package/src/__tests__/behaviors/focusTrap.tsx +0 -236
- package/src/__tests__/behaviors/focusZone.tsx +0 -549
- package/src/__tests__/behaviors/iterateFocusableElements.tsx +0 -61
- package/src/__tests__/filterObject.ts +0 -54
- package/src/__tests__/hooks/useAnchoredPosition.tsx +0 -31
- package/src/__tests__/hooks/useOnEscapePress.tsx +0 -16
- package/src/__tests__/hooks/useOnOutsideClick.tsx +0 -48
- package/src/__tests__/hooks/useOpenAndCloseFocus.tsx +0 -48
- package/src/__tests__/hooks/useProvidedStateOrCreate.tsx +0 -39
- package/src/__tests__/theme.ts +0 -41
- package/src/__tests__/themeGet.ts +0 -15
- package/src/__tests__/useSafeTimeout.tsx +0 -36
- package/src/behaviors/anchoredPosition.ts +0 -442
- package/src/behaviors/focusTrap.ts +0 -184
- package/src/behaviors/focusZone.ts +0 -713
- package/src/constants.ts +0 -62
- package/src/hooks/index.ts +0 -11
- package/src/hooks/useAnchoredPosition.ts +0 -53
- package/src/hooks/useCombinedRefs.ts +0 -40
- package/src/hooks/useDetails.tsx +0 -54
- package/src/hooks/useDialog.ts +0 -121
- package/src/hooks/useFocusTrap.ts +0 -80
- package/src/hooks/useFocusZone.ts +0 -64
- package/src/hooks/useOnEscapePress.ts +0 -63
- package/src/hooks/useOnOutsideClick.tsx +0 -82
- package/src/hooks/useOpenAndCloseFocus.ts +0 -27
- package/src/hooks/useOverlay.tsx +0 -32
- package/src/hooks/useProvidedRefOrCreate.ts +0 -14
- package/src/hooks/useProvidedStateOrCreate.ts +0 -27
- package/src/hooks/useRenderForcingRef.ts +0 -22
- package/src/hooks/useResizeObserver.ts +0 -11
- package/src/hooks/useSafeTimeout.ts +0 -38
- package/src/hooks/useScrollFlash.ts +0 -21
- package/src/index.ts +0 -165
- package/src/polyfills/eventListenerSignal.ts +0 -66
- package/src/stories/ActionList.stories.tsx +0 -364
- package/src/stories/ActionMenu.stories.tsx +0 -322
- package/src/stories/AnchoredOverlay.stories.tsx +0 -117
- package/src/stories/AvatarStack.stories.tsx +0 -37
- package/src/stories/Button.stories.tsx +0 -88
- package/src/stories/ConfirmationDialog.stories.tsx +0 -105
- package/src/stories/Dialog.stories.tsx +0 -240
- package/src/stories/DropdownMenu.stories.tsx +0 -84
- package/src/stories/Overlay.stories.tsx +0 -186
- package/src/stories/Portal.stories.tsx +0 -109
- package/src/stories/SelectPanel.stories.tsx +0 -300
- package/src/stories/ThemeProvider.stories.tsx +0 -104
- package/src/stories/useAnchoredPosition.stories.tsx +0 -320
- package/src/stories/useFocusTrap.stories.tsx +0 -400
- package/src/stories/useFocusZone.stories.tsx +0 -663
- package/src/sx.ts +0 -9
- package/src/theme-preval.js +0 -136
- package/src/theme.ts +0 -3
- package/src/utils/deprecate.tsx +0 -73
- package/src/utils/isNumeric.tsx +0 -4
- package/src/utils/iterateFocusableElements.ts +0 -121
- package/src/utils/ssr.tsx +0 -1
- package/src/utils/test-deprecations.tsx +0 -19
- package/src/utils/test-helpers.tsx +0 -7
- package/src/utils/test-matchers.tsx +0 -109
- package/src/utils/testing.tsx +0 -243
- package/src/utils/theme.js +0 -64
- package/src/utils/types.ts +0 -90
- package/src/utils/uniqueId.ts +0 -6
- package/src/utils/userAgent.ts +0 -7
- package/stats.html +0 -3279
- package/tsconfig.json +0 -20
package/migrating.md
DELETED
@@ -1,250 +0,0 @@
|
|
1
|
-
# Migration guide
|
2
|
-
|
3
|
-
## `4.0.0-beta`
|
4
|
-
|
5
|
-
[The 4.0.0-beta release](https://github.com/primer/react/releases/v4.0.0-beta) renames some components:
|
6
|
-
|
7
|
-
- `FlexContainer` is now named `Flex`
|
8
|
-
- `FlexItem` is now `Flex.Item`
|
9
|
-
- `UnderlineNavItem` is now `UnderlineNav.Item`
|
10
|
-
- `FilterListItem` is now `FilterList.Item`
|
11
|
-
|
12
|
-
There is a [codemod](#codemods) available to upgrade component identifiers from [v3.x.x-beta](#3-0-0-beta):
|
13
|
-
|
14
|
-
```js
|
15
|
-
npx jscodeshift -t node_modules/@primer/components/codemods/v4.js path/to/src
|
16
|
-
```
|
17
|
-
|
18
|
-
The following breaking changes must be accounted for manually:
|
19
|
-
|
20
|
-
- `Label` no longer has a `scheme` prop, but now respects `size` and `dropshadow` props.
|
21
|
-
- `StateLabel` **does** have a `scheme` prop (instead of `state`), and takes different values.
|
22
|
-
|
23
|
-
## `3.0.0-beta`
|
24
|
-
|
25
|
-
**:rotating_light: As of v3, the name of the package has changed from `primer-react` to `@primer/components`.**
|
26
|
-
|
27
|
-
[The 3.0.0-beta release](https://github.com/primer/react/releases/v3.0.0-beta) contains the following breaking changes:
|
28
|
-
|
29
|
-
- The `MergeStatus` component is gone. Use a `StateLabel` instead.
|
30
|
-
- The `Link` component no longer accepts `scheme` or `muted` props, and has no underline by default.
|
31
|
-
- `DonutChart` is now simply `Donut`, and `DonutSlice` is `Donut.Slice`.
|
32
|
-
|
33
|
-
There is a [codemod](#codemods) available to upgrade from [2.x.x-beta](#2-0-0-beta) and updating the package name:
|
34
|
-
|
35
|
-
```js
|
36
|
-
npx jscodeshift -t node_modules/@primer/components/codemods/v3.js path/to/src
|
37
|
-
```
|
38
|
-
|
39
|
-
## `2.0.0-beta`
|
40
|
-
|
41
|
-
[The 2.0.0-beta release](https://github.com/primer/react/releases/v2.0.0-beta) is a major version bump because it renames several components:
|
42
|
-
|
43
|
-
- `Box` is now `BorderBox`
|
44
|
-
- `Block` is now `Box`
|
45
|
-
- `CaretBox` is now `PointerBox`
|
46
|
-
|
47
|
-
We suggest that you rename your components in the above order, since renaming `Block` to `Box` before renaming the old `Box` component to `BorderBox` will cause problems.
|
48
|
-
|
49
|
-
There is a [codemod](#codemods) available to upgrade from [1.x.x-beta](#1-0-0-beta):
|
50
|
-
|
51
|
-
```js
|
52
|
-
npx jscodeshift -t node_modules/primer-react/codemods/v2.js path/to/src
|
53
|
-
```
|
54
|
-
|
55
|
-
## `1.0.0-beta`
|
56
|
-
|
57
|
-
[This release](https://github.com/primer/react/releases/v1.0.0-beta) is a major version bump because it completely refactors the guts of all our components. Here's what you need to know:
|
58
|
-
|
59
|
-
There is a [codemod](#codemods) available to upgrade from previous versions `0.x.x-beta`:
|
60
|
-
|
61
|
-
```js
|
62
|
-
npx jscodeshift -t node_modules/primer-react/codemods/v1.js path/to/src
|
63
|
-
```
|
64
|
-
|
65
|
-
### Emotion and styled-system
|
66
|
-
|
67
|
-
The big change in this release is the introduction of [emotion] and [styled-system] under the hood to speed up our migration from Primer CSS to complete style encapsulation in React. For now, you will need to continue serving up [Primer CSS] to support components that haven't yet been migrated to the new styling system. See [the README](README.md#styling) for more information.
|
68
|
-
|
69
|
-
This release also introduces early support for [theming](#theming).
|
70
|
-
|
71
|
-
### Props changes
|
72
|
-
|
73
|
-
- The `tag` prop has been renamed to `is` to match [styled-system] conventions.
|
74
|
-
|
75
|
-
- Color props will require refactoring:
|
76
|
-
|
77
|
-
- The `fg` prop has been renamed to `color` across the board.
|
78
|
-
|
79
|
-
- Color prop (`bg`, `color`, and `borderColor`) values are now object paths that represent nested fields in the `colors` object of our [default theme]. Because all of our [color gradations] are expressed as arrays, the `gray`, `blue`, `green`, `orange`, `purple`, `red`, and `yellow` values need to be updated to include the `.5` suffix so that they receive the value closest to the middle of each hue gradation (`red.5` maps to `theme.colors.red[5]`).
|
80
|
-
|
81
|
-
In other words, `color="red"` becomes `color="red.5"`, `bg="purple"` becomes `bg="purple.5"`, and so on. See [the full list of changes](#color-props) below.
|
82
|
-
|
83
|
-
- [Some typography props](#typography-props) will require refactoring.
|
84
|
-
|
85
|
-
- [Some `Block` props](#block-props) have changed.
|
86
|
-
|
87
|
-
- [Some `FlexContainer` and `FlexItem` props](#flex-props) have changed.
|
88
|
-
|
89
|
-
### Theming
|
90
|
-
|
91
|
-
Theming is an optional way to override the values that control color, spacing, typography, and other aspects of our components.
|
92
|
-
|
93
|
-
There are two ways to change the theme of @primer/components components:
|
94
|
-
|
95
|
-
1. You can override the theme for an entire tree of components using the `<ThemeProvider>` from [emotion-theming]:
|
96
|
-
|
97
|
-
```jsx
|
98
|
-
import {Block, Button, Text, theme as primer} from '@primer/components'
|
99
|
-
import {ThemeProvider} from 'emotion-theming'
|
100
|
-
|
101
|
-
// a theme with custom spacing and font sizes
|
102
|
-
const theme = {
|
103
|
-
...primer,
|
104
|
-
space: [0, 8, 16, 32, 64],
|
105
|
-
fontSizes: [10, 12, 16, 24, 48]
|
106
|
-
}
|
107
|
-
|
108
|
-
// override
|
109
|
-
theme.colors.bodytext = '#111'
|
110
|
-
|
111
|
-
export default () => (
|
112
|
-
<ThemeProvider theme={theme}>
|
113
|
-
<Block color="bodytext" p={4}>
|
114
|
-
<Text fontSize={4}>Hello, world!</Text>
|
115
|
-
</Block>
|
116
|
-
</ThemeProvider>
|
117
|
-
)
|
118
|
-
```
|
119
|
-
|
120
|
-
**⚠️ Note: [emotion-theming]'s `<ThemeProvider>` only allows exactly one child.**
|
121
|
-
|
122
|
-
1. You can theme individual components by passing the `theme` prop directly:
|
123
|
-
|
124
|
-
```jsx
|
125
|
-
import {Text} from '@primer/components'
|
126
|
-
|
127
|
-
const theme = {
|
128
|
-
colors: {
|
129
|
-
magenta: '#f0f'
|
130
|
-
}
|
131
|
-
}
|
132
|
-
|
133
|
-
export default () => (
|
134
|
-
<Text theme={theme} color="magenta">
|
135
|
-
Hi, I'm magenta!
|
136
|
-
</Text>
|
137
|
-
)
|
138
|
-
```
|
139
|
-
|
140
|
-
**☝️ This is an intentionally convoluted example, since you can use `<Text color='#f0f'>` out of the box.**
|
141
|
-
|
142
|
-
Read the [styled-system docs](http://jxnblk.com/styled-system/getting-started#theming) for more information on theming in styled-system.
|
143
|
-
|
144
|
-
### Color props
|
145
|
-
|
146
|
-
The following table lists color prop values that have changed in `1.0.0-beta`:
|
147
|
-
|
148
|
-
| Prop | Before | After | Notes |
|
149
|
-
| :------------ | :------------- | :------------ | :--------------- |
|
150
|
-
| `bg` | `blue-light` | `blue.0` |
|
151
|
-
| `bg` | `blue` | `blue.5` |
|
152
|
-
| `bg` | `gray-dark` | `gray.9` |
|
153
|
-
| `bg` | `gray-light` | `gray.0` |
|
154
|
-
| `bg` | `gray` | `gray.1` |
|
155
|
-
| `bg` | `green-light` | `green.1` |
|
156
|
-
| `bg` | `green` | `green.5` |
|
157
|
-
| `bg` | `orange` | `orange.7` |
|
158
|
-
| `bg` | `purple-light` | `purple.0` |
|
159
|
-
| `bg` | `purple` | `purple.5` |
|
160
|
-
| `bg` | `red-light` | `red.1` |
|
161
|
-
| `bg` | `red` | `red.5` |
|
162
|
-
| `bg` | `yellow-light` | `yellow.2` |
|
163
|
-
| `bg` | `yellow` | `yellow.5` |
|
164
|
-
| `borderColor` | `black-fade` | `blackfade15` |
|
165
|
-
| `borderColor` | `blue-light` | `blue.2` |
|
166
|
-
| `borderColor` | `blue` | `blue.5` |
|
167
|
-
| `borderColor` | `gray-dark` | `gray.3` |
|
168
|
-
| `borderColor` | `gray-darker` | `gray.7` |
|
169
|
-
| `borderColor` | `gray-light` | `#eaecef` | Not yet migrated |
|
170
|
-
| `borderColor` | `gray` | `gray.2` |
|
171
|
-
| `borderColor` | `green-light` | `#a2cbac` | Not yet migrated |
|
172
|
-
| `borderColor` | `green` | `green.4` |
|
173
|
-
| `borderColor` | `purple` | `purple.5` |
|
174
|
-
| `borderColor` | `red-light` | `#cea0a5` | Not yet migrated |
|
175
|
-
| `borderColor` | `yellow` | `#d9d0a5` | Not yet migrated |
|
176
|
-
| `color` | `blue` | `blue.5` |
|
177
|
-
| `color` | `gray-dark` | `gray.9` |
|
178
|
-
| `color` | `gray-light` | `gray.5` |
|
179
|
-
| `color` | `gray` | `gray.6` |
|
180
|
-
| `color` | `green` | `green.5` |
|
181
|
-
| `color` | `orange-light` | `orange.6` |
|
182
|
-
| `color` | `orange` | `orange.9` |
|
183
|
-
| `color` | `purple` | `purple.5` |
|
184
|
-
| `color` | `red` | `red.6` |
|
185
|
-
|
186
|
-
Remember that all `fg` props must be renamed to `color`.
|
187
|
-
|
188
|
-
### Typography props
|
189
|
-
|
190
|
-
- Typography props are still only available on the `Text` and `Heading` components.
|
191
|
-
|
192
|
-
- The `fontSize` prop works as before, but now treats any value that doesn't represent an index of `theme.fontSizes` as a literal CSS value.
|
193
|
-
|
194
|
-
- The `lineHeight` prop now accepts one of the keys from `theme.lineHeights`: `default`, `condensed`, or `condensedUltra`. Any other value will be passed along as a literal CSS value.
|
195
|
-
|
196
|
-
The following table lists typography-related prop substitutions:
|
197
|
-
|
198
|
-
| Prop | Value(s) | Substitute |
|
199
|
-
| :----------- | :---------------- | :---------------------------- |
|
200
|
-
| `lineHeight` | `condensed-ultra` | `lineHeight="condensedUltra"` |
|
201
|
-
| `mono` | (boolean) | `fontFamily="mono"` |
|
202
|
-
| `nowrap` | (boolean) | `css="white-space: nowrap"` |
|
203
|
-
|
204
|
-
### `Block` props
|
205
|
-
|
206
|
-
The `Block` component supports most of the same props, but the following ones will need to be refactored:
|
207
|
-
|
208
|
-
| Prop | Value(s) | Substitute |
|
209
|
-
| :------- | :--------- | :------------------ |
|
210
|
-
| `border` | `true` | `border={1}` |
|
211
|
-
| `border` | `'bottom'` | `borderBottom={1}` |
|
212
|
-
| `border` | `'left'` | `borderLeft={1}` |
|
213
|
-
| `border` | `'right'` | `borderRight={1}` |
|
214
|
-
| `border` | `'top'` | `borderTop={1}` |
|
215
|
-
| `shadow` | _all_ | `boxShadow="value"` |
|
216
|
-
|
217
|
-
Note: array values in border props represent [responsive values].
|
218
|
-
|
219
|
-
### Flex props
|
220
|
-
|
221
|
-
The `FlexContainer` and `FlexItem` components have changed significantly in this version. The following props have been renamed or deprecated:
|
222
|
-
|
223
|
-
#### `FlexContainer`
|
224
|
-
|
225
|
-
| Prop | Value(s) | Substitute |
|
226
|
-
| :---------- | :--------------- | :-------------------------- |
|
227
|
-
| `direction` | _all_ | `flexDirection="css-value"` |
|
228
|
-
| `wrap` | `wrap`, `nowrap` | `flexWrap="css-value"` |
|
229
|
-
| `inline` | (boolean) | `display="inline-flex"` |
|
230
|
-
|
231
|
-
#### `FlexItem`
|
232
|
-
|
233
|
-
| Prop | Value(s) | Substitute |
|
234
|
-
| :--------- | :-------- | :------------------ |
|
235
|
-
| `flexAuto` | (boolean) | No longer supported |
|
236
|
-
|
237
|
-
## Codemods
|
238
|
-
|
239
|
-
[Codemods](https://www.sitepoint.com/getting-started-with-codemods/) are scripted transformations that you can run on your code to relieve you of most of the grunt work involved in upgrading from one major version to the next. The codemod instructions for each major release assume that your code has already been upgraded to the **previous major release**. If this is not the case, you should run the codemods for all previous major versions first.
|
240
|
-
|
241
|
-
Beware that codemods are not 100% fool-proof and may break your code, especially if you do unexpected things like alias Primer exports in strange ways (`import {Box as box}...`), or use component identifiers from other modules that conflict with Primer's. Before running a codemod, please either back up your work or commit it, then carefully inspect the diff.
|
242
|
-
|
243
|
-
[color gradations]: https://styleguide.github.com/primer/support/color-system/#color-variables
|
244
|
-
[default theme]: src/theme.js
|
245
|
-
[emotion]: https://emotion.sh
|
246
|
-
[emotion-theming]: https://github.com/emotion-js/emotion/tree/master/packages/emotion-theming
|
247
|
-
[styled-system]: http://jxnblk.com/styled-system/
|
248
|
-
[themeget]: http://jxnblk.com/styled-system/api#themeget
|
249
|
-
[primer css]: https://github.com/primer/primer
|
250
|
-
[responsive values]: http://jxnblk.com/styled-system/responsive-styles#responsive-styles
|
package/now.json
DELETED
@@ -1,17 +0,0 @@
|
|
1
|
-
{
|
2
|
-
"routes": [
|
3
|
-
{"src": "/react(/.*)?", "dest": "/docs$1"},
|
4
|
-
{
|
5
|
-
"src": "/",
|
6
|
-
"status": 301,
|
7
|
-
"headers": {"Location": "/react"}
|
8
|
-
}
|
9
|
-
],
|
10
|
-
"builds": [
|
11
|
-
{
|
12
|
-
"src": "docs/package.json",
|
13
|
-
"use": "@now/static-build",
|
14
|
-
"config": {"distDir": "public"}
|
15
|
-
}
|
16
|
-
]
|
17
|
-
}
|