@dta-au/civictheme-twig 1.13.1

package/components/01-atoms/content-link/content-link.twig

@@ -0,0 +1,40 @@
+{#
+/**
+ * @file
+ * CivicTheme Content Link component.
+ *
+ * Props:
+ * - theme: [string] Theme variation (light or dark).
+ * - text: [string] Link text.
+ * - url: [string] Link URL.
+ * - title: [string] Link title.
+ * - is_new_window: [boolean] Whether to open in a new window.
+ * - is_external: [boolean] Whether the link is external.
+ * - modifier_class: [string] Additional CSS classes.
+ * - attributes: [Drupal\Core\Template\Attribute] Additional HTML attributes.
+ */
+#}
+
+{% set external_class = is_external ? 'ct-content-link--external' : '' %}
+{% set theme_class = 'ct-theme-%s'|format(theme|default('light')) %}
+{% set modifier_class = '%s %s %s'|format(theme_class, external_class, modifier_class|default('')) %}
+
+{% if text is not empty %}
+  {% set link_content %}
+    {%- include '@base/text-icon/text-icon.twig' with {
+      text: text,
+      is_new_window: is_new_window,
+      is_external: is_external,
+    } only -%}
+  {% endset %}
+
+  <a
+    class="ct-content-link {{ modifier_class -}}"
+    {% if url is not empty %}href="{{ url }}"{% endif %}
+    {% if title is not empty %}title="{{ title }}"{% endif %}
+    {% if is_new_window %}target="_blank" aria-label="Opens in a new tab"{% endif %}
+    {% if attributes is defined and attributes is not null %}{{- attributes -}}{% endif %}
+  >
+    {{- link_content -}}
+  </a>
+{% endif %}

package/components/01-atoms/field-description/__snapshots__/field-description.test.js.snap

@@ -0,0 +1,49 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`Field Description Component does not render when content is empty 1`] = `
+<div>
+  
+
+
+</div>
+`;
+
+exports[`Field Description Component renders with additional attributes and classes 1`] = `
+<div>
+  
+
+
+  <div
+    class="ct-field-description ct-theme-light ct-field-description--regular custom-modifier"
+    data-test="true"
+  >
+    This is a description
+  </div>
+</div>
+`;
+
+exports[`Field Description Component renders with custom theme and size 1`] = `
+<div>
+  
+
+
+  <div
+    class="ct-field-description ct-theme-dark ct-field-description--large "
+  >
+    This is a description
+  </div>
+</div>
+`;
+
+exports[`Field Description Component renders with default values 1`] = `
+<div>
+  
+
+
+  <div
+    class="ct-field-description ct-theme-light ct-field-description--regular "
+  >
+    This is a description
+  </div>
+</div>
+`;

package/components/01-atoms/field-description/field-description.scss

@@ -0,0 +1,24 @@
+//
+// CivicTheme Field Description component styles.
+//
+
+.ct-field-description {
+  $root: &;
+
+  display: block;
+  margin-bottom: ct-spacing();
+
+  @include ct-typography('text-regular');
+
+  &--large {
+    @include ct-typography('text-large');
+  }
+
+  @include ct-component-theme($root) using($root, $theme) {
+    @include ct-component-property($root, $theme, color);
+
+    a:not(.ct-link.ct-theme-light):not(.ct-link.ct-theme-dark) {
+      color: inherit;
+    }
+  }
+}

package/components/01-atoms/field-description/field-description.stories.js

@@ -0,0 +1,41 @@
+/**
+ * CivicTheme Field Description component stories.
+ */
+
+import Component from './field-description.twig';
+
+const meta = {
+  title: 'Atoms/Form Controls/Field Description',
+  component: Component,
+  argTypes: {
+    theme: {
+      control: { type: 'radio' },
+      options: ['light', 'dark'],
+    },
+    size: {
+      control: { type: 'radio' },
+      options: ['large', 'regular'],
+    },
+    content: {
+      control: { type: 'text' },
+    },
+    modifier_class: {
+      control: { type: 'text' },
+    },
+  },
+};
+
+export default meta;
+
+export const FieldDescription = {
+  parameters: {
+    layout: 'centered',
+  },
+  args: {
+    theme: 'light',
+    size: 'regular',
+    content: 'Field message content sample.',
+    modifier_class: '',
+    attributes: null,
+  },
+};

