Releases: okta/odyssey
v0.10.0
This release includes many visual updates as well as some breaking changes including:
- Icons being redesigned and renamed
- ESM Package entry points being explicitly defined
- Design tokens being updated and renamed
In addition there are a number of design updates:
- Size and spacing of elements being adjusted
- Focus states for form elements and buttons have been redesigned to meet accessibility criteria
⚠ BREAKING CHANGES
- odyssey-react: Heading now applies standard line-heights for each
semantic and visual heading level. If custom line-heights are desired
for these headings, they can now be themed. Alternately, Text may be
used to generate custom font-size/line-height combinations. - odyssey-react: removes "normal" and "heading" line height props in
favor of "body" and "heading"s 1-6; (e.g. "heading3") - odyssey-design-tokens: set space scale under "scale"
- odyssey-design-tokens: removes prior space tokens from dict
- odyssey-react: utilizes new type tokens
- odyssey-design-tokens: updates type tokens to match new scale
- odyssey-react: icons deleted and renamed
- odyssey-icons: icons deleted and renamed
- odyssey-design-tokens: migrates all focus tokens under Focus; renames outlines
tokens - odyssey-design-tokens: define explicit exports and module type
- odyssey-react: define explicit exports and module type
- odyssey-react-theme: define explicit exports and module type
Features
- browserslist-config-odyssey: make package public (d0341bf)
- odyssey-design-tokens: add new spacing scale (faf6f19)
- odyssey-design-tokens: make Neutral Dark color available (a718368)
- odyssey-design-tokens: standardize focus styles for outline (c6556a0)
- odyssey-design-tokens: updates type tokens to match new scale (b763705)
- odyssey-icons: update icons with new designs (c46a433)
- odyssey-react-theme: useTheme hook (fce5848)
- odyssey-react: add SvgIcon to exported components (bbe1ff3)
- odyssey-react: update focus styles to be a11y-friendly (a9dc7c4)
- odyssey-react: update icons with new designs, update components with icons (a5430b9)
- odyssey-storybook: force 14px font-size on preview html (9eb4fdc)
- odyssey-storybook: update Icon and Link stories with new icons (67d9d3f)
- odyssey: add package for IE 11 testing sandbox (e30b754)
Code Refactoring
- odyssey-design-tokens: define explicit exports and module type (fdb56c5)
- odyssey-design-tokens: removes prior space tokens from dict (f35b3f5)
- odyssey-design-tokens: set space scale under "scale" (5ddbe65)
- odyssey-react-theme: define explicit exports and module type (f71a20b)
- odyssey-react: define explicit exports and module type (6a194a5)
- odyssey-react: remove lineheight props from Heading (d0538d0)
- odyssey-react: update Text props to reflect new line-heights (f0ef803)
- odyssey-react: utilizes new type tokens (3650b7c)
v0.9.3
Thanks for supporting Odyssey. This release makes several previously internal packages publically available:
- odyssey-babel-plugin
- odyssey-babel-preset
- odyssey-postcss-preset
- odyssey-postcss-scss
- odyssey-postcss-theme
If you have trouble or have questions please reach out to us through the channels mentioned in our Contribution Guidelines!
CHANGELOG
0.9.3 (2022-02-24)
Features
- odyssey-babel-plugin: make package public (072c628)
- odyssey-babel-preset: make package public (082b214)
- odyssey-lifecycle: add new package to reduce duplication for lifecycle scripts (aff7760)
- odyssey-postcss-preset: make package public (e06adcc)
- odyssey-postcss-scss: make package public (a215fab)
- odyssey-postcss-theme: make package public (00a7555)
v0.9.2
0.9.2 (2022-02-17)
Thanks for supporting Odyssey. This release includes a css bug fix as well as new functionality for our <TextArea/>
component.
If you have trouble or have questions please reach out to us through the channels mentioned in our Contribution Guidelines!
🚀
v0.9.1
Documentation of theming variables in Storybook and small bug fixes.
If you have trouble or have questions please reach out to us through the channels mentioned in our Contribution Guidelines!
Features
- odyssey-storybook: add autogenerated theme tokens tables and component theme table (705057b)
- odyssey-storybook: add build to prepublishOnly (0ebf5a6)
- odyssey-storybook: add theme variable tables to all component doc pages (b6a8a1f)
- odyssey-storybook: move component location and update props based on feedback (3edfdbe)
Bug Fixes
v0.9.0
0.9.0 (2022-02-02)
Thanks for supporting Odyssey. First, a few highlights to share from this release:
- Important foundational work on our styles and CSS architecture.
- New theme APIs that allow run time branding or deeper component customization.
- see the
@okta/odyssey-react-theme
and@okta/odyssey-design-tokens
packages for more detail
- see the
- Improved component prop APIs
- New contribution guidelines, philosophy writeup and getting started documentation
Although Odyssey is a pre-major release project, our commitment to stability remains. This is a BREAKING CHANGE
release and thus we've moved forward a minor version following our published versioning schema. Please pay special attention to this change when pulling in the latest package version:
- Global CSS has been removed entirely, and the
odyssey-deprecated-global.css
stylesheet removed. If your app previously used this file from an older release - remove it. You may also need to refactor your application styles further to account for the lack of globally applied CSS. You can now solve layout or style issues by using component composition by using one of ourBox
orText
components to create layouts without writing or maintaining any CSS by hand.
If you have trouble or have questions please reach out to us through the channels mentioned in our new Contribution Guidelines!
🚀
CHANGELOG
### ⚠ BREAKING CHANGES
- odyssey-react: rename TextInput "inputRef" prop to "ref"
- odyssey-react: rename TextArea "textareaRef" prop to "ref"
- odyssey-react: renames "title" props to "heading"
- odyssey-react: renames FieldGroup "title" prop to "legend"
- odyssey-react: renames Table "title" prop to "caption"
- odyssey-react: rename Tag component to TagList
- odyssey-react: rename Table prop "title" to "heading"
- odyssey-react: remove odyssey-deprecated-global.css stylesheet. Odyssey consumers should now use component composition.
- odyssey-react: remove data-testid="ods-toast-pen" from Toast
- odyssey-react: remove data-testid="ods-tabs" from Tabs
- odyssey-react: Text prop fontWeight "regular" renamed to "normal"
- odyssey-react: Text props color "heading" "danger-disabled" and "code" removed
- odyssey-react: Text prop fontSize "lede" removed
- odyssey-react: Text props textTransform "full-width" and "full-size-kana" removed
- odyssey-react: Text prop lineHeight "font" removed
- odyssey-react: Text prop overflowWrap "anywhere" removed
- odyssey-react: required form input components must now declare true prop for
required
- odyssey-react: non-required form input components must now declare translated string prop for
optionalLabel
- odyssey-react: rename Text props and values to match standard css, remove text interaction props
- odyssey-react: Text prop hoverBorderColor prop "interactive" renamed to "ui"
Features
- expose hidden choices reference (a64597a)
- no invalid theme properties eslint rule (847d506)
- odyssey-design-tokens: add heading color token (2e55f7b)
- odyssey-design-tokens: add new functional colors (a7890f8)
- odyssey-design-tokens: add space tokens (e8ff2de)
- odyssey-design-tokens: add tokens for sizing, addl colors (6b8d9a0)
- odyssey-design-tokens: add transition and line height tokens (b8a1d9f)
- odyssey-react-theme: add new react-theme package (d2197f2)
- odyssey-react: add base styles and theme variables to TextInput (3216e72)
- odyssey-react: add Box as Button root (c0971de)
- odyssey-react: add Box as root of Banner (3321802)
- odyssey-react: add Box as root of Checkbox (ce14011)
- odyssey-react: add Box as root of FieldGroup (e325f50)
- odyssey-react: add Box as root of Link (35d74f9)
- odyssey-react: add Box in Heading (564d674)
- odyssey-react: add Box to Tag (ab87e11)
- odyssey-react: add Box to Modal and sub-components (0b8f85a)
- odyssey-react: add Box to Select option and optiongroup (a48a5d4)
- odyssey-react: add Box to Table (f7aed53)
- odyssey-react: add Box to Tabs components (d4bfae9)
- odyssey-react: add Box to Toast (581a8eb)
- odyssey-react: add Box to Tooltip (f157469)
- odyssey-react: add Box wrapper to RadioButton (31938c6)
- odyssey-react: add full Box component implementation (35c47af)
- odyssey-react: add inherit to Box text prop values (4ba9794)
- odyssey-react: add reset styles to box, expose as prop (ab539a8)
- odyssey-react: add support for className prop in Box (117e0bb)
- odyssey-react: add text classes to Box withStyles (264218f)
- odyssey-react: add Text component to Button to remove dependence on global styles (16e7b3e)
- odyssey-react: add text styles to Box root (a653b3d)
- odyssey-react: add theme variables to List (2364006)
- odyssey-react: add theme variables to RadioButton. Consistency pass for variable naming (be14acc)
- odyssey-react: add themeing variables to Checkbox (fbf79e5)
- odyssey-react: add themeing variables to Toast (752d1ea)
- odyssey-react: add ThemeProvider (41a5516)
- odyssey-react: add theming to CircularLoadIndicator (d58604f)
- odyssey-react: add theming to Table (e059ac3)
- odyssey-react: add theming to Tooltip (2ec9e86)
- odyssey-react: add WithTheme HOC (325155e)
- odyssey-react: add withTheme to Infobox (015256d)
- odyssey-react: additional theme vars in Checkbox (27cafca)
- odyssey-react: additional theme vars in Checkbox (54e3f38)
- odyssey-react: align theme variables between components (97ee069)
- odyssey-react: align types related to Box (0c4d4d9)
- odyssey-react: allow Button to control font-family (8eb6d05)
- odyssey-react: allow default text properties to be overriden in Box (da68956)
- odyssey-react: allow font-style to be set by Link with Box (...
v0.6.0
[0.6.0] - 2020-10-02
Added
- Toast: a transient messaging component
- Icons: Caution, Copy, Filter, and Error icons are now available
- Standalone Search: added a new Text Input variant for search UI
- Green-600: added as an a11y-compliant background color
- details/summary: styling and minor guidance for the HTML elements
- dl/dt/dd: styling and minor guidance for the HTML elements
- pre: styling and minor guidance for the HTML element
Changed
- Gray-900 updated to #1d1d21; all relevant variables/tokens updated
- Links no longer require an underline; new Gray-900 contrast allows for this
- Icons: the Complete icon has been updated to differentiate it from a plain check
Removed
- [Docs] Extraneous doc styles for deprecated samples have been removed
v0.5.1
[0.5.1] - 2020-09-18
Added
- [Docs] Added missing guidance for accessible SVG icon use in Buttons
Changed
- [Docs] Field warnings no longer display an "alert" icon as part of invalid messaging guidance
Fixed
- [Docs] Type token examples now display correctly
- [Docs]
title
displays correctly once more ("Odyssey Design System") - [Docs] VuePress no longer modifies outbound links automatically
v0.5.0
[0.5.0] - 2020-09-03
Added
- [Docs] Iconography documentation, available at /base/iconography
- Basic styles for inline Icon display
- Multi-Select variant for Select (both Choices.js and HTML-only)
- Button w/ Icon variant has been added to Button
- Blue, 400 is now available for use via Sass maps (no Token)
- Gray, 500 is now available for use via Sass maps (no Token)
Changed
- [Docs] Type documentation is now titled "Typography" and located at /base/typography
- [Docs] Documentation now references this CHANGELOG on GH directly rather than copying over
- [Docs] Color documentation has been revamped entirely
- [Docs] Documentation sorts now utilizes Vuepress slots for future-friendliness
- Recommended Choices.js configuration updated (non-breaking)
- SVGO configuration no longer sorts attributes, now adds
.ods-icon
- [Breaking Change] "info", "back", and "forward" icons have been renamed to "get-info", "go-backward", and "go-forward"
$border-color-ui
is now a11y-compliant, utilizes Gray, 500blockquote
, Form, Table, and Tab borders now use$border-color-display
as they are not a11y-constrained
Removed
- [Docs] Type test page has been removed from docs
- [Breaking Change] Grays 300 and 400 have been removed from available use
Fixed
- [Docs] Modal examples now work as intended
- [Docs]
address
example now renders correctly - All Icons now use a 14px grid instead of 24px for optimal display
v0.4.0
[0.4.0] - 2020-08-05
Added
@okta/odyssey-icons
package: includes an initial set of SVGs and process for batch optimizing viasvgo
Changed
- Changed the Odyssey documentation platform from
hexo
tovuepress
- The documentation theme is now sourced via the private
@okta/vuepress-theme-nimatron
package .gitignore
now includes the auto-generatedCHANGELOG
to avoid creating duplicate files:disabled
and:read-only
labels now share text and border styling- Tab indicators no longer animate via CSS vars
Removed
- [Breaking Change]
$border-default
token has been removed :visited
link styling has been removed for user privacy
Fixed
- Buttons labels no longer wrap (
white-spacing: nowrap
)
v0.3.0
[0.3.0] - 2020-06-25
Added
- Design Tokens
Changed
- Color, type and spacing to reflect rebrand
- [Breaking Change]
_variables.scss
has been renamed to_tokens.scss
, this introduces design tokens into Odyssey - [Breaking Change] Renamed "warning" to "orange"
- [Breaking Change] Changed spacing variables (tokens) to use t-shirt sizing as well as new values
- [Breaking Change] Changed typography, font family. Now refers to "headings" as titles throughout
- [Breaking Change] Change semantic
cv
arguments (lightest, base, dark) in favor of 000-900
Removed
- [Breaking Change] Removed colors: magenta, grays 100, 300, 500, 700, 900
- [Breaking Change] Removed
fauxpacity
function, preferring "light" color variants - [Breaking Change] Removed documentation and Sass styles for unapproved components: Banner, Callout, Card, Dropdown, Meter, Navigation, Switch, Toast, Top Bar
- Removed all other unused/unapproved documentation