@openeuropa/bcl-twig-templates 0.28.1 → 1.0.0

package/package.json

@@ -2,75 +2,75 @@
   "name": "@openeuropa/bcl-twig-templates",
   "author": "European Commission",
   "license": "EUPL-1.2",
-  "version": "0.28.1",
+  "version": "1.0.0",
   "description": "OE Bcl Twig Templates",
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
-    "@openeuropa/bcl-accordion": "^0.28.1",
-    "@openeuropa/bcl-alert": "^0.28.1",
-    "@openeuropa/bcl-badge": "^0.28.1",
-    "@openeuropa/bcl-banner": "^0.28.1",
-    "@openeuropa/bcl-base-templates": "^0.28.1",
-    "@openeuropa/bcl-blockquote": "^0.28.1",
-    "@openeuropa/bcl-breadcrumb": "^0.28.1",
-    "@openeuropa/bcl-button": "^0.28.1",
-    "@openeuropa/bcl-button-group": "^0.28.1",
-    "@openeuropa/bcl-card": "^0.28.1",
-    "@openeuropa/bcl-card-layout": "^0.28.1",
-    "@openeuropa/bcl-carousel": "^0.28.1",
-    "@openeuropa/bcl-contact-form": "^0.28.1",
-    "@openeuropa/bcl-content-banner": "^0.28.1",
-    "@openeuropa/bcl-date-block": "^0.28.1",
-    "@openeuropa/bcl-description-list": "^0.28.1",
-    "@openeuropa/bcl-dropdown": "^0.28.1",
-    "@openeuropa/bcl-event": "^0.28.1",
-    "@openeuropa/bcl-fact-figures": "^0.28.1",
-    "@openeuropa/bcl-featured-media": "^0.28.1",
-    "@openeuropa/bcl-file": "^0.28.1",
-    "@openeuropa/bcl-footer": "^0.28.1",
-    "@openeuropa/bcl-form": "^0.28.1",
-    "@openeuropa/bcl-form-input": "^0.28.1",
-    "@openeuropa/bcl-gallery": "^0.28.1",
-    "@openeuropa/bcl-glossary": "^0.28.1",
-    "@openeuropa/bcl-group": "^0.28.1",
-    "@openeuropa/bcl-header": "^0.28.1",
-    "@openeuropa/bcl-heading": "^0.28.1",
-    "@openeuropa/bcl-icon": "^0.28.1",
-    "@openeuropa/bcl-inpage-navigation": "^0.28.1",
-    "@openeuropa/bcl-landing-page": "^0.28.1",
-    "@openeuropa/bcl-language-list": "^0.28.1",
-    "@openeuropa/bcl-language-switcher": "^0.28.1",
-    "@openeuropa/bcl-link": "^0.28.1",
-    "@openeuropa/bcl-links-block": "^0.28.1",
-    "@openeuropa/bcl-list-group": "^0.28.1",
-    "@openeuropa/bcl-listing": "^0.28.1",
-    "@openeuropa/bcl-modal": "^0.28.1",
-    "@openeuropa/bcl-multilingual": "^0.28.1",
-    "@openeuropa/bcl-navbar": "^0.28.1",
-    "@openeuropa/bcl-navigation": "^0.28.1",
-    "@openeuropa/bcl-news": "^0.28.1",
-    "@openeuropa/bcl-offcanvas": "^0.28.1",
-    "@openeuropa/bcl-page": "^0.28.1",
-    "@openeuropa/bcl-pagination": "^0.28.1",
-    "@openeuropa/bcl-person": "^0.28.1",
-    "@openeuropa/bcl-placeholder": "^0.28.1",
-    "@openeuropa/bcl-progress": "^0.28.1",
-    "@openeuropa/bcl-project": "^0.28.1",
-    "@openeuropa/bcl-project-status": "^0.28.1",
-    "@openeuropa/bcl-recent-activities": "^0.28.1",
-    "@openeuropa/bcl-search": "^0.28.1",
-    "@openeuropa/bcl-search-form": "^0.28.1",
-    "@openeuropa/bcl-select": "^0.28.1",
-    "@openeuropa/bcl-spinner": "^0.28.1",
-    "@openeuropa/bcl-subscription": "^0.28.1",
-    "@openeuropa/bcl-subscription-block": "^0.28.1",
-    "@openeuropa/bcl-table": "^0.28.1",
-    "@openeuropa/bcl-textarea": "^0.28.1",
-    "@openeuropa/bcl-timeline": "^0.28.1",
-    "@openeuropa/bcl-toast": "^0.28.1",
-    "@openeuropa/bcl-user": "^0.28.1",
+    "@openeuropa/bcl-accordion": "^1.0.0",
+    "@openeuropa/bcl-alert": "^1.0.0",
+    "@openeuropa/bcl-badge": "^1.0.0",
+    "@openeuropa/bcl-banner": "^1.0.0",
+    "@openeuropa/bcl-base-templates": "^1.0.0",
+    "@openeuropa/bcl-blockquote": "^1.0.0",
+    "@openeuropa/bcl-breadcrumb": "^1.0.0",
+    "@openeuropa/bcl-button": "^1.0.0",
+    "@openeuropa/bcl-button-group": "^1.0.0",
+    "@openeuropa/bcl-card": "^1.0.0",
+    "@openeuropa/bcl-card-layout": "^1.0.0",
+    "@openeuropa/bcl-carousel": "^1.0.0",
+    "@openeuropa/bcl-contact-form": "^1.0.0",
+    "@openeuropa/bcl-content-banner": "^1.0.0",
+    "@openeuropa/bcl-date-block": "^1.0.0",
+    "@openeuropa/bcl-description-list": "^1.0.0",
+    "@openeuropa/bcl-dropdown": "^1.0.0",
+    "@openeuropa/bcl-event": "^1.0.0",
+    "@openeuropa/bcl-fact-figures": "^1.0.0",
+    "@openeuropa/bcl-featured-media": "^1.0.0",
+    "@openeuropa/bcl-file": "^1.0.0",
+    "@openeuropa/bcl-footer": "^1.0.0",
+    "@openeuropa/bcl-form": "^1.0.0",
+    "@openeuropa/bcl-form-input": "^1.0.0",
+    "@openeuropa/bcl-gallery": "^1.0.0",
+    "@openeuropa/bcl-glossary": "^1.0.0",
+    "@openeuropa/bcl-group": "^1.0.0",
+    "@openeuropa/bcl-header": "^1.0.0",
+    "@openeuropa/bcl-heading": "^1.0.0",
+    "@openeuropa/bcl-icon": "^1.0.0",
+    "@openeuropa/bcl-inpage-navigation": "^1.0.0",
+    "@openeuropa/bcl-landing-page": "^1.0.0",
+    "@openeuropa/bcl-language-list": "^1.0.0",
+    "@openeuropa/bcl-language-switcher": "^1.0.0",
+    "@openeuropa/bcl-link": "^1.0.0",
+    "@openeuropa/bcl-links-block": "^1.0.0",
+    "@openeuropa/bcl-list-group": "^1.0.0",
+    "@openeuropa/bcl-listing": "^1.0.0",
+    "@openeuropa/bcl-modal": "^1.0.0",
+    "@openeuropa/bcl-multilingual": "^1.0.0",
+    "@openeuropa/bcl-navbar": "^1.0.0",
+    "@openeuropa/bcl-navigation": "^1.0.0",
+    "@openeuropa/bcl-news": "^1.0.0",
+    "@openeuropa/bcl-offcanvas": "^1.0.0",
+    "@openeuropa/bcl-page": "^1.0.0",
+    "@openeuropa/bcl-pagination": "^1.0.0",
+    "@openeuropa/bcl-person": "^1.0.0",
+    "@openeuropa/bcl-placeholder": "^1.0.0",
+    "@openeuropa/bcl-progress": "^1.0.0",
+    "@openeuropa/bcl-project": "^1.0.0",
+    "@openeuropa/bcl-project-status": "^1.0.0",
+    "@openeuropa/bcl-recent-activities": "^1.0.0",
+    "@openeuropa/bcl-search": "^1.0.0",
+    "@openeuropa/bcl-search-form": "^1.0.0",
+    "@openeuropa/bcl-select": "^1.0.0",
+    "@openeuropa/bcl-spinner": "^1.0.0",
+    "@openeuropa/bcl-subscription": "^1.0.0",
+    "@openeuropa/bcl-subscription-block": "^1.0.0",
+    "@openeuropa/bcl-table": "^1.0.0",
+    "@openeuropa/bcl-textarea": "^1.0.0",
+    "@openeuropa/bcl-timeline": "^1.0.0",
+    "@openeuropa/bcl-toast": "^1.0.0",
+    "@openeuropa/bcl-user": "^1.0.0",
     "copyfiles": "2.4.1",
     "rimraf": "3.0.2"
   },
