@heartlandone/vega 2.77.0 → 2.78.0

package/dist/collection/components/vega-textarea/vega-textarea.js

@@ -53,113 +53,181 @@ export class VegaTextarea {
     this.vegaComponentUsageRuntimeMetricsSlimmer = new VegaComponentUsageRuntimeMetricsSlimmer(VegaTextareaRuntimeMetricsPayloadDefinition);
     this.currentCharCount = 0;
     /**
-     * Specifies a placeholder string that displays as a
-     *    temporary hint or example within the text area.
+     * Specifies a placeholder string that displays as a temporary hint or
+     * example within the text area. The placeholder text is shown when the
+     * field is empty and disappears once the user begins typing.
      *
-     * It indicates the expected format or pattern of
-     *    the input within the text area.
+     * Use this to indicate the expected format or content of the input,
+     * for example `'Enter your comments here...'`.
      *
+     * @default ''
      * @vegaVersion 1.11.0
      */
     this.placeholder = '';
     /**
-     * Provides a supplementary prompt message that assists users in
-     *    understanding the expected value within the text area.
+     * Provides a supplementary helper message displayed below the text area
+     * that assists users in understanding the expected value or format.
      *
+     * The hint is visible at all times (not just on focus) and is typically
+     * used for guidance such as character requirements or formatting rules.
+     *
+     * @default ''
      * @vegaVersion 1.11.0
      */
     this.hint = '';
     /**
-     * Specifies whether the text area is disabled.
+     * Specifies whether the text area is disabled. When `true`, the text area
+     * is non-interactive — the user cannot type, focus, or select the field.
+     * The disabled state is reflected as an HTML attribute for CSS styling.
      *
+     * @default false
      * @vegaVersion 1.11.0
      */
     this.disabled = false;
     /**
-     * Specifies the label or title for the text area.
+     * Specifies the visible label text rendered above the text area. The label
+     * helps identify the purpose or content expected within the field and also
+     * serves as the accessible `aria-label` for screen readers when present.
      *
-     * It provides descriptive text that helps identify the
-     *    purpose or content expected within the text area.
+     * Clicking the label will focus the text area.
      *
+     * @default ''
      * @vegaVersion 1.11.0
      */
     this.label = '';
     /**
-     * Specifies the properties for the suffix button associated with the input.
+     * Configuration object for an optional suffix button rendered beside the
+     * field label. Use this to provide an inline action (e.g., a help or info
+     * button) next to the label text.
      *
-     * It provides essential information and functionality
-     *  related to the suffix button's role and behavior.
+     * When the button is clicked, the `vegaLabelButtonClick` event is emitted.
+     * Set to `null` to hide the suffix button.
      *
+     * @default null
      * @vegaVersion 2.68.0
      */
     this.labelSuffixButtonConfig = null;
     /**
-     * Determines whether to display a character counter
-     *    for the textarea.
+     * Determines whether to display a live character counter below the text area.
+     *
+     * When `true`, the counter shows the current character count. If `maxLength`
+     * is also set, the counter displays in the format `current/max` and visually
+     * highlights when the limit is exceeded.
      *
+     * @default false
      * @vegaVersion 1.11.0
      */
     this.showCounter = false;
     /**
-     * Specifies the initial value or content of the
-     *    textarea field.
+     * The current value (content) of the text area field.
      *
+     * This property is mutable and will be updated programmatically when the
+     * user types into the text area. It can also be set externally to
+     * pre-populate or reset the field. Changes to this property trigger the
+     * `vegaChange` event and update the character counter if `showCounter`
+     * is enabled. Supports two-way binding in framework wrappers.
+     *
+     * @default ''
      * @vegaVersion 1.11.0
      */
     /* eslint-disable-next-line @stencil/strict-mutable */
     this.value = '';
     /**
-     * Specifies the validation status of the
-     *    text area component.
+     * Reflects the current validation status of the text area.
+     *
+     * - `true` — the field value passes all validation rules.
+     * - `false` — one or more validation rules have failed.
+     * - `null` — the field has not been validated yet (initial state).
      *
+     * This property is mutable: it is updated automatically when
+     * `autoValidation` is enabled, but can also be set manually to override
+     * the validation state. The value is reflected as an HTML attribute.
+     *
+     * @default null
      * @vegaVersion 1.11.0
      */
     /* eslint-disable-next-line @stencil/strict-mutable */
     this.isValid = null;
     /**
-     * Determines whether automatic validation should be
-     *    implemented for the text area.
+     * Determines whether the text area should be validated automatically as the
+     * user types. When `true`, validation rules (including `required`, `minLength`,
+     * `maxLength`, and custom `validationRules`) are evaluated on blur and the
+     * `isValid` property is updated accordingly.
+     *
+     * Set to `false` to handle validation manually.
      *
+     * @default true
      * @vegaVersion 1.11.0
      */
     this.autoValidation = true;
     /**
-     * Determines whether the content of the textarea must be
-     *    provided by the user before submitting the form or
-     *    completing the input process.
+     * Determines whether the text area must have a non-empty value before the
+     * form can be submitted. When `true`, a required-field indicator is shown
+     * on the label and the built-in `RequiredFieldRule` is applied during
+     * validation.
      *
+     * @default false
      * @vegaVersion 1.11.0
      */
     /* eslint-disable-next-line @stencil/strict-mutable */
     this.required = false;
     /**
-     * Specifies the maximum number of characters (UTF-16 code units)
-     *    that the user can enter in the text area.
+     * Specifies the maximum number of characters (UTF-16 code units) that the
+     * user can enter in the text area. The native `maxlength` attribute is
+     * applied to the inner `<textarea>` element.
+     *
+     * When `showCounter` is `true`, the maximum value is displayed alongside
+     * the current character count (e.g., `42/200`). Exceeding this limit
+     * triggers a visual warning on the counter and fails the
+     * `MaxStringLengthRule` during validation.
+     *
+     * Set to `null` to allow unlimited input.
      *
+     * @default null
      * @vegaVersion 1.11.0
      */
     this.maxLength = null;
-    /** Specifies the minimum number of characters (UTF-16 code units)
-     *    that the user must enter in the text area.
+    /**
+     * Specifies the minimum number of characters (UTF-16 code units) that the
+     * user must enter in the text area for the value to be considered valid.
+     * The native `minlength` attribute is applied to the inner `<textarea>`
+     * element.
+     *
+     * When set, the `MinStringLengthRule` is applied during validation. Set to
+     * `null` to impose no minimum length.
      *
+     * @default null
      * @vegaVersion 1.11.0
      */
     this.minLength = null;
     /**
-     * Determines whether the text area is vertically resizable.
+     * Determines whether the user can vertically resize the text area by
+     * dragging its bottom-right corner. When `false`, the resize handle is
+     * hidden via CSS and the text area height is fixed.
      *
+     * @default true
      * @vegaVersion 2.19.0
      */
     this.resizable = true;
     /**
-     * Specifies the number of visible lines in the textarea. The value must be an integer greater than or equal to 2.
+     * Specifies the number of visible text lines in the text area, controlling
+     * its initial height. Accepts integers ≥ 2. For optimal display, values
+     * below 2 are internally adjusted to 4 rows.
      *
+     * @default 5
      * @vegaVersion 2.63.0
      */
     this.rows = 5;
     /**
-     * Specifies custom validation rules for the text area.
+     * An array of custom validation rules applied to the text area in addition
+     * to the built-in rules (`RequiredFieldRule`, `MinStringLengthRule`,
+     * `MaxStringLengthRule`). Each rule must implement the
+     * `FormFieldValidationRule` interface.
      *
+     * Rules are evaluated in order when `autoValidation` is enabled or when
+     * validation is triggered programmatically.
+     *
+     * @default []
      * @vegaVersion 1.11.0
      */
     this.validationRules = [];
@@ -269,10 +337,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "''"
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "Specifies a placeholder string that displays as a\n   temporary hint or example within the text area.\n\nIt indicates the expected format or pattern of\n   the input within the text area."
+        "text": "Specifies a placeholder string that displays as a temporary hint or\nexample within the text area. The placeholder text is shown when the\nfield is empty and disappears once the user begins typing.\n\nUse this to indicate the expected format or content of the input,\nfor example `'Enter your comments here...'`."
       },
       "attribute": "placeholder",
       "reflect": false,
