@capillarytech/creatives-library 8.0.353-alpha.5 → 8.0.353-alpha.6

package/v2Components/TemplatePreview/index.js

@@ -52,6 +52,7 @@ import { QUICK_REPLY, WHATSAPP_CATEGORIES, PHONE_NUMBER, TEMPLATE_VARIABLE_REGEX
 import { RCS_BUTTON_TYPES, LEFT, HORIZONTAL, VERTICAL, RIGHT} from '../../v2Containers/Rcs/constants';
 import { ANDROID, INAPP_MESSAGE_LAYOUT_TYPES } from '../../v2Containers/InApp/constants';
 import { CAROUSEL } from '../../v2Containers/MobilePushNew/constants';
+import { TEMPLATE_VAR_REGEX } from './constants';
 
 const wechatBodyNew = require('./assets/images/wechat_mobile_android.svg');
 const smsMobileAndroid = require('./assets/images/sms_mobile_android.svg');
@@ -236,7 +237,23 @@ export class TemplatePreview extends React.Component { // eslint-disable-line re
     let content = channel && channel.toLowerCase() === 'sms' ? [this.props.content] : this.props.content;
     const { formatMessage } = intl;
     const { rcsPreviewContent, inAppPreviewContent, viberPreviewContent, isBeeFreeTemplate } = content || {};
-    const { rcsImageSrc, rcsVideoSrc, rcsTitle, rcsDesc, rcsSuggestions } = rcsPreviewContent || {};
+    const normalizedRcsPreviewContent = Array.isArray(rcsPreviewContent)
+      ? { carouselData: rcsPreviewContent }
+      : (rcsPreviewContent || {});
+    const {
+      rcsImageSrc,
+      rcsVideoSrc,
+      rcsTitle,
+      rcsDesc,
+      rcsSuggestions,
+      carouselData: rcsCarouselData,
+      rcsCarouselData: rcsCarouselDataAlt,
+      cardVarMapped: rcsCardVarMapped,
+    } = normalizedRcsPreviewContent;
+    const resolvedRcsCarouselData =
+      Array.isArray(rcsCarouselData) && rcsCarouselData.length > 0
+        ? rcsCarouselData
+        : rcsCarouselDataAlt;
     const {
       videoParams,
       imageURL,
@@ -317,6 +334,18 @@ export class TemplatePreview extends React.Component { // eslint-disable-line re
       'flex-shrink': 0,
       'left': 0,
     };
+
+    const resolveVarsWithMap = (input, varMap) => {
+      if (input === null || input === undefined) return '';
+      const str = typeof input === 'string' ? input : String(input);
+      return str.replace(TEMPLATE_VAR_REGEX, (token, varName) => {
+        const mappedValue = varMap?.[varName];
+        if (mappedValue === null || mappedValue === undefined || String(mappedValue) === '') {
+          return token;
+        }
+        return String(mappedValue);
+      });
+    };
     const getVideoContent = ({
       video,
       actionUrl,
@@ -473,13 +502,15 @@ export class TemplatePreview extends React.Component { // eslint-disable-line re
     const whatsappUpdatedAccountName = whatsappAccountName || templateData?.versions?.base?.content?.whatsapp?.accountName || '';
     const whatsappUpdatedLen = whatsappContentLen !== undefined ? whatsappContentLen : content?.charCount;
 
-    const renderRcsSuggestionsPreview = () => {
+    const renderRcsSuggestionsPreview = (suggestionsArg) => {
       const renderArray = [];
-      (rcsSuggestions || []).forEach((suggestion) => {
-        renderArray.push(<CapDivider className="whatsapp-divider" />);
+      const suggestions = Array.isArray(suggestionsArg) ? suggestionsArg : (rcsSuggestions || []);
+      (suggestions || []).forEach((suggestion, idx) => {
+        const suggestionKey = `${suggestion?.type || 'unknown'}-${suggestion?.text || ''}-${idx}`;
+        renderArray.push(<CapDivider key={`rcs-divider-${suggestionKey}`} className="whatsapp-divider" />);
         if (suggestion.type === RCS_BUTTON_TYPES.QUICK_REPLY) {
           renderArray.push(
-            <CapLabel type="label21" className="rcs-cta-preview">
+            <CapLabel key={`rcs-suggestion-${suggestionKey}`} type="label21" className="rcs-cta-preview">
               <CapIcon
                 type='small-link'
                 size="xs"
@@ -489,14 +520,14 @@ export class TemplatePreview extends React.Component { // eslint-disable-line re
           );
         } else if (suggestion.type === RCS_BUTTON_TYPES.CTA) {
           renderArray.push(
-            <CapLabel type="label21" className="rcs-cta-preview">
+            <CapLabel key={`rcs-suggestion-${suggestionKey}`} type="label21" className="rcs-cta-preview">
               <CapIcon type="launch" size="xs" />
               {suggestion.text}
             </CapLabel>,
           );
         } else if (suggestion.type === RCS_BUTTON_TYPES.PHONE_NUMBER) {
           renderArray.push(
-            <CapLabel type="label21" className="rcs-cta-preview">
+            <CapLabel key={`rcs-suggestion-${suggestionKey}`} type="label21" className="rcs-cta-preview">
               <CapIcon type="call" size="xs" />
               {suggestion.text}
             </CapLabel>,
@@ -509,23 +540,20 @@ export class TemplatePreview extends React.Component { // eslint-disable-line re
     const renderTextPreviewContent = () => (
       <>
          {rcsTitle && (
-      <>
         <CapLabel
           type="label5"
           className="message-pop-item align-left rcs-content"
           fontWeight="bold"
         >
-          {rcsTitle}
+          {resolveVarsWithMap(rcsTitle, rcsCardVarMapped)}
         </CapLabel>
-        <CapDivider className="whatsapp-divider" />
-      </>
     )}
         {rcsDesc && (
           <CapLabel
             type="label5"
             className="message-pop-item align-left rcs-desc rcs-content"
           >
-            {rcsDesc}
+            {resolveVarsWithMap(rcsDesc, rcsCardVarMapped)}
           </CapLabel>
         )}
         {renderRcsSuggestionsPreview()}
@@ -542,50 +570,134 @@ export class TemplatePreview extends React.Component { // eslint-disable-line re
           />
         )}
         {rcsVideoSrc && (
-          <div className="video-preview">
+          <CapRow className="video-preview">
             <CapImage
               src={rcsVideoSrc}
               className="rcs-image"
               alt={formatMessage(messages.previewGenerated)}
             />
-            <div className="icon-position">
+            <CapRow className="icon-position">
               <CapImage
                 className="video-icon"
                 src={videoPlay}
               />
-            </div>
-          </div>
+            </CapRow>
+          </CapRow>
         )}   
       </>
     );
 
     const renderRcsPreviewContent = () => {
+      const carouselCards = Array.isArray(resolvedRcsCarouselData) ? resolvedRcsCarouselData : [];
+      if (carouselCards.length > 0) {
+        return (
+          <CapRow className="msg-container sms">
+            <CapRow className="message-pop sms">
+              <CapRow className="msg-container-carousel">
+                <CapRow className="scroll-container">
+                  {carouselCards.map((card, idx) => {
+                    const key = `rcs-carousel-${idx}-${card?.bodyText || card?.imageSrc || card?.videoPreviewImg || ''}`;
+                    const isVideo = (card?.mediaType || '').toLowerCase() === 'video';
+                    const cardSuggestions = Array.isArray(card?.suggestions) ? card.suggestions : [];
+                    const effectiveCardVarMap = card?.cardVarMapped || rcsCardVarMapped;
+                    const suggestionsNode = cardSuggestions.length > 0
+                      ? renderRcsSuggestionsPreview(cardSuggestions)
+                      : null;
+
+                    const resolvedCardTitle = resolveVarsWithMap(card?.title, effectiveCardVarMap);
+                    const resolvedCardBodyText = resolveVarsWithMap(card?.bodyText, effectiveCardVarMap);
+
+                    return (
+                      <CapRow
+                        key={key}
+                        className="message-pop align-left message-pop-carousel rcs-carousel-card"
+                      >
+                        <CapRow className="whatsapp-content">
+                          {!isVideo && (
+                            <CapImage
+                              src={card?.imageSrc ? card.imageSrc : whatsappImageEmptyPreview}
+                              className="whatsapp-image"
+                              alt={formatMessage(messages.previewGenerated)}
+                            />
+                          )}
+                          {isVideo && (
+                            <CapTooltip title={formatMessage(messages.videoPreviewTooltip)}>
+                              <CapRow className="video-preview">
+                                <CapImage
+                                  src={card?.videoPreviewImg ? card.videoPreviewImg : whatsappVideoEmptyPreview}
+                                  className="whatsapp-image"
+                                  alt={formatMessage(messages.previewGenerated)}
+                                />
+                                <CapRow className="icon-position">
+                                  <CapImage className="video-icon" src={videoPlay} alt="Play" />
+                                </CapRow>
+                              </CapRow>
+                            </CapTooltip>
+                          )}
+
+                          {(resolvedCardTitle || resolvedCardBodyText) && (
+                            <CapRow className="carousel-content">
+                              {!!resolvedCardTitle && (
+                                <CapLabel
+                                  type={card?.titleLabelType || 'label1'}
+                                  className="carousel-title"
+                                >
+                                  {resolvedCardTitle}
+                                </CapLabel>
+                              )}
+                              {!!resolvedCardBodyText && (
+                                <CapLabel
+                                  type={card?.bodyLabelType || 'label2'}
+                                  className="carousel-message"
+                                >
+                                  {resolvedCardBodyText}
+                                </CapLabel>
+                              )}
+                            </CapRow>
+                          )}
+
+                          {!!suggestionsNode && (
+                            <>
+                              {suggestionsNode}
+                            </>
+                          )}
+                        </CapRow>
+                      </CapRow>
+                    );
+                  })}
+                </CapRow>
+              </CapRow>
+            </CapRow>
+          </CapRow>
+        );
+      }
+
       if (rcsOrientation === HORIZONTAL) {
         return rcsType === RIGHT ? (
-          <div className="msg-container sms">
-            <div className="message-pop sms horizontal">
+          <CapRow className="msg-container sms">
+            <CapRow className="message-pop sms horizontal">
               <CapColumn className="rcs-preview-text" span={12}>{renderTextPreviewContent()}</CapColumn>
               <CapColumn span={12}>{renderMediaPreviewContent()}</CapColumn>
-            </div>
-          </div>
+            </CapRow>
+          </CapRow>
 
         ) : (
-          <div className="msg-container sms">
-            <div className="message-pop sms horizontal">
+          <CapRow className="msg-container sms">
+            <CapRow className="message-pop sms horizontal">
               <CapColumn span={12}>{renderMediaPreviewContent()}</CapColumn>
               <CapColumn className="rcs-preview-text" span={12}>{renderTextPreviewContent()}</CapColumn>
-            </div>
-          </div>
+            </CapRow>
+          </CapRow>
         );
       }
     
       return (
-        <div className="msg-container sms">
-          <div className="message-pop sms">
+        <CapRow className="msg-container sms">
+          <CapRow className="message-pop sms">
             {renderMediaPreviewContent()}
             {renderTextPreviewContent()}
-          </div>
-        </div>
+          </CapRow>
+        </CapRow>
       );
     };
 
@@ -1303,14 +1415,14 @@ export class TemplatePreview extends React.Component { // eslint-disable-line re
               ""
             )}
             {channel?.toUpperCase() === RCS && (
-              <div className="shell-v2 align-center rcs-preview">
+              <CapRow className="shell-v2 align-center rcs-preview">
                 <CapImage
                   className="preview-image"
                   src={rcsIosPreview ? smsMobileIos : smsMobileAndroid}
                   alt={formatMessage(messages.previewGenerated)}
                 />
                 {renderRcsPreviewContent()}
-              </div>
+              </CapRow>
                 
             )}
             {channel?.toUpperCase() === ZALO && (
@@ -1511,4 +1623,4 @@ TemplatePreview.propTypes = {
   rcsOrientation: PropTypes.string,
 };
 
-export default (injectIntl(TemplatePreview));
+export default (injectIntl(TemplatePreview));

package/v2Components/TemplatePreview/tests/index.test.js

@@ -2,6 +2,9 @@ import React from 'react';
 import { shallowWithIntl } from '../../../helpers/intl-enzym-test-helpers';
 
 import { TemplatePreview } from '../index';
+import { RCS } from '../../../v2Containers/CreativesContainer/constants';
+import whatsappImageEmptyPreview from '../assets/images/empty_image_preview.svg';
+import whatsappVideoEmptyPreview from '../assets/images/empty_video_preview.svg';
 
 describe('Test Templates container', () => {
   let renderedComponent;
@@ -69,4 +72,143 @@ describe('Test Templates container', () => {
     });
     expect(renderedComponent).toMatchSnapshot();
   });
+
+  describe('RCS carousel preview branches', () => {
+    const buildRcsContent = (cards) => ({
+      rcsPreviewContent: {
+        carouselData: cards,
+      },
+    });
+
+    const getNodesByClassName = (className) =>
+      renderedComponent.findWhere((node) => node.prop('className') === className);
+
+    it('renders image and video cards with proper media-specific markup', () => {
+      renderFunction(
+        RCS,
+        buildRcsContent([
+          {
+            mediaType: 'image',
+            imageSrc: 'https://example.com/image-card.jpg',
+            bodyText: 'image body',
+            suggestions: [],
+          },
+          {
+            mediaType: 'video',
+            videoPreviewImg: 'https://example.com/video-thumb.jpg',
+            bodyText: 'video body',
+            suggestions: [],
+          },
+        ]),
+        '',
+        0,
+      );
+
+      // Video card should render tooltip/video icon path; image-only card should not.
+      expect(renderedComponent.find('CapTooltip')).toHaveLength(1);
+      expect(
+        renderedComponent.findWhere((node) => node.prop('className') === 'video-icon')
+      ).toHaveLength(1);
+
+      // Both cards render media containers.
+      expect(
+        renderedComponent.findWhere((node) => node.prop('className') === 'whatsapp-image')
+      ).toHaveLength(2);
+    });
+
+    it('renders per-card suggestions only for cards that provide suggestions', () => {
+      renderFunction(
+        RCS,
+        buildRcsContent([
+          {
+            mediaType: 'image',
+            imageSrc: 'https://example.com/with-suggestions.jpg',
+            bodyText: 'has suggestions',
+            suggestions: [
+              { type: 'QUICK_REPLY', text: 'Reply 1' },
+              { type: 'CTA', text: 'Visit' },
+            ],
+          },
+          {
+            mediaType: 'image',
+            imageSrc: 'https://example.com/no-suggestions.jpg',
+            bodyText: 'no suggestions',
+            suggestions: [],
+          },
+        ]),
+        '',
+        0,
+      );
+
+      // Suggestion labels/icons should be rendered only from first card.
+      expect(getNodesByClassName('rcs-cta-preview')).toHaveLength(2);
+      expect(getNodesByClassName('whatsapp-divider')).not.toHaveLength(0);
+    });
+
+    it('falls back to empty preview assets when image/video media src is missing', () => {
+      renderFunction(
+        RCS,
+        buildRcsContent([
+          {
+            mediaType: 'image',
+            bodyText: 'fallback image',
+            suggestions: [],
+          },
+          {
+            mediaType: 'video',
+            bodyText: 'fallback video',
+            suggestions: [],
+          },
+        ]),
+        '',
+        0,
+      );
+
+      const mediaImageNodes = renderedComponent.findWhere(
+        (node) => node.name() === 'CapImage' && node.prop('className') === 'whatsapp-image'
+      );
+      const mediaSrcs = mediaImageNodes.map((node) => node.prop('src'));
+
+      expect(mediaSrcs).toContain(whatsappImageEmptyPreview);
+      expect(mediaSrcs).toContain(whatsappVideoEmptyPreview);
+    });
+
+    it('generates unique carousel keys using rcs-carousel-<idx>-<bodyText|imageSrc|videoPreviewImg>', () => {
+      renderFunction(
+        RCS,
+        buildRcsContent([
+          {
+            mediaType: 'image',
+            imageSrc: 'https://example.com/one.jpg',
+            bodyText: 'same body',
+            suggestions: [],
+          },
+          {
+            mediaType: 'image',
+            imageSrc: 'https://example.com/two.jpg',
+            bodyText: 'same body',
+            suggestions: [],
+          },
+          {
+            mediaType: 'video',
+            videoPreviewImg: 'https://example.com/three-thumb.jpg',
+            bodyText: 'same body',
+            suggestions: [],
+          },
+        ]),
+        '',
+        0,
+      );
+
+      const cardNodes = getNodesByClassName('message-pop align-left message-pop-carousel rcs-carousel-card');
+      const keys = cardNodes.map((node) => node.key());
+
+      expect(keys).toEqual([
+        'rcs-carousel-0-same body',
+        'rcs-carousel-1-same body',
+        'rcs-carousel-2-same body',
+      ]);
+      expect(new Set(keys).size).toBe(keys.length);
+    });
+  });
 });

package/v2Components/TestAndPreviewSlidebox/index.js

@@ -18,7 +18,7 @@ import injectReducer from '../../utils/injectReducer';
 import injectSaga from '../../utils/injectSaga';
 
 import CommonTestAndPreview from '../CommonTestAndPreview';
-import { CHANNELS } from '../CommonTestAndPreview/constants';
+import { CHANNELS, RCS_SMS_FALLBACK_VAR_MAPPED_PROP } from '../CommonTestAndPreview/constants';
 import * as commonTestAndPreviewActions from '../CommonTestAndPreview/actions';
 import { commonTestAndPreviewSaga } from '../CommonTestAndPreview/sagas';
 import commonTestAndPreviewReducer from '../CommonTestAndPreview/reducer';
@@ -69,8 +69,8 @@ const TestAndPreviewSlidebox = (props) => {
 
 TestAndPreviewSlidebox.propTypes = {
   // Channel prop - supports all channels
-  channel: PropTypes.oneOf([CHANNELS.EMAIL, CHANNELS.SMS, CHANNELS.RCS, CHANNELS.WHATSAPP, CHANNELS.INAPP, CHANNELS.MOBILEPUSH, CHANNELS.VIBER, CHANNELS.ZALO, CHANNELS.WEBPUSH]),
-  currentChannel: PropTypes.oneOf([CHANNELS.EMAIL, CHANNELS.SMS, CHANNELS.RCS, CHANNELS.WHATSAPP, CHANNELS.INAPP, CHANNELS.MOBILEPUSH, CHANNELS.VIBER, CHANNELS.ZALO, CHANNELS.WEBPUSH]), // Alternative prop name for backward compatibility
+  channel: PropTypes.oneOf([CHANNELS.EMAIL, CHANNELS.SMS, CHANNELS.RCS, CHANNELS.WHATSAPP, CHANNELS.INAPP, CHANNELS.MOBILEPUSH]),
+  currentChannel: PropTypes.oneOf([CHANNELS.EMAIL, CHANNELS.SMS, CHANNELS.RCS, CHANNELS.WHATSAPP, CHANNELS.INAPP, CHANNELS.MOBILEPUSH]), // Alternative prop name for backward compatibility
   // All original props are passed through
   show: PropTypes.bool.isRequired,
   onClose: PropTypes.func.isRequired,
@@ -78,6 +78,16 @@ TestAndPreviewSlidebox.propTypes = {
   content: PropTypes.string,
   beeInstance: PropTypes.object,
   currentTab: PropTypes.number,
+  smsFallbackContent: PropTypes.shape({
+    templateContent: PropTypes.string,
+    senderId: PropTypes.string,
+    templateName: PropTypes.string,
+    [RCS_SMS_FALLBACK_VAR_MAPPED_PROP]: PropTypes.object,
+  }),
+  /** Passed to CommonTestAndPreview for RCS test-meta resolution (slot semantics vs full-mode). */
+  rcsTestPreviewOptions: PropTypes.shape({
+    isLibraryMode: PropTypes.bool,
+  }),
   // Redux props are passed through
   actions: PropTypes.object.isRequired,
   extractedTags: PropTypes.array.isRequired,
@@ -109,10 +119,12 @@ TestAndPreviewSlidebox.defaultProps = {
   currentTab: 1,
   messageMetaConfigId: null,
   prefilledValues: {},
+  rcsTestPreviewOptions: undefined,
   senderDetailsByChannel: {},
   wecrmAccounts: [],
   isLoadingSenderDetails: false,
   orgUnitId: -1,
+  smsFallbackContent: null,
 };
 
 const mapStateToProps = createStructuredSelector({

package/v2Components/TestAndPreviewSlidebox/sagas.js

@@ -34,6 +34,7 @@ import {
   GET_PREFILLED_VALUES_SUCCESS,
   GET_PREFILLED_VALUES_FAILURE,
 } from './constants';
+import { extractPreviewFromLiquidResponse } from '../CommonTestAndPreview/previewApiUtils';
 
 // Search Customers Saga
 export function* searchCustomersSaga(action) {
@@ -80,11 +81,12 @@ export function* updatePreviewSaga(action) {
     const customValues = action.payload.resolvedTags;
 
     const response = yield call(Api.updateEmailPreview, action.payload);
-    if (response?.data) {
+    const previewPayload = extractPreviewFromLiquidResponse(response);
+    if (previewPayload) {
       yield put({
         type: UPDATE_PREVIEW_SUCCESS,
         payload: {
-          previewData: response.data,
+          previewData: previewPayload,
           customValues, // Pass custom values to be preserved
         },
       });
@@ -221,8 +223,13 @@ export function* createMessageMetaSaga(action) {
 export function* getPrefilledValuesSaga(action) {
   try {
     const response = yield call(Api.updateEmailPreview, action.payload);
-    if (response?.data) {
-      yield put({ type: GET_PREFILLED_VALUES_SUCCESS, payload: { values: response?.data?.resolvedTagValues } });
+    const body =
+      response?.data !== undefined && response?.data !== null
+        ? response.data
+        : response;
+    const resolvedTagValues = body?.resolvedTagValues;
+    if (resolvedTagValues != null) {
+      yield put({ type: GET_PREFILLED_VALUES_SUCCESS, payload: { values: resolvedTagValues } });
     } else {
       yield put({ type: GET_PREFILLED_VALUES_FAILURE, payload: { error: response.error || 'Failed to fetch prefilled values' } });
     }

package/v2Components/TestAndPreviewSlidebox/tests/saga.test.js

@@ -136,7 +136,9 @@ describe('TestAndPreviewSlidebox Sagas', () => {
   describe('updatePreviewSaga', () => {
     it('should handle successful preview update', () => {
       const mockResponse = {
-        data: 'Test Preview Data',
+        data: {
+          resolvedBody: 'Test Preview Data',
+        },
       };
       const customValues = { test: 'value' };
       return expectSaga(sagas.updatePreviewSaga, {

package/v2Components/VarSegmentMessageEditor/constants.js

@@ -0,0 +1,2 @@
+/** Default prefix before variable name in variable-slot placeholders. */
+export const VAR_SEGMENT_PLACEHOLDER_PREFIX = 'enter the value for ';

package/v2Components/VarSegmentMessageEditor/index.js

@@ -0,0 +1,125 @@
+/**
+ * Shared message editor that renders template text with {{var}} and/or DLT `{#var#}` segments as
+ * variable inputs and static text as headings.
+ * Reused by RCS (title/description), SmsTrai Edit (SMS fallback), and WhatsApp (edit message/header).
+ */
+import React from 'react';
+import PropTypes from 'prop-types';
+import CapRow from '@capillarytech/cap-ui-library/CapRow';
+import CapHeading from '@capillarytech/cap-ui-library/CapHeading';
+import CapInput from '@capillarytech/cap-ui-library/CapInput';
+import {
+  splitTemplateVarString,
+  DEFAULT_MUSTACHE_VAR_REGEX,
+  isAnyTemplateVarToken,
+} from '../../utils/templateVarUtils';
+
+import './index.scss';
+import { VAR_SEGMENT_PLACEHOLDER_PREFIX } from './constants';
+
+const { TextArea } = CapInput;
+
+export function VarSegmentMessageEditor({
+  templateString = '',
+  valueMap = {},
+  onChange,
+  onFocus,
+  placeholderPrefix = VAR_SEGMENT_PLACEHOLDER_PREFIX,
+  getPlaceholder,
+  wrapperClassName = 'rcs_text_area_wrapper',
+  rowClassName = 'rcs-edit-template-message-input',
+  headingClassName = 'rcs-edit-template-message-split',
+  varRegex,
+  readOnly = false,
+  disabled = false,
+  footerContent,
+  renderVarFooter,
+}) {
+  const segments = splitTemplateVarString(templateString, varRegex || DEFAULT_MUSTACHE_VAR_REGEX);
+  if (!segments?.length) return null;
+
+  return (
+    <div className={wrapperClassName}>
+      <CapRow className={rowClassName}>
+        {segments.map((segmentToken, segmentIndex) => {
+          const isVar =
+            typeof segmentToken === 'string' && isAnyTemplateVarToken(segmentToken);
+          if (isVar) {
+            const varSegmentFieldId = `${segmentToken}_${segmentIndex}`;
+            const slotValueFromMap = valueMap?.[varSegmentFieldId];
+            // Missing key: show empty (not the raw {{…}} token) so cleared slots and incomplete maps
+            // cannot resurrect the token; placeholder still guides the user.
+            const value =
+              slotValueFromMap !== undefined && slotValueFromMap !== null ? slotValueFromMap : '';
+            if (readOnly) {
+              return (
+                <CapHeading
+                  key={varSegmentFieldId}
+                  type="h4"
+                  className={`${headingClassName} var-segment-message-editor__read-only-value`.trim()}
+                >
+                  {value}
+                </CapHeading>
+              );
+            }
+            const fromGet = getPlaceholder && getPlaceholder(segmentToken, segmentIndex);
+            const placeholder =
+              fromGet !== undefined && fromGet !== null && fromGet !== ''
+                ? fromGet
+                : `${placeholderPrefix}${segmentToken}`;
+            return (
+              <div key={varSegmentFieldId} className="var-segment-message-editor__var-slot">
+                <TextArea
+                  id={varSegmentFieldId}
+                  placeholder={placeholder}
+                  autosize={{ minRows: 1, maxRows: 3 }}
+                  value={value}
+                  onFocus={() => onFocus && onFocus(varSegmentFieldId)}
+                  onChange={(e) =>
+                    onChange && onChange(varSegmentFieldId, e?.target?.value ?? '')}
+                  disabled={disabled}
+                />
+                {renderVarFooter
+                  ? renderVarFooter(segmentToken, segmentIndex, varSegmentFieldId)
+                  : null}
+              </div>
+            );
+          }
+          if (segmentToken) {
+            return (
+              <CapHeading
+                key={`static_${segmentIndex}_${segmentToken}`}
+                type="h4"
+                className={headingClassName}
+              >
+                {segmentToken}
+              </CapHeading>
+            );
+          }
+          return null;
+        })}
+      </CapRow>
+      {footerContent}
+    </div>
+  );
+}
+
+VarSegmentMessageEditor.propTypes = {
+  templateString: PropTypes.string,
+  valueMap: PropTypes.object,
+  onChange: PropTypes.func,
+  onFocus: PropTypes.func,
+  placeholderPrefix: PropTypes.string,
+  getPlaceholder: PropTypes.func,
+  wrapperClassName: PropTypes.string,
+  rowClassName: PropTypes.string,
+  headingClassName: PropTypes.string,
+  varRegex: PropTypes.object,
+  readOnly: PropTypes.bool,
+  disabled: PropTypes.bool,
+  footerContent: PropTypes.node,
+  /** Optional hint below a variable field (e.g. DLT `{#var#}` max length). */
+  renderVarFooter: PropTypes.func,
+};
+
+export default VarSegmentMessageEditor;