@penskemediacorp/larva-patterns 1.9.0-alpha.0 → 1.10.0

package/objects/o-figure/README.md

@@ -0,0 +1,17 @@
+o-figure is designed to support images with a caption and a credit, primarily used within editorial content in `the_content` in WordPress. pmc-core-v2 contains a filter on the `caption` shortcode that applies this pattern. Is it also used in for featured images that include credits and captions.
+
+It consists of a `figure` element around a `c-lazy-image` and `c-figcaption`, with an optional link wrapper to make the entire block clickable.
+
+There is an option for adding an inline style for the width on the `figure` to provide a smooth paint in post content.
+
+The pattern supports Lazy Loading with `c-lazy-image`.
+
+## When to use:
+* For images or content that can stand on its own, outside of the document flow. Read more about [semantic use of `figure` here](http://html5doctor.com/the-figure-figcaption-elements/). 
+
+## When not to use:
+* For images that cannot stand on their own as content, e.g. a featured image for a post that requires additional post content to be understood.
+* Logo or icons
+
+## Future:
+Could support non-image figures such as charts, embeds, or quotes.

package/objects/o-figure/o-figure.prototype.js

@@ -1,8 +1,16 @@
+const clonedeep = require( 'lodash.clonedeep' );
+
+const c_figcaption = clonedeep( require( '../../components/c-figcaption/c-figcaption.prototype' ) );
+const c_lazy_image = clonedeep( require( '../../components/c-lazy-image/c-lazy-image.prototype' ) );
+
 module.exports = {
-	"o_figure_permalink_url": "https://notlaura.com",
-	"o_figure_alt_attr": "Thumbnail image",
-	"o_figure_placeholder_image_url": "https://picsum.photos/300/300",
-	"o_figure_image_url": "https://picsum.photos/300/300",
-	"o_figure_caption_text": "Here is some caption text",
-	"o_figure_screen_reader_text": "Text if there is no caption"
-}
+	c_figcaption: c_figcaption,
+	c_lazy_image: c_lazy_image,
+	o_figure_link_tabindex_attr: '',
+	o_figure_link_target_attr: '_self',
+	o_figure_link_url: false,
+	o_figure_classes: '',
+	o_figure_link_classes: 'lrv-a-unstyle-link ',
+	o_figure_figcaption_outer: false,
+	o_figure_figcaption_outer_classes: '',
+};

package/objects/o-figure/o-figure.twig

@@ -1,57 +1,34 @@
-{% if o_figure_permalink_url %}
-	<a href="{{ o_figure_permalink_url }}" class="o-figure__link {{ o_figure_link_classes }}">
-{% endif %}
-
-{% if o_figure_screen_reader_text %}
-	<span class="a-screen-reader-only">{{ o_figure_screen_reader_text }}</span>
-{% endif %}
-
-{% if has_toaster %}
-	<figure class="o-figure {{ modifier_class }} {{ o_figure_classes }}" data-toaster-activate-trigger>
-{% else %}
-	<figure class="o-figure {{ modifier_class }} {{ o_figure_classes }}" style="{{ o_figure_width_attr }}">
+{% if o_figure_link_url %}
+	<a href="{{ o_figure_link_url }}" class="o-figure__link {{ o_figure_link_classes }}"
+		{% if o_figure_link_target_attr %}
+			target="{{ o_figure_link_target_attr }}"
+		{% endif %}
+		{% if o_figure_link_tabindex_attr %}
+			tabindex="{{ o_figure_link_tabindex_attr }}"
+		{% endif %}
+	>
 {% endif %}
 
-{% if o_figure_crop_class %}
-	<div class="{{ o_figure_crop_class }}">
-{% endif %}
+<figure class="o-figure {{ modifier_class }} {{ o_figure_classes }} lrv-u-max-width-100p" style="{{ o_figure_width_attr }}">
 
-{% if o_figure_image_markup %}
-	{{ o_figure_image_markup }}
-{% else %}
-	<img class="o-figure__image {{ o_figure_image_classes }}" src="{{ o_figure_placeholder_image_url }}" data-lazy-src="{{ o_figure_image_url }}" alt="{{ o_figure_alt_attr }}">
-{% endif %}
+	{% if c_lazy_image %}
+		{% include "@larva/components/c-lazy-image/c-lazy-image.twig" with c_lazy_image %}
+	{% endif %}
 