package/components/01-atoms/field-description/field-description.test.js

@@ -0,0 +1,51 @@
+import DrupalAttribute from 'drupal-attribute';
+
+const template = 'components/01-atoms/field-description/field-description.twig';
+
+describe('Field Description Component', () => {
+  test('renders with default values', async () => {
+    const c = await dom(template, {
+      content: 'This is a description',
+    });
+
+    expect(c.querySelectorAll('.ct-field-description.ct-theme-light.ct-field-description--regular')).toHaveLength(1);
+    expect(c.querySelector('.ct-field-description').textContent.trim()).toEqual('This is a description');
+
+    assertUniqueCssClasses(c);
+  });
+
+  test('renders with custom theme and size', async () => {
+    const c = await dom(template, {
+      content: 'This is a description',
+      theme: 'dark',
+      size: 'large',
+    });
+
+    expect(c.querySelectorAll('.ct-field-description.ct-theme-dark.ct-field-description--large')).toHaveLength(1);
+    expect(c.querySelector('.ct-field-description').textContent.trim()).toEqual('This is a description');
+
+    assertUniqueCssClasses(c);
+  });
+
+  test('renders with additional attributes and classes', async () => {
+    const c = await dom(template, {
+      content: 'This is a description',
+      attributes: new DrupalAttribute().setAttribute('data-test', 'true'),
+      modifier_class: 'custom-modifier',
+    });
+
+    expect(c.querySelectorAll('.ct-field-description.ct-theme-light.ct-field-description--regular.custom-modifier')).toHaveLength(1);
+    expect(c.querySelector('.ct-field-description').getAttribute('data-test')).toEqual('true');
+    expect(c.querySelector('.ct-field-description').textContent.trim()).toEqual('This is a description');
+
+    assertUniqueCssClasses(c);
+  });
+
+  test('does not render when content is empty', async () => {
+    const c = await dom(template, {
+      content: '',
+    });
+
+    expect(c.querySelectorAll('.ct-field-description')).toHaveLength(0);
+  });
+});

package/components/01-atoms/field-description/field-description.twig