@@ -290,10 +361,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "''"
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "Provides a supplementary prompt message that assists users in\n   understanding the expected value within the text area."
+        "text": "Provides a supplementary helper message displayed below the text area\nthat assists users in understanding the expected value or format.\n\nThe hint is visible at all times (not just on focus) and is typically\nused for guidance such as character requirements or formatting rules."
       },
       "attribute": "hint",
       "reflect": false,
@@ -311,10 +385,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "false"
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "Specifies whether the text area is disabled."
+        "text": "Specifies whether the text area is disabled. When `true`, the text area\nis non-interactive \u2014 the user cannot type, focus, or select the field.\nThe disabled state is reflected as an HTML attribute for CSS styling."
       },
       "attribute": "disabled",
       "reflect": true,
@@ -332,10 +409,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "''"
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "Specifies the label or title for the text area.\n\nIt provides descriptive text that helps identify the\n   purpose or content expected within the text area."
+        "text": "Specifies the visible label text rendered above the text area. The label\nhelps identify the purpose or content expected within the field and also\nserves as the accessible `aria-label` for screen readers when present.\n\nClicking the label will focus the text area."
       },
       "attribute": "label",
       "reflect": false,
@@ -362,10 +442,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "null"
+          }, {
             "name": "vegaVersion",
             "text": "2.68.0"
           }],
