diff --git a/AGENTS.md b/AGENTS.md index 2869cd9d8..366311a07 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -23,7 +23,7 @@ A single component is spread across **three parallel trees**, by file type, that **Theming:** Two brands — **Mozilla** (default) and **Firefox**. Themes are CSS Custom Properties declared on `:root` in `includes/themes/` (`_mozilla.scss`, `_firefox.scss`). For any themeable property (foreground/background/link colors, heading & body font families) use `var(--...)` (e.g. `var(--background-color)`, `var(--theme-heading-text-color)`). **Exception: text sizing** — use the type-scale mixins (`@include text-heading-lg;`), never custom properties, because the mixins bake in responsive media queries. -**JavaScript:** Plain ES (target IE10 via Babel in tests), `module.exports`, no framework. Each module is an object named `Mzp` (e.g. `MzpDetails`, `MzpModal`) exposing `init()`/`destroy()` and exported as a **UMD global** named in `webpack.entrypoints.js`. Modules feature-detect via `MzpSupports` and lean on `MzpUtils` helpers. +**JavaScript:** Plain ES (targets the `browserslist` matrix in `package.json` — Firefox ESR, Safari 15.6+, evergreen — via Babel), `module.exports`, no framework. Each module is an object named `Mzp` (e.g. `MzpDetails`, `MzpModal`) exposing `init()`/`destroy()` and exported as a **UMD global** named in `webpack.entrypoints.js`. Modules feature-detect via `MzpSupports` and lean on `MzpUtils` helpers. ## Build, Test, and Development Commands diff --git a/CHANGELOG.md b/CHANGELOG.md index cac824550..7c04173d3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,6 @@ # HEAD -This version introduces some major modernization changes around CSS and drops browser support for XXXX ( to be defined before V23 is published). +This version introduces some major modernization changes around CSS and updates the supported browser matrix to Firefox ESR, Safari 15.6+, and evergreen browsers. The good news is we don't expect many visible changes in modern browsers and you should be able to do some automated visual regression testing to help with the migration. @@ -10,6 +10,8 @@ Introducing theme variables! CSS variables beginning with `--theme-` will adjust ### Browser Support +* (breaking) Updated the supported browser matrix to Firefox ESR, Safari 15.6+, and evergreen browsers (`browserslist` in `package.json`). +* (breaking) Removed the Babel `targets: { ie: '10' }` override in every webpack config (docs site, npm package, and test bundle). The compiled JS now targets the `browserslist` matrix above instead of IE10. * (breaking) Remove support for vendor prefixing (#957) ### Typography diff --git a/components/00-basic-elements/details/readme.md b/components/00-basic-elements/details/readme.md index 3a9fc187f..33bb268d7 100644 --- a/components/00-basic-elements/details/readme.md +++ b/components/00-basic-elements/details/readme.md @@ -1,7 +1,9 @@ The `
` element was introduced in HTML5 to provide a native collapsible -“accordion” widget that previously required JavaScript. However, older browsers -don’t support the newer elements, so Protocol includes a JavaScript polyfill to -improve backwards compatibility. +“accordion” widget that previously required JavaScript. It's natively supported +across Protocol's [supported browsers](/docs/usage/browser-support.html), so no +polyfill is needed. If you need more control over the open/close behavior than +the native element provides, use the JS-driven Protocol +[Details component](details-component) instead. The `
` element requires a ``, which you can combine with headings to convey hierarchy, if appropriate. diff --git a/components/button/button--with-icon.readme.md b/components/button/button--with-icon.readme.md index 9e0cdba91..1a49c8ffc 100644 --- a/components/button/button--with-icon.readme.md +++ b/components/button/button--with-icon.readme.md @@ -16,7 +16,7 @@ consistency and reliability, use an image. - Prefer embedded SVG over an external `img` (whether SVG or other format). An inline SVG icon can more easily change color for the different button states - and style variants. Be aware that very old browsers don’t support SVG. + and style variants. - Consider the text direction of the page language. Arrows in particular indicate a specific orientation that may be confusing in text that flows the opposite diff --git a/components/details-component/details-component.html b/components/details-component/details-component.html index a96c926e4..08b88ac94 100644 --- a/components/details-component/details-component.html +++ b/components/details-component/details-component.html @@ -18,14 +18,6 @@

Sub Heading