@@ -0,0 +1,24 @@
+{#
+/**
+ * @file
+ * CivicTheme Field Description component.
+ *
+ * Props:
+ * - theme: [string] Theme variation (light or dark).
+ * - content: [string] The description's content.
+ * - size: [string] Description size (large, regular).
+ * - modifier_class: [string] Additional CSS classes.
+ * - attributes: [Drupal\Core\Template\Attribute] Additional HTML attributes.
+ */
+#}
+
+{% set size = size in ['large', 'regular'] ? size : 'regular' %}
+{% set size_class = 'ct-field-description--%s'|format(size) %}
+{% set theme_class = 'ct-theme-%s'|format(theme|default('light')) %}
+{% set modifier_class = '%s %s %s'|format(theme_class, size_class, modifier_class|default('')) %}
+
+{% if content is not empty -%}
+  <div class="ct-field-description {{ modifier_class -}}" {% if attributes is defined and attributes is not null %}{{- attributes -}}{% endif %}>
+    {{- content -}}
+  </div>
+{%- endif %}

package/components/01-atoms/field-message/__snapshots__/field-message.test.js.snap

@@ -0,0 +1,142 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`Field Message Component does not render when content is empty 1`] = `
+<div>
+  
+
+
+</div>
+`;
+
+exports[`Field Message Component renders with additional attributes and classes 1`] = `
+<div>
+  
+
+
+  <div
+    class="ct-field-message ct-theme-light ct-field-message--information custom-modifier"
+    data-test="true"
+  >
+    
+          
+    <svg
+      aria-hidden="true"
+      class="ct-icon ct-icon--size-regular ct-field-message__icon"
+      height="24"
+      role="img"
+      viewBox="0 0 24 24"
+      width="24"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      
+
+      <path
+        d="M12 11C11.7348 11 11.4804 11.1054 11.2929 11.2929C11.1054 11.4804 11 11.7348 11 12V16C11 16.2652 11.1054 16.5196 11.2929 16.7071C11.4804 16.8946 11.7348 17 12 17C12.2652 17 12.5196 16.8946 12.7071 16.7071C12.8946 16.5196 13 16.2652 13 16V12C13 11.7348 12.8946 11.4804 12.7071 11.2929C12.5196 11.1054 12.2652 11 12 11ZM12.38 7.08C12.1365 6.97998 11.8635 6.97998 11.62 7.08C11.4973 7.12759 11.3851 7.19896 11.29 7.29C11.2017 7.3872 11.1306 7.49882 11.08 7.62C11.024 7.73868 10.9966 7.86882 11 8C10.9992 8.13161 11.0245 8.26207 11.0742 8.38391C11.124 8.50574 11.1973 8.61656 11.29 8.71C11.3872 8.79833 11.4988 8.86936 11.62 8.92C11.7715 8.98224 11.936 9.00632 12.099 8.99011C12.2619 8.97391 12.4184 8.91792 12.5547 8.82707C12.691 8.73622 12.8029 8.61328 12.8805 8.46907C12.9582 8.32486 12.9992 8.16378 13 8C12.9963 7.73523 12.8927 7.48163 12.71 7.29C12.6149 7.19896 12.5028 7.12759 12.38 7.08ZM12 2C10.0222 2 8.08879 2.58649 6.4443 3.6853C4.79981 4.78412 3.51809 6.3459 2.76121 8.17317C2.00433 10.0004 1.8063 12.0111 2.19215 13.9509C2.578 15.8907 3.53041 17.6725 4.92894 19.0711C6.32746 20.4696 8.10929 21.422 10.0491 21.8079C11.9889 22.1937 13.9996 21.9957 15.8268 21.2388C17.6541 20.4819 19.2159 19.2002 20.3147 17.5557C21.4135 15.9112 22 13.9778 22 12C22 10.6868 21.7413 9.38642 21.2388 8.17317C20.7363 6.95991 19.9997 5.85752 19.0711 4.92893C18.1425 4.00035 17.0401 3.26375 15.8268 2.7612C14.6136 2.25866 13.3132 2 12 2ZM12 20C10.4178 20 8.87104 19.5308 7.55544 18.6518C6.23985 17.7727 5.21447 16.5233 4.60897 15.0615C4.00347 13.5997 3.84504 11.9911 4.15372 10.4393C4.4624 8.88743 5.22433 7.46197 6.34315 6.34315C7.46197 5.22433 8.88743 4.4624 10.4393 4.15372C11.9911 3.84504 13.5997 4.00346 15.0615 4.60896C16.5233 5.21447 17.7727 6.23984 18.6518 7.55544C19.5308 8.87103 20 10.4177 20 12C20 14.1217 19.1572 16.1566 17.6569 17.6569C16.1566 19.1571 14.1217 20 12 20Z"
+      />
+      
+
+    </svg>
+    
+    This is a message
+  </div>
+</div>
+`;
+
+exports[`Field Message Component renders with custom theme and type 1`] = `
+<div>
+  
+
+
+  <div
+    class="ct-field-message ct-theme-dark ct-field-message--error "
+  >
+    
+          
+    <svg
+      aria-hidden="true"
+      class="ct-icon ct-icon--size-regular ct-field-message__icon"
+      height="24"
+      role="img"
+      viewBox="0 0 24 24"
+      width="24"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      
+
+      <path
+        d="M15.7098 8.28996C15.6169 8.19623 15.5063 8.12183 15.3844 8.07107C15.2626 8.0203 15.1318 7.99416 14.9998 7.99416C14.8678 7.99416 14.7371 8.0203 14.6153 8.07107C14.4934 8.12183 14.3828 8.19623 14.2898 8.28996L11.9998 10.59L9.70984 8.28996C9.52153 8.10165 9.26614 7.99587 8.99984 7.99587C8.73353 7.99587 8.47814 8.10165 8.28983 8.28996C8.10153 8.47826 7.99574 8.73366 7.99574 8.99996C7.99574 9.26626 8.10153 9.52165 8.28983 9.70996L10.5898 12L8.28983 14.29C8.19611 14.3829 8.12171 14.4935 8.07094 14.6154C8.02017 14.7372 7.99404 14.8679 7.99404 15C7.99404 15.132 8.02017 15.2627 8.07094 15.3845C8.12171 15.5064 8.19611 15.617 8.28983 15.71C8.3828 15.8037 8.4934 15.8781 8.61526 15.9288C8.73712 15.9796 8.86782 16.0058 8.99984 16.0058C9.13185 16.0058 9.26255 15.9796 9.38441 15.9288C9.50627 15.8781 9.61687 15.8037 9.70984 15.71L11.9998 13.41L14.2898 15.71C14.3828 15.8037 14.4934 15.8781 14.6153 15.9288C14.7371 15.9796 14.8678 16.0058 14.9998 16.0058C15.1318 16.0058 15.2626 15.9796 15.3844 15.9288C15.5063 15.8781 15.6169 15.8037 15.7098 15.71C15.8036 15.617 15.878 15.5064 15.9287 15.3845C15.9795 15.2627 16.0056 15.132 16.0056 15C16.0056 14.8679 15.9795 14.7372 15.9287 14.6154C15.878 14.4935 15.8036 14.3829 15.7098 14.29L13.4098 12L15.7098 9.70996C15.8036 9.61699 15.878 9.50639 15.9287 9.38453C15.9795 9.26267 16.0056 9.13197 16.0056 8.99996C16.0056 8.86795 15.9795 8.73724 15.9287 8.61538C15.878 8.49352 15.8036 8.38292 15.7098 8.28996ZM19.0698 4.92996C18.1474 3.97486 17.0439 3.21303 15.8239 2.68894C14.6038 2.16485 13.2916 1.88899 11.9638 1.87745C10.6361 1.86591 9.31926 2.11893 8.09029 2.62174C6.86133 3.12455 5.74481 3.86708 4.80589 4.80601C3.86696 5.74493 3.12443 6.86145 2.62162 8.09042C2.11881 9.31938 1.86579 10.6362 1.87733 11.964C1.88887 13.2918 2.16473 14.604 2.68882 15.824C3.21291 17.044 3.97473 18.1475 4.92984 19.07C5.8523 20.0251 6.95575 20.7869 8.17579 21.311C9.39583 21.8351 10.708 22.1109 12.0358 22.1225C13.3636 22.134 14.6804 21.881 15.9094 21.3782C17.1383 20.8754 18.2549 20.1328 19.1938 19.1939C20.1327 18.255 20.8752 17.1385 21.3781 15.9095C21.8809 14.6805 22.1339 13.3637 22.1223 12.0359C22.1108 10.7082 21.8349 9.39595 21.3109 8.17591C20.7868 6.95587 20.0249 5.85243 19.0698 4.92996ZM17.6598 17.66C16.3519 18.9694 14.6304 19.7848 12.7886 19.9673C10.9469 20.1497 9.09884 19.688 7.55936 18.6607C6.01987 17.6334 4.88419 16.1042 4.34581 14.3334C3.80742 12.5627 3.89964 10.6601 4.60675 8.94974C5.31386 7.23938 6.59211 5.82711 8.22373 4.95352C9.85534 4.07993 11.7394 3.79909 13.5548 4.15883C15.3703 4.51857 17.0049 5.49665 18.1801 6.92642C19.3553 8.35619 19.9984 10.1492 19.9998 12C20.0034 13.0512 19.7984 14.0928 19.3968 15.0643C18.9951 16.0359 18.4047 16.9181 17.6598 17.66Z"
+      />
+      
+
+    </svg>
+    
+    This is an error message
+  </div>
+</div>
+`;
+
+exports[`Field Message Component renders with default values 1`] = `
+<div>
+  
+
+
+  <div
+    class="ct-field-message ct-theme-light ct-field-message--information "
+  >
+    
+          
+    <svg
+      aria-hidden="true"
+      class="ct-icon ct-icon--size-regular ct-field-message__icon"
+      height="24"
+      role="img"
+      viewBox="0 0 24 24"
+      width="24"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      
+
+      <path
+        d="M12 11C11.7348 11 11.4804 11.1054 11.2929 11.2929C11.1054 11.4804 11 11.7348 11 12V16C11 16.2652 11.1054 16.5196 11.2929 16.7071C11.4804 16.8946 11.7348 17 12 17C12.2652 17 12.5196 16.8946 12.7071 16.7071C12.8946 16.5196 13 16.2652 13 16V12C13 11.7348 12.8946 11.4804 12.7071 11.2929C12.5196 11.1054 12.2652 11 12 11ZM12.38 7.08C12.1365 6.97998 11.8635 6.97998 11.62 7.08C11.4973 7.12759 11.3851 7.19896 11.29 7.29C11.2017 7.3872 11.1306 7.49882 11.08 7.62C11.024 7.73868 10.9966 7.86882 11 8C10.9992 8.13161 11.0245 8.26207 11.0742 8.38391C11.124 8.50574 11.1973 8.61656 11.29 8.71C11.3872 8.79833 11.4988 8.86936 11.62 8.92C11.7715 8.98224 11.936 9.00632 12.099 8.99011C12.2619 8.97391 12.4184 8.91792 12.5547 8.82707C12.691 8.73622 12.8029 8.61328 12.8805 8.46907C12.9582 8.32486 12.9992 8.16378 13 8C12.9963 7.73523 12.8927 7.48163 12.71 7.29C12.6149 7.19896 12.5028 7.12759 12.38 7.08ZM12 2C10.0222 2 8.08879 2.58649 6.4443 3.6853C4.79981 4.78412 3.51809 6.3459 2.76121 8.17317C2.00433 10.0004 1.8063 12.0111 2.19215 13.9509C2.578 15.8907 3.53041 17.6725 4.92894 19.0711C6.32746 20.4696 8.10929 21.422 10.0491 21.8079C11.9889 22.1937 13.9996 21.9957 15.8268 21.2388C17.6541 20.4819 19.2159 19.2002 20.3147 17.5557C21.4135 15.9112 22 13.9778 22 12C22 10.6868 21.7413 9.38642 21.2388 8.17317C20.7363 6.95991 19.9997 5.85752 19.0711 4.92893C18.1425 4.00035 17.0401 3.26375 15.8268 2.7612C14.6136 2.25866 13.3132 2 12 2ZM12 20C10.4178 20 8.87104 19.5308 7.55544 18.6518C6.23985 17.7727 5.21447 16.5233 4.60897 15.0615C4.00347 13.5997 3.84504 11.9911 4.15372 10.4393C4.4624 8.88743 5.22433 7.46197 6.34315 6.34315C7.46197 5.22433 8.88743 4.4624 10.4393 4.15372C11.9911 3.84504 13.5997 4.00346 15.0615 4.60896C16.5233 5.21447 17.7727 6.23984 18.6518 7.55544C19.5308 8.87103 20 10.4177 20 12C20 14.1217 19.1572 16.1566 17.6569 17.6569C16.1566 19.1571 14.1217 20 12 20Z"
+      />
+      
+
+    </svg>
+    
+    This is a message
+  </div>
+</div>
+`;
+
+exports[`Field Message Component renders with icons 1`] = `
+<div>
+  
+
+
+  <div
+    class="ct-field-message ct-theme-light ct-field-message--warning "
+  >
+    
+          
+    <svg
+      aria-hidden="true"
+      class="ct-icon ct-icon--size-regular ct-field-message__icon"
+      height="24"
+      role="img"
+      viewBox="0 0 24 24"
+      width="24"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      
+
+      <path
+        d="M12 7C11.7348 7 11.4804 7.10536 11.2929 7.29289C11.1054 7.48043 11 7.73478 11 8V12C11 12.2652 11.1054 12.5196 11.2929 12.7071C11.4804 12.8946 11.7348 13 12 13C12.2652 13 12.5196 12.8946 12.7071 12.7071C12.8946 12.5196 13 12.2652 13 12V8C13 7.73478 12.8946 7.48043 12.7071 7.29289C12.5196 7.10536 12.2652 7 12 7ZM12.92 15.62C12.8981 15.5563 12.8679 15.4957 12.83 15.44L12.71 15.29C12.5694 15.1512 12.3908 15.0572 12.1968 15.0199C12.0028 14.9825 11.8021 15.0034 11.62 15.08C11.4988 15.1306 11.3872 15.2017 11.29 15.29C11.1973 15.3834 11.124 15.4943 11.0742 15.6161C11.0245 15.7379 10.9992 15.8684 11 16C11.0016 16.1307 11.0288 16.2598 11.08 16.38C11.1249 16.5041 11.1966 16.6168 11.2899 16.7101C11.3832 16.8034 11.4959 16.8751 11.62 16.92C11.7397 16.9729 11.8691 17.0002 12 17.0002C12.1309 17.0002 12.2603 16.9729 12.38 16.92C12.5041 16.8751 12.6168 16.8034 12.7101 16.7101C12.8034 16.6168 12.8751 16.5041 12.92 16.38C12.9712 16.2598 12.9984 16.1307 13 16C13.0049 15.9334 13.0049 15.8666 13 15.8C12.9828 15.7362 12.9558 15.6755 12.92 15.62ZM12 2C10.0222 2 8.08879 2.58649 6.4443 3.6853C4.79981 4.78412 3.51809 6.3459 2.76121 8.17317C2.00433 10.0004 1.8063 12.0111 2.19215 13.9509C2.578 15.8907 3.53041 17.6725 4.92894 19.0711C6.32746 20.4696 8.10929 21.422 10.0491 21.8079C11.9889 22.1937 13.9996 21.9957 15.8268 21.2388C17.6541 20.4819 19.2159 19.2002 20.3147 17.5557C21.4135 15.9112 22 13.9778 22 12C22 10.6868 21.7413 9.38642 21.2388 8.17317C20.7363 6.95991 19.9997 5.85752 19.0711 4.92893C18.1425 4.00035 17.0401 3.26375 15.8268 2.7612C14.6136 2.25866 13.3132 2 12 2ZM12 20C10.4178 20 8.87104 19.5308 7.55544 18.6518C6.23985 17.7727 5.21447 16.5233 4.60897 15.0615C4.00347 13.5997 3.84504 11.9911 4.15372 10.4393C4.4624 8.88743 5.22433 7.46197 6.34315 6.34315C7.46197 5.22433 8.88743 4.4624 10.4393 4.15372C11.9911 3.84504 13.5997 4.00346 15.0615 4.60896C16.5233 5.21447 17.7727 6.23984 18.6518 7.55544C19.5308 8.87103 20 10.4177 20 12C20 14.1217 19.1572 16.1566 17.6569 17.6569C16.1566 19.1571 14.1217 20 12 20Z"
+      />
+      
+
+    </svg>
+    
+    This is a warning message
+  </div>
+</div>
+`;