-        "text": "Specifies the properties for the suffix button associated with the input.\n\nIt provides essential information and functionality\n related to the suffix button's role and behavior."
+        "text": "Configuration object for an optional suffix button rendered beside the\nfield label. Use this to provide an inline action (e.g., a help or info\nbutton) next to the label text.\n\nWhen the button is clicked, the `vegaLabelButtonClick` event is emitted.\nSet to `null` to hide the suffix button."
       },
       "defaultValue": "null"
     },
@@ -381,10 +464,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "false"
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "Determines whether to display a character counter\n   for the textarea."
+        "text": "Determines whether to display a live character counter below the text area.\n\nWhen `true`, the counter shows the current character count. If `maxLength`\nis also set, the counter displays in the format `current/max` and visually\nhighlights when the limit is exceeded."
       },
       "attribute": "show-counter",
       "reflect": false,
@@ -402,10 +488,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "''"
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "Specifies the initial value or content of the\n   textarea field."
+        "text": "The current value (content) of the text area field.\n\nThis property is mutable and will be updated programmatically when the\nuser types into the text area. It can also be set externally to\npre-populate or reset the field. Changes to this property trigger the\n`vegaChange` event and update the character counter if `showCounter`\nis enabled. Supports two-way binding in framework wrappers."
       },
       "attribute": "value",
       "reflect": true,
@@ -423,10 +512,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "null"
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "Specifies the validation status of the\n   text area component."
+        "text": "Reflects the current validation status of the text area.\n\n- `true` \u2014 the field value passes all validation rules.\n- `false` \u2014 one or more validation rules have failed.\n- `null` \u2014 the field has not been validated yet (initial state).\n\nThis property is mutable: it is updated automatically when\n`autoValidation` is enabled, but can also be set manually to override\nthe validation state. The value is reflected as an HTML attribute."
       },
       "attribute": "is-valid",
       "reflect": true,
@@ -444,10 +536,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "true"
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "Determines whether automatic validation should be\n   implemented for the text area."
+        "text": "Determines whether the text area should be validated automatically as the\nuser types. When `true`, validation rules (including `required`, `minLength`,\n`maxLength`, and custom `validationRules`) are evaluated on blur and the\n`isValid` property is updated accordingly.\n\nSet to `false` to handle validation manually."
       },
       "attribute": "auto-validation",
       "reflect": true,