@@ -93,5 +93,5 @@
     "design-system",
     "twig"
   ],
-  "gitHead": "3b0d2f4a85c727f38ae4e3403110c98302d09117"
+  "gitHead": "16b986722345644e83a37dc8091c07eecbdf4c8c"
 }

package/templates/bcl-accordion/accordion.html.twig

@@ -25,7 +25,7 @@
 {% set _title_link = title_link|default({}) %}
 {% set _title_attributes = title_attributes ?: create_attribute() %}
 {% set _id = id|default(random(1000)) %}
-{% set _flush = flush|default(false) %}
+{% set _flush = flush ?? false %}
 {% set _items = items|default([]) %}
 {% set _open_item_id = open_item_id|default(0) %}
 {% set _classes = ['accordion'] %}

package/templates/bcl-badge/badge.html.twig

@@ -4,7 +4,7 @@
   - label (string) (default: '')
   - background: (string) (default: 'primary')
   - url (string) (default: '')
-  - title (string) (default: label)
+  - title (string) (default: '')
   - dismissible (boolean) (default: false)
   - assistive_text (string) (default: '')
   - rounded_pill (boolean) (default: false)
@@ -16,13 +16,12 @@
 {% set _label = label|default('') %}
 {% set _background = background|default('primary') %}
 {% set _url = url|default('') %}