package/components/01-atoms/field-message/field-message.scss

@@ -0,0 +1,108 @@
+//
+// CivicTheme Field Message component styles.
+//
+
+@use 'sass:map';
+@use 'sass:math';
+
+//
+// Mixins.
+//
+
+.ct-field-message {
+  $root: &;
+  $_padding: ct-spacing();
+
+  display: block;
+  border-radius: var(--ct-field-message-border-radius);
+  padding: $_padding;
+  border-width: ct-particle(0.125);
+  border-style: solid;
+
+  @include ct-typography('text-regular');
+
+  #{$root}__icon {
+    vertical-align: top;
+
+    @include ct-icon-align-with-text('text-regular');
+  }
+
+  $map: (
+    'information': (
+      'light': (
+        'color': var(--ct-field-message-light-information-color),
+        'background-color': var(--ct-field-message-light-information-background-color),
+        'border-color': var(--ct-field-message-light-information-border-color),
+        'icon-color': var(--ct-field-message-light-information-icon-color),
+      ),
+      'dark': (
+        'color': var(--ct-field-message-dark-information-color),
+        'background-color': var(--ct-field-message-dark-information-background-color),
+        'border-color': var(--ct-field-message-dark-information-border-color),
+        'icon-color': var(--ct-field-message-dark-information-icon-color),
+      )
+    ),
+    'warning': (
+      'light': (
+        'color': var(--ct-field-message-light-warning-color),
+        'background-color': var(--ct-field-message-light-warning-background-color),
+        'border-color': var(--ct-field-message-light-warning-border-color),
+        'icon-color': var(--ct-field-message-light-warning-icon-color),
+      ),
+      'dark': (
+        'color': var(--ct-field-message-dark-warning-color),
+        'background-color': var(--ct-field-message-dark-warning-background-color),
+        'border-color': var(--ct-field-message-dark-warning-border-color),
+        'icon-color': var(--ct-field-message-dark-warning-icon-color),
+      )
+    ),
+    'error': (
+      'light': (
+        'color': var(--ct-field-message-light-error-color),
+        'background-color': var(--ct-field-message-light-error-background-color),
+        'border-color': var(--ct-field-message-light-error-border-color),
+        'icon-color': var(--ct-field-message-light-error-icon-color),
+      ),
+      'dark': (
+        'color': var(--ct-field-message-dark-error-color),
+        'background-color': var(--ct-field-message-dark-error-background-color),
+        'border-color': var(--ct-field-message-dark-error-border-color),
+        'icon-color': var(--ct-field-message-dark-error-icon-color),
+      )
+    ),
+    'success': (
+      'light': (
+        'color': var(--ct-field-message-light-success-color),
+        'background-color': var(--ct-field-message-light-success-background-color),
+        'border-color': var(--ct-field-message-light-success-border-color),
+        'icon-color': var(--ct-field-message-light-success-icon-color),
+      ),
+      'dark': (
+        'color': var(--ct-field-message-dark-success-color),
+        'background-color': var(--ct-field-message-dark-success-background-color),
+        'border-color': var(--ct-field-message-dark-success-border-color),
+        'icon-color': var(--ct-field-message-dark-success-icon-color),
+      )
+    ),
+  );
+
+  @each $type, $type-map in $map {
+    &#{$root}--#{$type} {
+      @each $theme, $values in $type-map {
+        &.ct-theme-#{$theme} {
+          background-color: map.get($values, 'background-color');
+          color: map.get($values, 'color');
+          border-color: map.get($values, 'border-color');
+
+          #{$root}__icon {
+            color: map.get($values, 'icon-color');
+          }
+
+          a:not(.ct-link.ct-theme-light):not(.ct-link.ct-theme-dark) {
+            color: inherit;
+          }
+        }
+      }
+    }
+  }
+}