@@ -465,10 +560,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "false"
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "Determines whether the content of the textarea must be\n   provided by the user before submitting the form or\n   completing the input process."
+        "text": "Determines whether the text area must have a non-empty value before the\nform can be submitted. When `true`, a required-field indicator is shown\non the label and the built-in `RequiredFieldRule` is applied during\nvalidation."
       },
       "attribute": "required",
       "reflect": true,
@@ -486,10 +584,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "null"
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "Specifies the maximum number of characters (UTF-16 code units)\n   that the user can enter in the text area."
+        "text": "Specifies the maximum number of characters (UTF-16 code units) that the\nuser can enter in the text area. The native `maxlength` attribute is\napplied to the inner `<textarea>` element.\n\nWhen `showCounter` is `true`, the maximum value is displayed alongside\nthe current character count (e.g., `42/200`). Exceeding this limit\ntriggers a visual warning on the counter and fails the\n`MaxStringLengthRule` during validation.\n\nSet to `null` to allow unlimited input."
       },
       "attribute": "max-length",
       "reflect": true,
@@ -507,10 +608,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "null"
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "Specifies the minimum number of characters (UTF-16 code units)\n  that the user must enter in the text area."
+        "text": "Specifies the minimum number of characters (UTF-16 code units) that the\nuser must enter in the text area for the value to be considered valid.\nThe native `minlength` attribute is applied to the inner `<textarea>`\nelement.\n\nWhen set, the `MinStringLengthRule` is applied during validation. Set to\n`null` to impose no minimum length."
       },
       "attribute": "min-length",
       "reflect": true,
@@ -528,10 +632,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "true"
+          }, {
             "name": "vegaVersion",
             "text": "2.19.0"
           }],
-        "text": "Determines whether the text area is vertically resizable."
+        "text": "Determines whether the user can vertically resize the text area by\ndragging its bottom-right corner. When `false`, the resize handle is\nhidden via CSS and the text area height is fixed."
       },
       "attribute": "resizable",
       "reflect": false,
@@ -549,10 +656,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "5"
+          }, {
             "name": "vegaVersion",
             "text": "2.63.0"
           }],
-        "text": "Specifies the number of visible lines in the textarea. The value must be an integer greater than or equal to 2."
+        "text": "Specifies the number of visible text lines in the text area, controlling\nits initial height. Accepts integers \u2265 2. For optimal display, values\nbelow 2 are internally adjusted to 4 rows."
       },
       "attribute": "rows",
       "reflect": false,
@@ -575,10 +685,13 @@ export class VegaTextarea {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "default",
+            "text": "[]"
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "Specifies custom validation rules for the text area."
+        "text": "An array of custom validation rules applied to the text area in addition\nto the built-in rules (`RequiredFieldRule`, `MinStringLengthRule`,\n`MaxStringLengthRule`). Each rule must implement the\n`FormFieldValidationRule` interface.\n\nRules are evaluated in order when `autoValidation` is enabled or when\nvalidation is triggered programmatically."
       },
       "defaultValue": "[]"
     }
