Release/15.1.0

CHANGELOG.md

@@ -1,6 +1,16 @@
 # Mayflower Release Notes
 
 All notable changes to this project will be documented in this file.
+## 15.1.0 (2/17/2026)
+### Fixed 
+- (Patternlab) [ContactItem] DP-44415: Fix accessibility issue where aria-describedby attribute referenced non-existent IDs on address directions links. The linkContext ID is now only generated and passed to decorative-link when a label element exists, preventing invalid aria-describedby attributes.
+- (Patternlab) [PersonCard] DP-44560: Conditionally render bio link section only when person.bio is defined and has a valid href, preventing empty anchor tags from appearing in the rendered HTML.
+- (Patternlab) [CampaignVideo] DP-44710: Fix heading level skip accessibility issue on promo page section videos without titles by using H2 instead of H3 to maintain proper heading hierarchy
+
+### Added 
+- (Assets) [Loader] DP-44742: Add loader animation lottie file to assets.
+- (Tokens) [undefined] DP-44969: Add css variables for tokens to Mayflower repo
+
 ## 15.0.0 (1/23/2026)
 ### Changed 
 - (Patternlab,React,Core) [Icons] DP-39285: Swap out all icons to a new set of shared icons from the new DS library. Each icon now offer a regular and bold variant, and is standardized on width, height, color and aria attributes. Some existing icon names are changed to match the new system and naming conventions. Please refer to the Icon documentation for the updated list of icon names. (#2019)

README.md

@@ -120,5 +120,4 @@ For efficiency purposes, we allow CircleCI to bypass certain jobs based on the p
 | `core/`  | This will bypass Patternlab build, deploy and tests | This prefix should only be used if all your changes are in the [core](/packages/core) folder
 | `react/`  | This will bypass Patternlab build, deploy and tests | This prefix should only be used if all your changes are in the [react](/packages/react) folder, and nothing in the shared [assets](/packages/assets) folder that could potentially impact the build of the Patternlab implementation  |
 | `pattern/`  | This will bypass React Storybook build and tests | This prefix should only be used if all your changes are in the [patternlab](/packages/patternlab) folder, and nothing in the shared [assets](/packages/assets) folder that could potentially impact the build of the React implementation  |
-| `site/`  | This will bypass all React and Patternlab and assets build, deploy and tests. |  Only use this prefix if all the changes are in the [site](/packages/site) folder. e.g. Content changes to the homepage site that won't impact React, Patternlab and shared assets. |
-| `docs`  | This will bypass all React and Patternlab and assets build, deploy and tests, as well as Mayflower site build and tests. | Only use this prefix if all the changes are in the [docs](/docs) folder. e.g. Documentation changes for the repo that won't impact React, Patternlab, shared assets and the homepage static site. |
+| `docs`  | This will bypass all React and Patternlab and assets build, deploy and tests, as well as Mayflower site build and tests. | Only use this prefix if all the changes are in the [docs](/docs) folder. e.g. Documentation changes for the repo that won't impact React, Patternlab, shared assets and the homepage static site. |

packages/assets/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massds/mayflower-assets",
-  "version": "15.0.0",
+  "version": "15.1.0",
   "description": "Mayflower Assets",
   "main": "index.js",
   "files": [

packages/assets/static/images/lottie/loader.json

@@ -0,0 +1 @@
+{"v":"5.12.1","fr":60,"ip":0,"op":60,"w":600,"h":600,"nm":"Loader 01 - DEFAULT","ddd":0,"assets":[],"layers":[{"ddd":0,"ind":1,"ty":4,"nm":"Shape Layer 2","sr":1,"ks":{"o":{"a":0,"k":100,"ix":11},"r":{"a":0,"k":0,"ix":10},"p":{"a":0,"k":[300,304,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[85,85,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"d":1,"ty":"el","s":{"a":0,"k":[539.367,539.367],"ix":2},"p":{"a":0,"k":[0,0],"ix":3},"nm":"Ellipse Path 1","mn":"ADBE Vector Shape - Ellipse","hd":false},{"ty":"tm","s":{"a":0,"k":0,"ix":1},"e":{"a":0,"k":30,"ix":2},"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[0],"e":[360]},{"t":59}],"ix":3},"m":1,"ix":2,"nm":"Trim Paths 1","mn":"ADBE Vector Filter - Trim","hd":false},{"ty":"st","c":{"a":0,"k":[0.243137254902,0.580392156863,0.811764705882,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":90,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[-0.316,-4.316],"ix":2},"a":{"a":0,"k":[0,0],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Ellipse 1","np":4,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":60,"st":0,"ct":1,"bm":0},{"ddd":0,"ind":2,"ty":4,"nm":"Shape Layer 1","sr":1,"ks":{"o":{"a":0,"k":100,"ix":11},"r":{"a":0,"k":0,"ix":10},"p":{"a":0,"k":[300,304,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[85,85,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"d":1,"ty":"el","s":{"a":0,"k":[539.367,539.367],"ix":2},"p":{"a":0,"k":[0,0],"ix":3},"nm":"Ellipse Path 1","mn":"ADBE Vector Shape - Ellipse","hd":false},{"ty":"st","c":{"a":0,"k":[0.729411764706,0.729411764706,0.733333333333,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":90,"ix":5},"lc":1,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[-0.316,-4.316],"ix":2},"a":{"a":0,"k":[0,0],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Ellipse 1","np":3,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":60,"st":0,"ct":1,"bm":0}],"markers":[],"props":{}}

packages/core/.env

@@ -1,4 +1,4 @@
-STORYBOOK_VERSION=15.0.0
+STORYBOOK_VERSION=15.1.0
 STORYBOOK_CDN=https://unpkg.com/
 STORYBOOK_PKG=@massds/mayflower-assets
 STORYBOOK_CDN_PATH=$STORYBOOK_CDN$STORYBOOK_PKG@$STORYBOOK_VERSION

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mayflower-core",
-  "version": "15.0.0",
+  "version": "15.1.0",
   "description": "",
   "main": "index.js",
   "scripts": {
@@ -50,7 +50,7 @@
     "bootstrap": "^4.6.0"
   },
   "dependencies": {
-    "@massds/mayflower-assets": "^15.0.0",
-    "@massds/mayflower-react": "^15.0.0"
+    "@massds/mayflower-assets": "^15.1.0",
+    "@massds/mayflower-react": "^15.1.0"
   }
 }

packages/patternlab/styleguide/package.json

@@ -5,7 +5,7 @@
     "node": ">6.9.0",
     "npm": ">5.0.0"
   },
-  "version": "15.0.0",
+  "version": "15.1.0",
   "author": "Massachusetts Digital Services (MDS)",
   "repository": {
     "type": "git",
@@ -24,7 +24,7 @@
   },
   "homepage": "https://github.com/massgov/mayflower#readme",
   "devDependencies": {
-    "@massds/mayflower-assets": "^15.0.0",
+    "@massds/mayflower-assets": "^15.1.0",
     "babel-core": "^6.26.3",
     "babel-preset-env": "^1.7.0",
     "babelify": "^8.0.0",

packages/patternlab/styleguide/source/_patterns/02-molecules/contact/contact-item.twig

@@ -9,7 +9,6 @@
 {% else %}
   {% set link = item.link %}
 {% endif %}
-
 {# if using the older 3.4.1 data model #}
 {% if item.value %}
   {# update the older code's data to match the new version #}
@@ -18,7 +17,7 @@
   {% set address = item.address %}
 {% endif %}
 
-{% set linkContext = "linkContext-" ~ random() %}
+{% set linkContext = item.label ? "linkContext-" ~ random() : "" %}
 <div class="ma__contact-group__item">
   {% if item.label %}
     <span class="ma__contact-group__label" id="{{ linkContext }}">{{item.label}}</span>
@@ -54,12 +53,12 @@
     {# Address - RTE version of value and look for directions link #}
   {% elseif item.type == "address" %}
     <div class="ma__contact-group__address">
-      {{ address|nl2br }}
+      {{ address|nl2br|replace({'<br />': '<br aria-hidden="true"/>'})|raw }}
     </div>
     {% if link.href %}
       <div class="ma__contact-group__directions">
         {% set decorativeLink = link %}
-        {% set decorativeLink = decorativeLink|merge({'context': linkContext}) %}
+        {% if linkContext %}{% set decorativeLink = decorativeLink|merge({'context': linkContext}) %}{% endif %}
         {% include "@atoms/decorative-link.twig" %}
       </div>
     {% endif %}

packages/patternlab/styleguide/source/_patterns/03-organisms/by-author/person-card.twig

@@ -16,10 +16,12 @@
         {% include "@atoms/04-headings/column-heading.twig" %}
       </div>
     </div>
+    {% if person.bio is defined and person.bio is not same as(false) and person.bio.href|default('') is not empty %}
     <div class="ma__person-card__links">
       {% include "@atoms/divider.twig" %}
       {% set link = person.bio %}
       {% include "@atoms/11-text/link.twig" %}
     </div>
+    {% endif %}
   </div>
 </div>

packages/patternlab/styleguide/source/_patterns/03-organisms/by-template/campaign-video.twig

@@ -23,7 +23,13 @@
 
     <div class="ma__campaign-video__video">
       {% set video = campaignVideo.video %}
-      {% set videoHeadingLevel = headingLevel + 1 %}
+      {# For section videos without a title, use H2 (section level) instead of H3 to maintain heading hierarchy #}
+      {# This prevents heading level skips while addressing the concern about unnecessary H3 headings #}
+      {% if not campaignVideo.isHeader and not campaignVideo.title %}
+        {% set videoHeadingLevel = headingLevel %}
+      {% else %}
+        {% set videoHeadingLevel = headingLevel + 1 %}
+      {% endif %}
       {% set video = video|merge({"headingLevel": videoHeadingLevel}) %}
       {% include "@atoms/09-media/video.twig" %}
     </div>

packages/react/package.json

@@ -2,7 +2,7 @@
   "name": "@massds/mayflower-react",
   "description": "React versions of Mayflower design system UI components",
   "author": "Massachusetts Digital Services (MDS)",
-  "version": "15.0.0",
+  "version": "15.1.0",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "sideEffects": [
@@ -57,7 +57,7 @@
     "html-react-parser": "~1.4.14"
   },
   "peerDependencies": {
-    "@massds/mayflower-assets": "^15.0.0",
+    "@massds/mayflower-assets": "^15.1.0",
     "react": "^16.13.1 || ^17 || ^18",
     "react-dom": "^16.13.1 || ^17 || ^18"
   },
@@ -73,7 +73,7 @@
     "@babel/plugin-transform-runtime": "^7.10.1",
     "@babel/preset-env": "^7.10.1",
     "@babel/preset-react": "^7.10.1",
-    "@massds/mayflower-assets": "^15.0.0",
+    "@massds/mayflower-assets": "^15.1.0",
     "@storybook/addon-a11y": "6.0.21",
     "@storybook/addon-actions": "6.0.21",
     "@storybook/addon-controls": "6.0.21",