chore: Adds docs for setInputValue helper in date-input test utils (#3682)

Author: pan-kot

src/__tests__/snapshot-tests/__snapshots__/documenter.test.ts.snap

@@ -37350,15 +37350,14 @@ Returns the current value of the input.
           },
         },
         {
-          "description": "Sets the value of the component and calls the \`onChange\` handler",
-          "inheritedFrom": {
-            "name": "BaseInputWrapper.setInputValue",
-          },
+          "description": "Sets the value of the component and calls the \`onChange\` handler.
+The value needs to use the "YYYY/MM/DD" format,
+but the subsequent \`onChange\` handler will contain the value in the "YYYY-MM-DD" format.",
           "name": "setInputValue",
           "parameters": [
             {
               "description": "
-The value the input is set to.
+The value the input is set to, using the "YYYY/MM/DD" format.
 ",
               "flags": {
                 "isOptional": false,

src/date-input/__tests__/date-input.test.tsx

@@ -314,4 +314,10 @@ describe('Date Input component', () => {
       expect(onChangeSpy).toHaveBeenCalledWith(expect.objectContaining({ detail: { value: '2019-02-28' } }));
     });
   }); // end entering value in middle of input
+
+  test('uses setInputValue test utils method', () => {
+    const { wrapper, onChangeSpy } = renderDateInput({ value: '' });
+    wrapper.setInputValue('2019/01/31');
+    expect(onChangeSpy).toHaveBeenCalledWith(expect.objectContaining({ detail: { value: '2019-01-31' } }));
+  });
 });

src/test-utils/dom/date-input/index.ts

@@ -1,9 +1,23 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
+
+import { usesDom } from '@cloudscape-design/test-utils-core/dom';
+
 import BaseInputWrapper from '../input/base-input';
 
 import selectors from '../../../date-input/styles.selectors.js';
 
 export default class DateInputWrapper extends BaseInputWrapper {
   static rootSelector: string = selectors.root;
+
+  /**
+   * Sets the value of the component and calls the `onChange` handler.
+   * The value needs to use the "YYYY/MM/DD" format,
+   * but the subsequent `onChange` handler will contain the value in the "YYYY-MM-DD" format.
+   *
+   * @param value The value the input is set to, using the "YYYY/MM/DD" format.
+   */
+  @usesDom setInputValue(value: string): void {
+    return super.setInputValue(value);
+  }
 }