-{% set _title = title|default(_label) %}
-{% set _dismissible = dismissible|default(false) %}
+{% set _title = title|default('') %}
+{% set _dismissible = dismissible ?? false %}
 {% set _assistive_text = assistive_text|default('') %}
 {% set _rounded_pill = rounded_pill|default(false) %}
 {% set _outline = outline|default(false) %}
 {% set _icon_path = icon_path|default('') %}
-
 {% set _classes = ['badge'] %}
 
 {% if _rounded_pill %}
@@ -30,47 +29,49 @@
 {% endif %}
 
 {% if _outline %}
-  {% set _classes = _classes|merge([ 'badge-outline-' ~ _background]) %}
+  {% set _classes = _classes|merge(['badge-outline-' ~ _background]) %}
 {% else %}
-  {% set _classes = _classes|merge([ 'bg-' ~ _background]) %}
+  {% set _classes = _classes|merge(['bg-' ~ _background]) %}
 {% endif %}
 
 {% if attributes is empty %}
   {% set attributes = create_attribute() %}
 {% endif %}
 
-{%- if _url is not empty -%}
-  {% set attributes = attributes.setAttribute('title', _title).setAttribute('href', _url) %}
+{%- if _title is not empty -%}
+  {% set attributes = attributes.setAttribute('title', _title) %}
 {%- endif -%}
 
 {% set attributes = attributes.addClass(_classes) %}
 
-{%- if _url is not empty -%}
-<a
-  {{ attributes }}
->
-{%- else -%}
-<span
-  {{ attributes }}
->
-{%- endif -%}
+{% set _label %}
   {%- if _assistive_text is not empty -%}
-    <span class="visually-hidden">
-      {{- _assistive_text -}}
-    </span>
+  <span class="visually-hidden">
+    {{- _assistive_text -}}
+  </span>
   {%- endif -%}
-    {{- _label -}}
+  {{- _label -}}
   {%- if _dismissible -%}
