/*  notifications.scss
    ---
    Adds a notification at the top of each USWDS
    compile. Use this file for important notifications
    and updates to the design system.

    This file should started fresh at each
    major version.

*/

/* prettier-ignore */
$uswds-notifications:
    "\A"
  + "\A --------------------------------------------------------------------"
  + "\A \2709  USWDS Notifications"
  + "\A --------------------------------------------------------------------"
  + "\A 2.0.2: We changed the names of some settings and mixins."
  + "\A"
  + "\A - $theme-title-font-size \2192  $theme-display-font-size"
  + "\A - @include title \2192  @include display"
  + "\A - @include typeset-title \2192  @include typeset-display"
  + "\A --------------------------------------------------------------------"
  + "\A 2.2.0: We changed the names of some settings."
  + "\A"
  + "\A - $theme-navigation-width \2192  $theme-header-min-width"
  + "\A - $theme-megamenu-logo-text-width \2192  $theme-header-logo-text-width"
  + "\A --------------------------------------------------------------------"
  + "\A 2.4.0: If your component settings aren't working as expected, make"
  + "\A sure you're importing the components settings in your Sass entry"
  + "\A point (often styles.scss) with `@import 'uswds-theme-components'`."
  + "\A A bug in 2.0 omitted that import."
  + "\A - We added `$theme-show-notifications: true` to general settings"
  + "\A --------------------------------------------------------------------"
  + "\A 2.5.0:"
  + "\A - We updated to Dart Sass for compiling. Consider updating your own"
  + "\A   build process using `uswds-gulp` as a guide."
  + "\A - We upgraded our aXe accessibility testing from 2.6.1 to 3.4.1 and"
  + "\A   improved the accessibility of our markup in the process."
  + "\A   This introduces minor changes to the markup of 5 components and "
  + "\A   our documentation template:"
  + "\A   - banner: is now a <section> instead of a <div> with the ARIA "
  + "\A     label `Official government website`"
  + "\A   - footer: nav includes the ARIA label of `Footer navigation`"
  + "\A   - graphic-list: uses <h2> as a heading default instead of <h3> "
  + "\A   - hero: includes the ARIA label of `Introduction`"
  + "\A   - search: the search form is given the ARIA role of `search`"
  + "\A   - documentation template: includes only the main content in the "
  + "\A     <main> element. The nav is no longer treated as an <aside>."
  + "\A - Now state tokens (like 'warning') can can accept non-token"
  + "\A   colors, just as we introduced for theme colors in 2.4.0."
  + "\A --------------------------------------------------------------------"
  + "\A 2.5.1:"
  + "\A - CSSO's forceMediaMerge wasn't exporting media queries in the"
  + "\A   expected order, so we're disabling it for more reliable CSS"
  + "\A   output. We recommend that teams remove any media query sorting"
  + "\A   added with forceMediaMerge."
  + "\A --------------------------------------------------------------------"
  + "\A 2.6.0:"
  + "\A - We updated the markup of usa-search. Existing markup will still"
  + "\A   work, but we recommend updating to the newest markup."
  + "\A - We updated some color token values and filled out the vivid color"
  + "\A   families. This is not a breaking change, but be aware that there"
  + "\A   may be some subtle changes."
  + "\A --------------------------------------------------------------------"
  + "\A 2.7.0:"
  + "\A - We added new usa-button-group, usa-card, usa-character-count, and"
  + "\A   usa-combo-box components."
  + "\A - We updated our guidance and code for numeric fields to use `text`"
  + "\A   rather than `number` inputs with an `inputmode` of `numeric`."
  + "\A --------------------------------------------------------------------"
  + "\A 2.7.1:"
  + "\A - We added `not dead` to our autoprefixer settings and now use a "
  + "\A   `.browserslistrc` file for these options."
  + "\A --------------------------------------------------------------------"
  + "\A 2.8.0:"
  + "\A - We updated the text of the gov banner and its settings."
  + "\A   Please see the full release notes for more information and update"
  + "\A   your project's banner as soon as possible."
  + "\A --------------------------------------------------------------------"
  + "\A 2.9.0:"
  + "\A - We updated the formatting of `usa-legend`. If you use a visible "
  + "\A   legend and wish to preserve the old styling, add a "
  + "\A   `usa-legend--large` modifier to the element."
  + "\A --------------------------------------------------------------------"
  + "\A 2.10.0:"
  + "\A - We updated the Spanish language link to USAGov in the identifier. "
  + "\A   The link should now read 'Visite USAGov en Español'. "
  + "\A - We improved the accessibility of SVG images in the banner. "
  + "\A   See the full release notes for more information."
  + "\A --------------------------------------------------------------------"
  + "\A 2.10.1:"
  + "\A - We updated the `$theme-breadcrumb-background-color` default"
  + "\A   to `default` from `'white'`. "
  + "\A - We updated the `$theme-alert-icon-size` default to `5` from `4`."
  + "\A - [Footer] We updated `usa-footer__logo-heading` to use a `p`."
  + "\A   instead of an `h3`. "
  + "\A --------------------------------------------------------------------"
  + "\A 2.11.0:"
  + "\A - We updated some settings defaults:"
  + "\A   $theme-alert-icon-size: 4 (was 5)"
  + "\A   $theme-table-border-color: default (was 'ink')"
  + "\A   $theme-table-header-text-color: default (was 'ink')"
  + "\A   $theme-table-stripe-text-color: default (was 'ink')"
  + "\A   $theme-table-text-color: default (was 'ink')"
  + "\A --------------------------------------------------------------------"
  + "\A 2.11.2:"
  + "\A - We deprecated the `$theme-site-max-width` variable. We're using"
  + "\A   `$theme-grid-container-max-width` instead."
  + "\A - We replaced the `thumb_down_off_alt` icon with `thumb_down_alt`"
  + "\A   in our default icon sprite."
  + "\A --------------------------------------------------------------------"
  + "\A 2.12.0:"
  + "\A - We deprecated three settings:"
  + "\A   $theme-input-tile-background-color-selected"
  + "\A   $theme-input-tile-border-color"
  + "\A   $theme-input-tile-border-color-selected"
  + "\A   Each of these is now calculated automatically"
  + "\A - We updated some settings defaults:"
  + "\A   $theme-color-success-dark: green-cool-50v (was green-cool-50)"
  + "\A   $theme-color-success-darker: green-cool-60v (was green-cool-80)"
  + "\A --------------------------------------------------------------------"
  + "\A 2.12.2:"
  + "\A - As a security precaution, we're now sanitizing text passed into "
  + "\A   Tooltip. Tooltip no longer supports markup in its content."
  + "\A --------------------------------------------------------------------"
  + "\A 2.13.0:"
  + "\A   BREAKING CHANGES:"
  + "\A - We made a couple breaking changes to support the accessibility"
  + "\A   of icon-only buttons. See complete release notes:"
  + "\A   https://github.com/uswds/uswds/releases/tag/v2.13.0"
  + "\A - We updated the markup of the small Search button to include its "
  + "\A   magnifying glass icon as an inline image instead of as a "
  + "\A   background image."
  + "\A   See the release notes for the updated markup."
  + "\A - We updated the markup of the social icons in the Footer "
  + "\A   to use inline images instead of background images."
  + "\A   See the release notes for the updated markup.";

/* prettier-ignore */
$uswds-notification-disable-message:
  "\A"
+ "\A --------------------------------------------------------------------"
+ "\A These are notifications from the USWDS team, not necessarily a"
+ "\A problem with your code."
+ "\A"
+ "\A Disable notifications using `$theme-show-notifications: false`"
+ "\A in your general settings file."
+ "\A --------------------------------------------------------------------\A";

@if $theme-show-notifications {
  @warn "#{$uswds-notifications}"
    + "#{$uswds-notification-disable-message}";
}