package/components/01-atoms/field-message/field-message.stories.js

@@ -0,0 +1,41 @@
+/**
+ * CivicTheme Field Message component stories.
+ */
+
+import Component from './field-message.twig';
+
+const meta = {
+  title: 'Atoms/Form Controls/Field Message',
+  component: Component,
+  argTypes: {
+    theme: {
+      control: { type: 'radio' },
+      options: ['light', 'dark'],
+    },
+    type: {
+      control: { type: 'radio' },
+      options: ['error', 'information', 'warning', 'success'],
+    },
+    content: {
+      control: { type: 'text' },
+    },
+    modifier_class: {
+      control: { type: 'text' },
+    },
+  },
+};
+
+export default meta;
+
+export const FieldMessage = {
+  parameters: {
+    layout: 'centered',
+  },
+  args: {
+    theme: 'light',
+    type: 'error',
+    content: 'Field message content sample.',
+    modifier_class: '',
+    attributes: null,
+  },
+};

package/components/01-atoms/field-message/field-message.test.js

@@ -0,0 +1,64 @@
+import DrupalAttribute from 'drupal-attribute';
+
+const template = 'components/01-atoms/field-message/field-message.twig';
+
+describe('Field Message Component', () => {
+  test('renders with default values', async () => {
+    const c = await dom(template, {
+      content: 'This is a message',
+    });
+
+    expect(c.querySelectorAll('.ct-field-message.ct-theme-light.ct-field-message--information')).toHaveLength(1);
+    expect(c.querySelector('.ct-field-message').textContent.trim()).toEqual('This is a message');
+
+    assertUniqueCssClasses(c);
+  });
+
+  test('renders with custom theme and type', async () => {
+    const c = await dom(template, {
+      content: 'This is an error message',
+      theme: 'dark',
+      type: 'error',
+    });
+
+    expect(c.querySelectorAll('.ct-field-message.ct-theme-dark.ct-field-message--error')).toHaveLength(1);
+    expect(c.querySelector('.ct-field-message').textContent.trim()).toEqual('This is an error message');
+
+    assertUniqueCssClasses(c);
+  });
+
+  test('renders with additional attributes and classes', async () => {
+    const c = await dom(template, {
+      content: 'This is a message',
+      attributes: new DrupalAttribute().setAttribute('data-test', 'true'),
+      modifier_class: 'custom-modifier',
+    });
+
+    expect(c.querySelectorAll('.ct-field-message.ct-theme-light.ct-field-message--information.custom-modifier')).toHaveLength(1);
+    expect(c.querySelector('.ct-field-message').getAttribute('data-test')).toEqual('true');
+    expect(c.querySelector('.ct-field-message').textContent.trim()).toEqual('This is a message');
+
+    assertUniqueCssClasses(c);
+  });
+
+  test('does not render when content is empty', async () => {
+    const c = await dom(template, {
+      content: '',
+    });
+
+    expect(c.querySelectorAll('.ct-field-message')).toHaveLength(0);
+  });
+
+  test('renders with icons', async () => {
+    const c = await dom(template, {
+      content: 'This is a warning message',
+      type: 'warning',
+    });
+
+    expect(c.querySelectorAll('.ct-field-message.ct-theme-light.ct-field-message--warning')).toHaveLength(1);
+    expect(c.querySelector('.ct-field-message').textContent.trim()).toEqual('This is a warning message');
+    expect(c.querySelectorAll('.ct-field-message__icon')).toHaveLength(1);
+
+    assertUniqueCssClasses(c);
+  });
+});