-    <span class="icon--close" aria-hidden="true">
-      {% include '@oe-bcl/bcl-icon/icon.html.twig' with {
-        name: "x-lg",
-        path: _icon_path,
-      } only %}
-    </span>
+  <span class="icon--close" aria-hidden="true">
+    {% include '@oe-bcl/bcl-icon/icon.html.twig' with {
+      name: "x-lg",
+      path: _icon_path,
+    } only %}
+  </span>
   {%- endif -%}
+{% endset %}
+
 {%- if _url is not empty -%}
-</a>
+  {% include '@oe-bcl/bcl-link/link.html.twig' with {
+    label: _label,
+    path: _url,
+    attributes: attributes,
+  } only %}
 {%- else -%}
+<span
+  {{ attributes }}
+>
+  {{- _label -}}
 </span>
 {%- endif -%}
 

package/templates/bcl-banner/banner.html.twig

@@ -6,7 +6,7 @@
   - title_link: (link object) (default: {})
   - title_attributes (drupal attrs)
   - description: (string) (default: '')
-  - link: (link object) (default: {}): predefined structure for Link component
+  - link: (link object) (default: {})
   - image: (string) <img> tag
   - shade: (boolean) (default: false)
   - hero: (boolean) (default: false)
@@ -22,9 +22,9 @@
 {% set _description = description|default('') %}
 {% set _link = link|default({}) %}
 {% set _image = image|default('') %}
-{% set _shade = shade|default(false) %}
-{% set _hero = hero|default(false) %}
-{% set _full_width = full_width|default(false) %}
+{% set _shade = shade ?? false %}
+{% set _hero = hero ?? false %}
+{% set _full_width = full_width ?? false %}
 {% set _content_classes = content_classes|default('') %}
 
 {% set _content_class = 'bcl-banner__content' %}

package/templates/bcl-base-templates/content-type.html.twig

@@ -25,12 +25,12 @@
   - messages_area
 #}
 
-{% set _with_header = header|default(false) %}
-{% set _with_footer = footer|default(false) %}
-{% set _with_banner = banner|default(false) %}
-{% set _with_sidebar = sidebar|default(false) %}
+{% set _with_header = header ?? false %}
+{% set _with_footer = footer ?? false %}
+{% set _with_banner = banner ?? false %}
+{% set _with_sidebar = sidebar ?? false %}
 {% set _sidebar_size = sidebar_size|default('normal') %}
-{% set _landing = landing|default(false) %}
+{% set _landing = landing ?? false %}
 {% set _content_type = content_type|default('') %}
 {% set _classes = ['bcl-node-type'] %}
 

package/templates/bcl-breadcrumb/breadcrumb.html.twig

@@ -1,7 +1,7 @@
 {% apply spaceless %}
 
 {# Parameters:
-  - links (array of objects of type link) (default: [])
+  - links (link[]) (default: [])
   - icon_path (string) (default: '')
   - attributes (drupal attrs)
 #}

package/templates/bcl-button/button.html.twig

@@ -12,7 +12,7 @@
   - text_nowrap (boolean) (default: false)
   - assistive_text (string) (default: '')
   - id (string) (default: '')
-  - icon (icon object) (default: {}): predefined structure for Icon component
+  - icon (icon object) (default: {})
   - icon_position (string) (default: after)
     - options ['after', 'before']
   - icon_spacing (string) (default: '')
@@ -27,17 +27,17 @@
 {% set _variant = variant|default('primary') %}
 {% set _size = size|default('md') %}
 {% set _type = type|default('button') %}
-{% set _outline = outline|default(false) %}
-{% set _disabled = disabled|default(false) %}
-{% set _text_nowrap = text_nowrap|default(false) %}
+{% set _outline = outline ?? false %}
+{% set _disabled = disabled ?? false %}
+{% set _text_nowrap = text_nowrap ?? false %}
 {% set _assistive_text = assistive_text|default('') %}
 {% set _id = id|default('') %}
 {% set _icon = icon|default({}) %}
 {% set _icon_position = icon_position|default('after') %}
 {% set _icon_spacing = icon_spacing|default('') %}
 {% set _spinner = spinner|default({}) %}
-{% set _show_spinner = show_spinner|default(false) %}
-{% set _clean_class = clean_class|default(false) %}
+{% set _show_spinner = show_spinner ?? false %}
+{% set _clean_class = clean_class ?? false %}
 
 {% set _classes = [] %}
 {% if _clean_class == false %}

package/templates/bcl-button-group/button-group.html.twig

@@ -7,14 +7,14 @@
   - aria_label (string) (default: '')
   - toolbar (boolean) (default: false)
   - toolbar_aria_label (string) (default: '')
-  - items (array of arrays with objects of type button or form-input (input key mandatory when the object is a form-input)) (default: [])
+  - items (button[] or input[] - if input key is present) (default: [])
   - attributes (drupal attrs)
 #}
 
-{% set _vertical = vertical|default(false) %}
+{% set _vertical = vertical ?? false %}
 {% set _size = size|default('md') %}
 {% set _aria_label = aria_label|default('') %}
-{% set _toolbar = toolbar|default(false) %}
+{% set _toolbar = toolbar ?? false %}
 {% set _toolbar_aria_label = toolbar_aria_label|default('') %}
 {% set _items = items|default([]) %}
 

package/templates/bcl-card/card.html.twig

@@ -24,14 +24,13 @@
       alt (string),
       position (string)
     }