@@ -594,10 +707,13 @@ export class VegaTextarea {
       "composed": true,
       "docs": {
         "tags": [{
+            "name": "eventDetail",
+            "text": "string \u2014 The updated text area value."
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "An event emitter notifying about changes in the value\n   of the text area."
+        "text": "Fired whenever the text area value changes, whether by user input or\nprogrammatic update of the `value` property. This is the primary event\nfor reacting to content changes and implementing two-way binding."
       },
       "complexType": {
         "original": "string",
@@ -612,13 +728,16 @@ export class VegaTextarea {
       "composed": true,
       "docs": {
         "tags": [{
+            "name": "eventDetail",
+            "text": "string \u2014 The updated text area value."
+          }, {
             "name": "eventSemantics",
             "text": "namespace:native"
           }, {
             "name": "vegaVersion",
             "text": "2.0.0"
           }],
-        "text": "An event emitter notifying about changes in the value\n   of the text area."
+        "text": "Native-namespace mirror of `vegaChange`. Fired whenever the text area\nvalue changes. Provided for compatibility with standard DOM event\nlisteners."
       },
       "complexType": {
         "original": "string",
@@ -633,10 +752,13 @@ export class VegaTextarea {
       "composed": true,
       "docs": {
         "tags": [{
+            "name": "eventDetail",
+            "text": "undefined \u2014 No payload; signals the blur occurrence only."
+          }, {
             "name": "vegaVersion",
             "text": "1.11.0"
           }],
-        "text": "An event emitter notifying the blur event of the inner\n   textarea element within the text area."
+        "text": "Fired when the inner `<textarea>` element loses focus (blur). Use this\nevent to trigger validation or save actions when the user leaves the\ntext area."
       },
       "complexType": {
         "original": "undefined",
@@ -651,13 +773,16 @@ export class VegaTextarea {
       "composed": true,
       "docs": {
         "tags": [{
+            "name": "eventDetail",
+            "text": "undefined \u2014 No payload; signals the blur occurrence only."
+          }, {
             "name": "eventSemantics",
             "text": "namespace:native"
           }, {
             "name": "vegaVersion",
             "text": "2.0.0"
           }],
-        "text": "An event emitter notifying the blur event of the inner\n   textarea element within the text area."
+        "text": "Native-namespace mirror of `vegaBlur`. Fired when the inner `<textarea>`\nelement loses focus. Provided for compatibility with standard DOM event\nlisteners."
       },
       "complexType": {
         "original": "undefined",
@@ -672,10 +797,13 @@ export class VegaTextarea {
       "composed": true,
       "docs": {
         "tags": [{
+            "name": "eventDetail",
+            "text": "void"
+          }, {
             "name": "vegaVersion",
             "text": "2.68.0"
           }],
-        "text": "An event emitter notifying that the suffix button associated with the field label has been clicked."
+        "text": "Fired when the suffix button configured via `labelSuffixButtonConfig` is\nclicked. Listen for this event to handle inline label actions such as\nopening a help dialog or toggling additional information."
       },
       "complexType": {
         "original": "any",
@@ -690,13 +818,16 @@ export class VegaTextarea {
       "composed": true,
       "docs": {
         "tags": [{
+            "name": "eventDetail",
+            "text": "void"
+          }, {
             "name": "eventSemantics",
             "text": "namespace:native"
           }, {
             "name": "vegaVersion",
             "text": "2.68.0"
           }],
-        "text": "An event emitter notifying that the suffix button associated with the field label has been clicked."
+        "text": "Native-namespace mirror of `vegaLabelButtonClick`. Fired when the label\nsuffix button is clicked. Provided for compatibility with standard DOM\nevent listeners."
       },
       "complexType": {
         "original": "any",

package/dist/collection/components/vega-tooltip/vega-tooltip-content-box/vega-tooltip-content-box.css

@@ -66,6 +66,11 @@
   }
 }
 
+:host(.vega-no-suitable-placement) .vega-tooltip-content::after,
+:host(.vega-no-suitable-alignment) .vega-tooltip-content::after {
+  display: none;
+}
+
 .vega-tooltip-content::after {
   content: "";
   position: absolute;

package/dist/collection/constants/ui.js

@@ -12,7 +12,14 @@ export const Placements = ['top', 'left', 'bottom', 'right'];
 export const Alignments = ['start', 'center', 'end'];
 export const ItemToggleTransitionMillisecond = 1500;
 // eslint-disable-next-line @typescript-eslint/typedef
-export const FlexDirections = ['row', 'col', 'row-reverse', 'col-reverse'];
+export const FlexDirections = [
+  'row',
+  'col',
+  'column',
+  'row-reverse',
+  'col-reverse',
+  'column-reverse',
+];
 // eslint-disable-next-line @typescript-eslint/typedef
 export const FlexAlignItem = ['start', 'center', 'end', 'baseline', 'stretch'];
 // eslint-disable-next-line @typescript-eslint/typedef
@@ -93,6 +100,7 @@ export const VegaNativeEventName = [
   'selectionChange',
   'suggestionItemClick',
   'nativeInputChange',
+  'sourceCodeChange',
 ];
 // eslint-disable-next-line @typescript-eslint/typedef
 export const CssStates = ['default', 'hover', 'active', 'focus-visible'];

package/dist/collection/helpers/calendar/test/utils.test.js

@@ -1,4 +1,5 @@
-import { getWeekdays } from '../utils';
+import { getWeekdays, buildDatePickerAnnouncement, getSystemTimezone } from '../utils';
+import { CalendarDate } from '../calendar-date';
 describe('utils', () => {
   it('should return weekdays as expected by default', () => {
     expect(getWeekdays()).toEqual([0, 1, 2, 3, 4, 5, 6]);
@@ -6,4 +7,56 @@ describe('utils', () => {
   it('should return weekdays as expected when change the firstWeekDay', () => {
     expect(getWeekdays(1)).toEqual([1, 2, 3, 4, 5, 6, 0]);
   });
+  it('should return a non-empty string for getSystemTimezone', () => {
+    expect(typeof getSystemTimezone()).toBe('string');
+    expect(getSystemTimezone().length).toBeGreaterThan(0);
+  });
+  describe('buildDatePickerAnnouncement', () => {
+    it('should return empty string when both startDate and endDate are null', () => {
+      expect(buildDatePickerAnnouncement({ mode: 'single', startDate: null })).toBe('');
+      expect(buildDatePickerAnnouncement({ mode: 'range', startDate: null, endDate: null })).toBe('');
+    });
+    it('should return single mode announcement with startDate', () => {
+      const startDate = new CalendarDate(2025, 3, 15);
+      const result = buildDatePickerAnnouncement({ mode: 'single', startDate });
+      expect(result).toContain('Selected result');
+      expect(result).toContain('March');
+      expect(result).toContain('15');
+      expect(result).toContain('2025');
+    });
+    it('should return empty string for single mode without startDate', () => {
+      expect(buildDatePickerAnnouncement({ mode: 'single', startDate: null })).toBe('');
+    });
+    it('should return range mode announcement with both startDate and endDate', () => {
+      const startDate = new CalendarDate(2025, 3, 10);
+      const endDate = new CalendarDate(2025, 3, 20);
+      const result = buildDatePickerAnnouncement({ mode: 'range', startDate, endDate });
+      expect(result).toContain('Selected result');
+      expect(result).toContain('Start Date');
+      expect(result).toContain('End Date');
+      expect(result).toContain('March');
+      expect(result).toContain('10');
+      expect(result).toContain('20');
+    });
+    it('should return range mode announcement with only startDate', () => {
+      const startDate = new CalendarDate(2025, 6, 1);
+      const result = buildDatePickerAnnouncement({ mode: 'range', startDate, endDate: null });
+      expect(result).toContain('Selected result');
+      expect(result).toContain('Start Date');
+      expect(result).toContain('June');
+      expect(result).toContain('1');
+      expect(result).not.toContain('End Date');
+    });
+    it('should return empty string for range mode without any dates', () => {
+      expect(buildDatePickerAnnouncement({ mode: 'range', startDate: null, endDate: null })).toBe('');
+    });
+    it('should return empty string for range mode with only endDate', () => {
+      const endDate = new CalendarDate(2025, 3, 20);
+      expect(buildDatePickerAnnouncement({ mode: 'range', startDate: null, endDate })).toBe('');
+    });
+    it('should return empty string for single mode with only endDate', () => {
+      const endDate = new CalendarDate(2025, 3, 20);
+      expect(buildDatePickerAnnouncement({ mode: 'single', startDate: null, endDate })).toBe('');
+    });
+  });
 });