-{% if c_button %}
-	{% include "@larva/components/c-button/c-button.twig" with c_button %}
-{% endif %}
-
-{% if o_figure_crop_class %}
-	</div>
-{% endif %}
+	{% if c_figcaption %}
+		{% if o_figure_figcaption_outer %}
+			<div class="o-figure__figcaption-outer {{ o_figure_figcaption_outer_classes }}">
+		{% endif %}
 
-{# Backwards Compatibility #}
-{% if o_figure_caption_text %}
-	<figcaption class="o-figure__caption {{ o_figure_caption_classes }}">{{ o_figure_caption_text }}</figcaption>
-{% endif %}
+			{% include "@larva/components/c-figcaption/c-figcaption.twig" with c_figcaption %}
 
-{% if o_figure_show_figcaption %}
-	<figcaption class="o-figure__caption {{ o_figure_figcaption_classes }}">
-		{% if o_figure_caption_markup %}
-			<span class="{{ o_figure_caption_classes }}">{{ o_figure_caption_markup }}</span>
+		{% if o_figure_figcaption_outer %}
+			</div>
 		{% endif %}
-		{% if o_figure_credit_text %}
-			<span class="{{ o_figure_credit_classes }}">{{ o_figure_credit_text }}</span>
-		{% endif %}
-	</figcaption>
-{% endif %}
-
-{% if c_play_badge %}
-	{% include "@larva/components/c-play-badge/c-play-badge.twig" with c_play_badge %}
-{% endif %}
+	{% endif %}
 
 </figure>
 
-{% if o_figure_permalink_url %}
+{% if o_figure_link_url %}
 	</a>
 {% endif %}

package/objects/o-header/o-header.prototype.js

@@ -1,12 +1,14 @@
+const clonedeep = require( 'lodash.clonedeep' );
+
+const c_heading = clonedeep( require( '../../components/c-heading/c-heading.prototype' ) );
+const c_button = clonedeep( require( '../../components/c-button/c-button.prototype' ) );
+
+c_button.c_button_classes = 'lrv-u-font-size-12 lrv-u-text-transform-uppercase lrv-a-icon-after lrv-a-icon-arrow-right lrv-u-margin-l-auto';
+c_button.c_button_text = 'Link';
+c_button.c_button_url = '#';
+
 module.exports = {
-	"o_heading_classes": "u-flex u-align-items-center pmc-u-background-black pmc-u-padding-a-1",
-	"c_heading": {
-		"c_heading_classes": "pmc-u-color-white",
-		"c_heading_text": "Section Heading"
-	},
-	"c_button": {
-		"modifier_class": "c-button--plain pmc-u-font-size-12 pmc-u-color-white pmc-u-text-transform-uppercase a-icon-after a-icon-arrow-right u-margin-l-auto",
-		"c_button_url": "#",
-		"c_button_text": "Link"
-	}
+	o_heading_classes: 'lrv-u-flex lrv-u-align-items-center lrv-u-padding-a-1',
+	c_heading: c_heading,
+	c_button: c_button
 };

package/objects/o-header/o-header.twig

@@ -1,4 +1,4 @@
-<header class="o-heading {{ modifier_class }} {{ o_heading_classes }}">
+<header class="o-header {{ modifier_class }} {{ o_heading_classes }}">
 	{% if c_heading %}
 		{% include "@larva/components/c-heading/c-heading.twig" with c_heading %}
 	{% endif %}
@@ -11,6 +11,10 @@
 		{% include "@larva/components/c-button/c-button.twig" with c_button %}
 	{% endif %}
 
+	{% if c_svg %}
+		{% include "@larva/components/c-svg/c-svg.twig" with c_svg %}
+	{% endif %}
+
 	{% if o_sponsored_by %}
 		{% include "@larva/objects/o-sponsored-by/o-sponsored-by.twig" with o_sponsored_by %}
 	{% endif %}

package/objects/o-header-buttons/o-header-buttons.column.js

@@ -0,0 +1,10 @@
+const clonedeep = require( 'lodash.clonedeep' );
+
+const header_buttons_prototype = require( './o-header-buttons.prototype' );
+const header_buttons = clonedeep( header_buttons_prototype );
+
+header_buttons.button_wrap = true;
+header_buttons.c_subscribe_link.c_link_classes = 'lrv-a-unstyle-link lrv-u-text-transform-uppercase lrv-u-font-family-body lrv-u-font-size-12 lrv-u-font-size-8@mobile-max  lrv-u-color-brand-primary:hover lrv-u-border-b-1 lrv-u-border-color-white lrv-u-border-color-brand-primary:hover lrv-u-border-b-1 lrv-u-border-color-currentColor lrv-u-margin-b-025';
+header_buttons.c_got_a_tip.c_link_classes  = 'lrv-a-unstyle-link lrv-u-text-transform-uppercase lrv-u-font-family-body lrv-u-font-size-12 lrv-u-font-size-8@mobile-max  lrv-u-color-brand-primary:hover lrv-u-border-b-1 lrv-u-border-color-white lrv-u-border-color-brand-primary:hover lrv-u-margin-tb-025';
+header_buttons.o_header_button_classes = 'lrv-u-align-items-stretch lrv-a-space-children-horizontal lrv-a-space-children--1';
+module.exports = header_buttons;

package/objects/o-header-buttons/o-header-buttons.prototype.js

@@ -0,0 +1,41 @@
+const clonedeep = require( 'lodash.clonedeep' );
+
+const c_link_prototype = require( '../../components/c-link/c-link.prototype' );
+const o_account_menu_prototype = require( '../../objects/o-account-menu/o-account-menu.prototype');
+
+const c_login_link = clonedeep( c_link_prototype );
+c_login_link.c_link_text = 'Log In';
+c_login_link.c_link_classes = ' lrv-a-unstyle-link lrv-u-text-transform-uppercase lrv-u-font-family-body lrv-u-font-size-12 lrv-u-font-size-8@mobile-max  lrv-u-color-brand-primary:hover lrv-u-border-b-1 lrv-u-border-color-white lrv-u-border-color-brand-primary:hover';
+
+const c_subscribe_link = clonedeep( c_link_prototype );
+c_subscribe_link.c_link_text = 'Subscribe';
+c_subscribe_link.c_link_classes = 'lrv-a-unstyle-button lrv-a-unstyle-link lrv-u-text-transform-uppercase lrv-u-font-family-body lrv-u-font-size-12 lrv-u-font-size-8@mobile-max  lrv-u-color-brand-primary:hover lrv-u-border-b-1 lrv-u-border-color-white lrv-u-border-color-brand-primary:hover';
+
+const c_account_link = clonedeep( c_link_prototype );
+c_account_link.c_link_text = 'Account';
+c_account_link.c_link_classes = 'lrv-u-text-transform-uppercase lrv-u-font-family-body lrv-u-font-size-12 lrv-u-font-size-8@mobile-max  lrv-u-color-brand-primary:hover lrv-u-border-color-white lrv-u-border-color-brand-primary:hover';
+
+const c_got_a_tip = clonedeep( c_link_prototype );
+c_got_a_tip.c_link_text = 'Got A Tip?';
+c_got_a_tip.c_link_classes = 'lrv-a-unstyle-link lrv-u-text-transform-uppercase lrv-u-font-family-body lrv-u-font-size-12 lrv-u-font-size-8@mobile-max  lrv-u-color-brand-primary:hover lrv-u-border-b-1 lrv-u-border-color-white lrv-u-border-color-brand-primary:hover';
+
+const o_account_menu = clonedeep( o_account_menu_prototype );
+
+o_account_menu.c_account_link.c_link_classes  = ' lrv-a-unstyle-link lrv-u-text-transform-uppercase lrv-u-font-family-body lrv-u-font-size-12 lrv-u-font-size-8@mobile-max  lrv-u-color-brand-primary:hover lrv-u-border-b-1 lrv-u-border-color-white lrv-u-border-color-brand-primary:hover lrv-u-margin-tb-025';
+
+module.exports = {
+	c_login_link,
+	c_subscribe_link,
+	o_account_menu,
+	c_got_a_tip,
+	c_account_link,
+	button_wrap: false,
+	show_flyout: true,
+	o_header_button_classes: 'lrv-a-space-children-horizontal lrv-a-space-children--1',
+	got_tip_wrapper_classes: 'lrv-u-border-l-00@mobile-max lrv-u-border-l-1 lrv-u-padding-l-1 lrv-u-padding-tb-025 lrv-u-flex lrv-u-align-items-center lrv-u-margin-tb-025',
+	account_menu_classes: 'lrv-u-flex lrv-u-align-items-center lrv-u-border-l-00@mobile-max lrv-u-border-l-1 lrv-u-padding-l-1 lrv-u-padding-tb-025 lrv-u-margin-tb-025',
+	hide_flyout_classes: ' ',
+	subscribe_wrapper_classes: 'subscribe-link cx-dynamic-link lrv-u-border-l-00@mobile-max lrv-u-border-l-1 lrv-u-padding-l-1 lrv-u-padding-tb-025 lrv-u-margin-tb-025',
+	login_wrapper_classes: 'subscriber-login-link lrv-u-border-l-00@mobile-max lrv-u-border-l-1 lrv-u-padding-l-1 lrv-u-padding-tb-025  lrv-u-margin-tb-025',
+	button_wrap_classes: 'lrv-u-flex lrv-u-flex-direction-column lrv-u-align-items-center lrv-u-border-l-00@mobile-max lrv-u-border-l-1 lrv-u-padding-l-1 lrv-u-margin-tb-025',
+};

package/objects/o-header-buttons/o-header-buttons.twig

@@ -0,0 +1,42 @@
+<div class="lrv-u-flex {{o_header_button_classes}}">
+	<div class="item-wrap // {{ got_tip_wrapper_classes }}">
+		{% include "@larva/components/c-link/c-link.twig" with c_got_a_tip %}
+	</div>
+
+		{% if show_flyout %}
+
+			<div class="item-wrap // {{ account_menu_classes }} ">
+				{% include "@larva/objects/o-account-menu/o-account-menu.twig" with o_account_menu %}
+			</div>
+
+		{% else %}
+
+			<div class="item-wrap // {{ account_menu_classes }} {{ hide_flyout_classes}}">
+				{% include "@larva/components/c-link/c-link.twig" with c_account_link %}
+			</div>
+
+		{% endif %}
+
+		{% if button_wrap %}
+
+			<div class="items-wrap // {{ button_wrap_classes }}">
+				{% if c_subscribe_link %}
+					{% include "@larva/components/c-link/c-link.twig" with c_subscribe_link %}
+				{% endif %}
+
+				{% include "@larva/components/c-link/c-link.twig" with c_login_link %}
+			</div>
+
+		{% else %}
+
+			<div class="item-wrap // {{ subscribe_wrapper_classes }}">
+				{% if c_subscribe_link %}
+					{% include "@larva/components/c-link/c-link.twig" with c_subscribe_link %}
+				{% endif %}
+			</div>
+			<div class="item-wrap // {{ login_wrapper_classes }} ">
+				{% include "@larva/components/c-link/c-link.twig" with c_login_link %}
+			</div>
+
+		{% endif %}
+</div>

package/objects/o-icon-button/README.md

@@ -0,0 +1,5 @@
+The Icon button is comprised of c_icon and c_span. While c_icon and c_span both support URLs, any URL for o-icon-button should be passed using o_icon_button_url. In this case, it will render an anchor tag instead of a button tag.
+
+## Available configurations:
+
+* `o-icon-button.search` – Contains search icon from `c-icon` and no text.

package/objects/o-icon-button/o-icon-button.prototype.js

@@ -0,0 +1,21 @@
+const clonedeep = require( 'lodash.clonedeep' );
+
+const c_span = clonedeep( require( '../../components/c-span/c-span.prototype' ) );
+const c_icon = clonedeep( require( '../../components/c-icon/c-icon.prototype' ) );
+
+c_icon.c_icon_name = 'hamburger';
+c_icon.c_icon_url = false;
+
+c_span.c_span_text = 'Menu';
+c_span.c_span_classes = 'lrv-u-margin-l-050';
+c_span.c_span_url = false;
+
+module.exports = {
+	o_icon_button_classes: 'lrv-a-unstyle-button lrv-a-unstyle-link lrv-u-cursor-pointer lrv-u-flex',
+	o_icon_button_ga_tracking: {}, // by default we do not want to enable any ga tracking
+	o_icon_button_rel_attr: '',
+	o_icon_button_screen_reader_text: '',
+	o_icon_button_target_attr: '',
+	c_icon: c_icon,
+	c_span: c_span,
+};

package/objects/o-icon-button/o-icon-button.search.js

@@ -0,0 +1,9 @@
+const clonedeep = require( 'lodash.clonedeep' );
+
+const o_icon_button_search = clonedeep( require( './o-icon-button.prototype' ) );
+
+o_icon_button_search.c_icon.c_icon_name = 'search';
+o_icon_button_search.o_icon_button_screen_reader_text = 'Click to Expand Search Input';
+o_icon_button_search.c_span = false;
+
+module.exports = o_icon_button_search;

package/objects/o-icon-button/o-icon-button.twig

@@ -0,0 +1,29 @@
+{% if o_icon_button_url %}
+	<a href="{{ o_button_url }}" class="{{ o_icon_button_classes }}" target="{{ o_icon_button_target_attr }}" rel="{{ o_icon_button_rel_attr }}" data-pmc-sp-product="{{ o_icon_button_guid_attr }}" data-category-name="{{ o_icon_button_category_attr }}" {{ wp_action( 'pmc_do_render_custom_ga_tracking_attr', o_icon_button_ga_tracking ) }}>
+{% else %}
+	{% if o_icon_use_span %}
+		<span class="o-icon-button {{ o_icon_button_classes }}">
+	{% else %}
+		<button class="o-icon-button {{ o_icon_button_classes }}">
+	{% endif %}
+{% endif %}
+
+	{% include "@larva/components/c-icon/c-icon.twig" with c_icon %}
+
+	{% if o_icon_button_screen_reader_text %}
+		<span class="lrv-a-screen-reader-only">{{ o_icon_button_screen_reader_text }}</span>
+	{% endif %}
+
+	{% if c_span %}
+		{% include "@larva/components/c-span/c-span.twig" with c_span %}
+	{% endif %}
+
+{% if o_icon_button_url %}
+	</a>
+{% else %}
+	{% if o_icon_use_span %}
+		</span>
+	{% else %}
+		</button>
+	{% endif %}
+{% endif %}

package/objects/o-indicator/README.md

@@ -0,0 +1 @@
+The indicator object supports `c-span` and/or `c-icon`. It is useful for arbitrary icons or text that visually support other elements, for example, the "Photos" or "Video" indication stuck to the image in a `story` excerpt. Works nicely with `a-glue`.

package/objects/o-indicator/o-indicator.photos.js

@@ -0,0 +1,12 @@
+const clonedeep = require( 'lodash.clonedeep' );
+
+const o_indicator = clonedeep( require( './o-indicator.prototype' ) );
+const c_icon = clonedeep( require( '../../components/c-icon/c-icon.prototype' ) );
+
+o_indicator.c_icon = clonedeep( c_icon );
+o_indicator.c_icon.c_icon_name = 'gallery';
+o_indicator.c_span.c_span_text = 'Photos';
+o_indicator.c_span.c_span_classes += ' lrv-u-margin-l-050 lrv-u-text-transform-uppercase lrv-a-font-secondary-s';
+o_indicator.o_indicator_classes += ' lrv-u-flex lrv-u-background-color-black lrv-u-color-white lrv-u-padding-a-050 lrv-u-border-radius-5 lrv-u-margin-a-050';
+
+module.exports = o_indicator;

package/objects/o-indicator/o-indicator.prototype.js

@@ -0,0 +1,8 @@
+const clonedeep = require( 'lodash.clonedeep' );
+
+const c_span = clonedeep( require( '../../components/c-span/c-span.prototype.js' ) );
+
+module.exports = {
+	o_indicator_classes: 'lrv-a-glue lrv-a-glue--b-0 lrv-a-glue--r-0 u-pointer-events-none',
+	c_span: c_span
+};

package/objects/o-indicator/o-indicator.twig

@@ -0,0 +1,9 @@
+<span class="o-indicator {{ o_indicator_classes }}">
+	{% if c_icon %}
+		{% include "@larva/components/c-icon/c-icon.twig" with c_icon %}
+	{% endif %}
+
+	{% if c_span %}
+		{% include "@larva/components/c-span/c-span.twig" with c_span %}
+	{% endif %}
+</span>

package/objects/o-input-group/o-input-group.prototype.js

@@ -0,0 +1,11 @@
+const clonedeep = require( 'lodash.clonedeep' );
+const c_input = clonedeep(require('@penskemediacorp/larva-patterns/components/c-input/c-input.prototype'));
+
+module.exports = {
+	o_input_group_class: '',
+	o_input_group_items: [
+		c_input,
+		c_input,
+		c_input
+	]
+};

package/objects/o-input-group/o-input-group.twig

@@ -0,0 +1,5 @@
+<div class="o-input-group {{ o_input_group_class }}">
+	{% for item in o_input_group_items %}
+		{% include "@larva/components/c-input/c-input.twig" with item %}
+	{% endfor %}
+</div>

package/objects/o-nav/README.md

@@ -1,3 +1,3 @@
-# Nav
+o-nav is an object with a `nav` element containing an unordered list with list items in a for loop that contain an instance of `c-link`. It contains an optional `h4` list title. o-nav is useful for menus with several items, and the ability to apply utilities to all `li`s inside the loop with a single key can useful.
 
-The Nav object is an HTML pattern with a `nav` element containing an unordered list, and an optional `h4` list title.
+In general, o-nav should be used for internal site links. It can be adapted to work with the JS pattern `MobileHeightToggle`. See the footer-menus module for an example.

package/objects/o-nav/o-nav.horizontal.js

@@ -1,8 +1,8 @@
-const path = require( 'path' );
-const clone = require( '../../../larva/lib/utils/clonePatternData' );// This should be in this repo, probably
-const o_nav = clone( path.resolve( __dirname, '../../objects/o-nav/o-nav.prototype' ) );
+const clonedeep = require( 'lodash.clonedeep' );
 
-o_nav.o_nav_classes = 'pmc-u-flex';
-o_nav.o_nav_list_classes += ' pmc-u-flex pmc-a-space-children-horizontal pmc-a-space-children--1 pmc-u-align-items-center pmc-u-font-family-primary pmc-u-a-unstyle-list';
+const o_nav = clonedeep( require( '../../objects/o-nav/o-nav.prototype' ) );
 
-module.exports = o_nav;
+o_nav.o_nav_classes = 'lrv-u-flex';
+o_nav.o_nav_list_classes += ' lrv-u-flex lrv-a-space-children-horizontal lrv-a-space-children--1 lrv-u-align-items-center lrv-u-a-unstyle-list';
+
+module.exports = o_nav;

package/objects/o-nav/o-nav.prototype.js

@@ -1,19 +1,23 @@
-const path = require( 'path' );
-const clone = require( '../../../larva/lib/utils/clonePatternData' );// This should be in this repo, probably
-const c_link = path.resolve( __dirname, '../../components/c-link/c-link.prototype' );
+const clonedeep = require( 'lodash.clonedeep' );
+const c_link_prototype = require( '../../components/c-link/c-link.prototype' );
 
 const o_nav_list_items = [
-	clone( c_link ),
-	clone( c_link ),
-	clone( c_link )
+	clonedeep( c_link_prototype ),
+	clonedeep( c_link_prototype ),
+	clonedeep( c_link_prototype )
 ];
 
 module.exports = {
-	"modifier_class": "",
-	"o_nav_classes": "",
-	"o_nav_title_text": "",
-	"o_nav_title_classes": "",
-	"o_nav_list_classes" : "pmc-a-unstyle-list",
-	"o_nav_list_item_classes": "",
-	"o_nav_list_items": o_nav_list_items
+	modifier_class: '',
+	o_nav_classes: '',
+	o_nav_title_text: '',
+	o_nav_title_id_attr: '',
+	o_nav_title_classes: '',
+	o_nav_aria_labelledby_attr: '',
+	o_nav_screen_reader_id_attr: 'optional-screen-reader',
+	o_nav_screen_reader_text: 'optional screen reader',
+	o_nav_list_classes: 'lrv-a-unstyle-list',
+	o_nav_list_item_classes: '',
+	o_nav_list_items: o_nav_list_items,
+	o_nav_list_labelledby_attr: ''
 };

package/objects/o-nav/o-nav.twig

@@ -1,10 +1,36 @@
-<nav class="o-nav {{ modifier_class }} {{ o_nav_classes }}">
+{% if o_nav_screen_reader_text %}
+	<h2 id="{{ o_nav_screen_reader_id_attr }}" class="lrv-a-screen-reader-only">
+		{{ o_nav_screen_reader_text }}
+	</h2>
+{% endif %}
+<nav class="o-nav {{ modifier_class }} {{ o_nav_classes }}" data-dropdown="{{ o_nav_data_attributes }}"
+	{% if o_nav_title_id_attr %}
+		aria-label="{{ o_nav_title_id_attr }}"
+	{% endif %}
+	{% if o_nav_aria_labelledby_attr %}
+		aria-labelledby="{{ o_nav_aria_labelledby_attr }}"
+	{% endif %}
+>
 
 	{% if o_nav_title_text %}
-		<h4 id="{{ o_nav_title_id_attr }}" class="o-nav__title {{ o_nav_title_classes }}">{{ o_nav_title_text }}</h4>
+		{% if o_nav_title_outer %}
+			<div class="o-nav__title-outer {{ o_nav_title_outer_classes }}">
+		{% endif %}
+				{% if o_nav_tag_text %}
+					<{{ o_nav_tag_text }} id="{{ o_nav_title_id_attr }}" class="o-nav__title {{ o_nav_title_classes }}">{{ o_nav_title_text }}</{{ o_nav_tag_text }}>
+				{% else %}
+					<h4 id="{{ o_nav_title_id_attr }}" class="o-nav__title {{ o_nav_title_classes }}">{{ o_nav_title_text }}</h4>
+				{% endif %}
+		{% if o_nav_title_outer %}
+			</div>
+		{% endif %}
 	{% endif %}
 
-	<ul class="o-nav__list {{ o_nav_list_classes }}" aria-labelledby="{{ o_nav_title_id_attr }}">
+	<ul class="o-nav__list {{ o_nav_list_classes }}"
+		{% if o_nav_list_labelledby_attr %}
+			aria-labelledby="{{ o_nav_list_labelledby_attr }}"
+		{% endif %}
+	>
 		{% for item in o_nav_list_items %}
 			<li class="o-nav__list-item {{ o_nav_list_item_classes }}">
 				{% include "@larva/components/c-link/c-link.twig" with item %}

package/objects/o-select-nav/o-select-nav.prototype.js

@@ -0,0 +1,17 @@
+const clonedeep = require( 'lodash.clonedeep' );
+
+const c_button = clonedeep( require( '../../components/c-button/c-button.prototype' ) );
+const c_select_option = clonedeep( require( '../../components/c-select-option/c-select-option.prototype' ) );
+
+c_button.c_button_text = 'Click Me';
+
+module.exports = {
+	o_select_nav_classes: '',
+	o_select_nav_select_classes: '',
+	c_button: c_button,
+	o_select_nav_options: [
+		c_select_option,
+		c_select_option,
+		c_select_option
+	]
+};

package/objects/o-select-nav/o-select-nav.twig

@@ -0,0 +1,9 @@
+<div class="o-select-nav js-SelectNav js-SelectNav-redirect lrv-a-glue-parent {{ o_select_nav_classes }}">
+	{% include "@larva/components/c-button/c-button.twig" with c_button %}
+
+	<select class="o-select-nav__select js-SelectNav-select lrv-u-cursor-pointer lrv-a-glue lrv-a-glue--t-0 lrv-a-glue--l-0 lrv-u-width-100p lrv-u-height-100p lrv-u-opacity-0 {{ o_select_nav_select_classes }}">
+		{% for item in o_select_nav_options %}
+			{% include "@larva/components/c-select-option/c-select-option.twig" with item %}
+		{% endfor %}
+	</select>
+</div>

package/objects/o-social-list/o-social-list.prototype.js

@@ -1,33 +1,23 @@
+const clonedeep = require( 'lodash.clonedeep' );
+
+const c_icon_prototype = require( '../../components/c-icon/c-icon.prototype' );
+
+const social = [ 'instagram', 'pinit', 'twitter', 'facebook', 'youtube' ];
+const o_social_list_icons = [];
+
+for ( let i = 0; i < social.length; i++ ) {
+	let c_icon = clonedeep( c_icon_prototype );
+
+	c_icon.c_icon_url = '#';
+	c_icon.c_icon_name = social[i];
+	c_icon.c_icon_link_classes += ' lrv-u-display-block lrv-u-border-radius-50p lrv-u-color-grey lrv-u-margin-lr-050 lrv-u-padding-a-050 lrv-u-background-color-white lrv-u-color-grey-dark:hover';
+	c_icon.c_icon_rel_name = 'noopener noreferrer';
+
+	o_social_list_icons.push( c_icon );
+}
+
 module.exports = {
-	"o_social_list_classes": "pmc-a-unstyle-list",
-	"o_social_list_icons": [
-		{
-			"c_icon_classes": "c-icon--bubble",
-			"c_icon_name": "facebook",
-			"c_icon_url": "https://www.facebook.com/deadlinehollywood/",
-			"c_icon_link_classes": "pmc-u-background-white pmc-u-padding-a-1 pmc-u-color-brand-red u-display-block u-border-radius-50p u-color-brand-red-dark:hover",
-			"c_icon_rel_name": "noopener noreferrer"
-		},
-		{
-			"c_icon_classes": "c-icon--bubble",
-			"c_icon_name": "twitter",
-			"c_icon_url": "https://twitter.com/DEADLINE",
-			"c_icon_link_classes": "pmc-u-background-white pmc-u-padding-a-1 pmc-u-color-brand-red u-display-block u-border-radius-50p u-color-brand-red-dark:hover",
-			"c_icon_rel_name": "noopener noreferrer"
-		},
-		{
-			"c_icon_classes": "c-icon--bubble",
-			"c_icon_name": "youtube",
-			"c_icon_url": "https://www.youtube.com/user/deadlinecom/",
-			"c_icon_link_classes": "pmc-u-background-white pmc-u-padding-a-1 pmc-u-color-brand-red u-display-block u-border-radius-50p u-color-brand-red-dark:hover",
-			"c_icon_rel_name": "noopener noreferrer"
-		},
-		{
-			"c_icon_classes": "c-icon--bubble",
-			"c_icon_name": "instagram",
-			"c_icon_url": "https://www.instagram.com/deadline/",
-			"c_icon_link_classes": "pmc-u-background-white pmc-u-padding-a-1 pmc-u-color-brand-red u-display-block u-border-radius-50p u-color-brand-red-dark:hover",
-			"c_icon_rel_name": "noopener noreferrer"
-		}
-	]
+	o_social_list_classes: 'lrv-a-unstyle-list',
+	o_social_list_labelledby_attr: '',
+	o_social_list_icons: o_social_list_icons
 };

package/objects/o-social-list/o-social-list.twig

@@ -1,7 +1,15 @@
-<ul class="o-social-list {{ modifier_class }} {{ o_social_list_classes }}">
+<ul class="o-social-list {{ modifier_class }} {{ o_social_list_classes }}"
+	{% if o_social_list_labelledby_attr %}
+		aria-labelledby="{{ o_social_list_labelledby_attr }}"
+	{% endif %}
+>
 	{% for item in o_social_list_icons %}
 		<li class="o-social-list__item {{ o_social_list_item_classes }}">
-			{% include "@larva/components/c-icon/c-icon.twig" with item %}
+			{% if o_social_list_is_icon_button %}
+				{% include "@larva/objects/o-icon-button/o-icon-button.twig" with item %}
+			{% else %}
+				{% include "@larva/components/c-icon/c-icon.twig" with item %}
+			{% endif %}
 		</li>
 	{% endfor %}
 </ul>

package/objects/o-span-group/README.md

@@ -0,0 +1 @@
+`o-span-group` consists of a `div` containing an interderminate numer of `c-span`s. This can be useful for arbitrary decorative borders around single word links, or similar.

package/objects/o-span-group/o-span-group.prototype.js

@@ -0,0 +1,11 @@
+const clonedeep = require( 'lodash.clonedeep' );
+
+const c_span = clonedeep( require( '../../components/c-span/c-span.prototype' ) );
+
+module.exports = {
+	o_span_group_classes: '',
+	o_span_group_items: [
+		c_span,
+		c_span
+	]
+};

package/objects/o-span-group/o-span-group.twig

@@ -0,0 +1,5 @@
+<div class="o-span-group {{ o_span_group_classes }}">
+	{% for item in o_span_group_items %}
+		{% include "@larva/components/c-span/c-span.twig" with item %}
+	{% endfor %}
+</div>