-  - date (object) (default: {})
+  - date (date block object) (default: {})
   - variant (string) (default: '')
   - horizontal (boolean) (default: false)
   - horizontal_grid (object) (default: {})
     format: {
       left_col_classes (default: 'bcl-card-start-col')
       right_col_classes (default: 'col')
-      gutter (default: '')
       gutter (default: '') - options: ['small', 'large']
     }
   - border_variant (string) (default: '')
@@ -42,7 +41,7 @@
   - extra_classes_body (string) (default: '')
   - extra_classes_header (string) (default: '')
   - extra_classes_footer (string) (default: '')
-  - badges (array of badge object) (default: [])
+  - badges (badge[]) (default: [])
   - links (array of link object) (default: [])
   - attributes (drupal attrs)
 
@@ -62,7 +61,7 @@
 {% set _image = image|default({}) %}
 {% set _date = date|default({}) %}
 {% set _variant = variant|default('') %}
-{% set _horizontal = horizontal|default(false) %}
+{% set _horizontal = horizontal ?? false %}
 {% set _horizontal_grid = horizontal_grid|default({
   left_col_classes: 'bcl-card-start-col',
   right_col_classes: 'col',

package/templates/bcl-card-layout/card-layout.html.twig

@@ -3,7 +3,7 @@
 {# Parameters:
   - type (string) (default: 'group')
     options: ['group', 'grid', 'masonry']
-  - items (array of object type card) (default: [])
+  - items (card[]) (default: [])
   - grid_columns (int) (default: 1)
     options: ['1', '2', '3']
   - responsiveness (string) (default: '')
@@ -26,7 +26,7 @@
 {% set _responsiveness = responsiveness|default('md') %}
 {% set _responsive_columns = responsive_columns|default('') %}
 {% set _gutter = gutter|default('') %}
-{% set _equal_height = equal_height|default(false) %}
+{% set _equal_height = equal_height ?? false %}
 {% set _cols_extra_classes = cols_extra_classes|default('') %}
 
 {% set _cols_classes = 'col' %}

package/templates/bcl-carousel/carousel.html.twig

@@ -9,7 +9,7 @@
   - autoplay (boolean) (default: true)
   - dark (boolean) (default: false)
   - active_item (integer) (default: 1)
-  - items (array of objects) format: [
+  - items (object[]) format: [
      {
       image: (string) <img> tag
       caption (string)
@@ -34,16 +34,16 @@
 {% set _title_attributes = title_attributes ?: create_attribute() %}
 {% set _id = id|default('') %}
 {% set _autoplay = autoplay ?? true %}
-{% set _dark = dark|default(false) %}
+{% set _dark = dark ?? false %}
 {% set _active_item = active_item|default(1) %}
 {% set _items = items|default([]) %}
-{% set _fade = fade|default(false) %}
+{% set _fade = fade ?? false %}
 {% set _with_controls = with_controls ?? true %}
 {% set _prev_label = prev_label|default('') %}
 {% set _next_label = next_label|default('') %}
-{% set _with_indicators = with_indicators|default(false) %}
-{% set _rounded_indicators = rounded_indicators|default(false) %}
-{% set _disable_touch = disable_touch|default(false) %}
+{% set _with_indicators = with_indicators ?? false %}
+{% set _rounded_indicators = rounded_indicators ?? false %}
+{% set _disable_touch = disable_touch ?? false %}
 
 {% set _classes = ['carousel', 'slide'] %}
 
@@ -122,10 +122,7 @@
     {% if _item.image is defined and _item.image is not empty %}
       {{ _item.image }}
     {% endif %}
-    {% if (_item.caption is defined and _item.caption is not empty) or 
-          (_item.link is defined and _item.link is not empty) or 
-          (_item.caption_title is defined and _item.caption_title is not empty)
-    %}
+    {% if (_item.caption is defined and _item.caption is not empty) or (_item.link is defined and _item.link is not empty) or (_item.caption_title is defined and _item.caption_title is not empty) %}
       {% set _caption_classes = 'carousel-caption' %}
       {% if _item.caption is not empty and _item.link is empty %}
         {% set _caption_classes = _caption_classes ~ ' d-none d-md-block' %}

package/templates/bcl-content-banner/content-banner.html.twig

@@ -3,18 +3,33 @@
 {#
   Parameters:
     - title: (string) (default: '')
-    - title_tag: (string) (default: 'h5')
+    - title_tag: (string) (default: 'h1')
     - title_link: (link object) (default: {})
     - title_attributes: (drupal attrs)
     - background: (string) (default: 'white')
       options: [ white, gray ]
-    - image (object)
-    - image_size: (string)
-    - date: (object)
-      options: ['sm', 'md', 'lg', 'xl']
-    - content: (string)
-    - badges: (array of objects of type badge)
-    - links: (array of objects of type link)
+    - image (object) (default: {})
+    - image_size: (string) (default: 'md')
+      options: ['md', 'lg', 'xl']
+    - date: (date block object) (default: {})
+
+    Card inheritance
+      - badges (badge[]) (default: [])
+      - links (link[]) (default: [])
+      - content (string) (default: '')
+      - subtitle (object) (default: {})
+        format: {
+          content: '',
+          tag: '',
+          classes: ''
+        }
+      - text (object) (default: {})
+        format: {
+          content: '',
+          tag: '',
+          classes: ''
+        }
+
     - attributes: (drupal attrs)
 
   Blocks

package/templates/bcl-description-list/description-list.html.twig

@@ -10,8 +10,8 @@
   - col_classes (string) (default: 'col-3')
   - items (array) (default: []): format: [
       {
-        term (string or array of descriptionListTitle object)
-        definition (string or array of descriptionListDetails object)
+        term (string or description list title [])
+        definition (string or description list details [])
       },
       ...
     ]
@@ -22,11 +22,10 @@
 {% set _title = title|default('') %}
 {% set _title_tag = title_tag|default('h2') %}
 {% set _title_link = title_link|default({}) %}
-{% set _bordered = bordered|default(false) %}
-{% set _title_link = title_link|default({}) %}
 {% set _title_attributes = title_attributes ?: create_attribute() %}
-{% set _items = items|default([]) %}
+{% set _bordered = bordered ?? false %}
 {% set _col_classes = col_classes|default('col-md-3') %}
+{% set _items = items|default([]) %}
 {% set _variant = variant|default('') %}
 
 {% if attributes is empty %}

package/templates/bcl-dropdown/dropdown.html.twig

@@ -1,8 +1,8 @@
 {% apply spaceless %}
 
 {# Parameters:
-  - id (string) (default: 'dropdown-' random(1000))
-  - trigger (object of Button or Link component)
+  - id (string) (default: dropdown-random(1000))
+  - trigger (link or button)
   - link (boolean) (default: false)
   - direction (string) (default: '')
     - options ['dropup', 'dropend', 'dropstart']
@@ -23,10 +23,10 @@
     ]
   - dark (boolean) (default: false)
   - remove_wrapper (boolean) (default: false)
-  - items (array of objects)
+  - items (object[])
     format: [
       {
-        - Link or Button object component
+        - link or button object
         - active (boolean)
         - divider (bolean) - show divider
         - button (boolean) - set to button
@@ -37,11 +37,11 @@
 
 {% set _id = id|default('dropdown-' ~ random(1000)) %}
 {% set _trigger = trigger|default({}) %}
-{% set _link = link|default(false) %}
+{% set _link = link ?? false %}
 {% set _direction = direction|default('') %}
 {% set _alignment = alignment|default('') %}
-{% set _dark = dark|default(false) %}
-{% set _remove_wrapper = remove_wrapper|default(false) %}
+{% set _dark = dark ?? false %}
+{% set _remove_wrapper = remove_wrapper ?? false %}
 {% set _items = items|default([]) %}
 
 {% set _class = 'dropdown' %}

package/templates/bcl-fact-figures/fact-figures.html.twig

@@ -6,8 +6,8 @@
   - title_tag (string) (default: 'h2')
   - title_link: (link object) (default: {})
   - title_attributes (drupal attrs)
-  - variant (string) (default: 'default') options:
-    [ default, block ]
+  - variant (string) (default: 'default')
+      options:  default, block ]
   - display_icons (boolean) (default: true)
   - items (array) (default: []):
     - icon (associate array) (default: { size: 'm' })
@@ -35,7 +35,7 @@
 {% set _responsiveness = responsiveness|default('md') %}
 {% set _responsive_columns = responsive_columns|default(3) %}
 {% set _gutter = gutter|default(4) %}
-{% set _equal_height = equal_height|default(false) %}
+{% set _equal_height = equal_height ?? false %}
 {% set _cols_extra_classes = cols_extra_classes|default('') %}
 {% set _icon_path = icon_path|default('') %}
 {% set _link_more = link_more|default({}) %}

package/templates/bcl-featured-media/featured-media.html.twig

@@ -6,29 +6,29 @@
   - title_link: (link object) (default: {})
   - title_attributes: (drupal attrs)
   - with_text (boolean) (default: false)
-  - alignment: (string) (default: "right")
+  - alignment: (string) (default: 'right')
     - options ['left', 'right']
-  - image: (string) (default: "")
-  - poster_image: (string) (default: "")
-  - content: (string) (default: "")
+  - image: (string) (default: '')
+  - poster_image: (string) (default: '')
+  - content: (string) (default: '')
   - wrapper_classes: (default: '')
-  - content_classes: (string) (default: "")
+  - content_classes: (string) (default: '')
   - read_more (object) (default: {})
   - description (string) (default: '')
-  - ratio: (string) (default: "16x9")
-    - options ["1x1", "4x3", "16x9", "21x9"]
-  - sources: (array of sources) (default: []) format: [
+  - ratio: (string) (default: '16x9')
+    - options ['1x1', '4x3', '16x9', '21x9']
+  - sources: (object[]) (default: []) format: [
     {
-      type: "",
-      src: ""
+      type: '',
+      src: ''
     }
   ]
-  - tracks: (array of tracks) (default: []) format: [
+  - tracks: (object[]) (default: []) format: [
     {
-      kind: "",
-      label: "",
-      src: "",
-      src_lang: ""
+      kind: '',
+      label: '',
+      src: '',
+      src_lang: ''
     }
   ]
 
@@ -40,7 +40,7 @@
 {% set _title_tag = title_tag|default('h2') %}
 {% set _title_link = title_link|default({}) %}
 {% set _title_attributes = title_attributes ?: create_attribute() %}
-{% set _with_text = with_text|default(false) %}
+{% set _with_text = with_text ?? false %}
 {% set _alignment = alignment|default('right') %}
 {% set _image = image|default('') %}
 {% set _poster_image = poster_image|default('') %}

package/templates/bcl-file/file-translations.html.twig

@@ -1,7 +1,7 @@
 {% apply spaceless %}
 
 {# Parameters:
-  - id (string) (default: language-dropdown + random(1000))
+  - id (string) (default: language-dropdown-random(1000))
   - label (string) (default: '')
   - icon_path (string) (default: '')
   - items (string) (default: [])