package/components/01-atoms/field-message/field-message.twig

@@ -0,0 +1,37 @@
+{#
+/**
+ * @file
+ * CivicTheme Field Message component.
+ *
+ * Props:
+ * - theme: [string] Theme variation (light or dark).
+ * - content: [string] The message content.
+ * - type: [string] Message type (error, information, warning, success).
+ * - modifier_class: [string] Additional CSS classes.
+ * - attributes: [Drupal\Core\Template\Attribute] Additional HTML attributes.
+ */
+#}
+
+{% set theme_class = 'ct-theme-%s'|format(theme|default('light')) %}
+{% set type = type in ['error', 'information', 'warning', 'success'] ? type : 'information' %}
+{% set type_class = 'ct-field-message--%s'|format(type|default('information')) %}
+{% set modifier_class = '%s %s %s'|format(theme_class, type_class, modifier_class|default('')) %}
+{% set icons = {
+  information: 'information-mark',
+  warning: 'exclamation-mark-3',
+  error: 'close-outline',
+  success: 'approve',
+} %}
+
+{% if content is not empty -%}
+  <div class="ct-field-message {{ modifier_class -}}" {% if attributes is defined and attributes is not null %}{{- attributes -}}{% endif %}>
+    {% if icons[type] is defined %}
+      {% include '@base/icon/icon.twig' with {
+        symbol: icons[type],
+        size: 'regular',
+        modifier_class: 'ct-field-message__icon',
+      } only %}
+    {% endif %}
+    {{- content -}}
+  </div>
+{%- endif %}