From af69cbe159aa4a4eb2fa9b7242f81113adebdad8 Mon Sep 17 00:00:00 2001 From: Johnnie Chen Date: Fri, 18 Sep 2026 14:13:33 -0400 Subject: [PATCH] Clarify NumberField and MoneyField events (2026-01) --- .../generated/generated_docs_data_v2.json | 20 +++++++++---------- .../2026-01/generated_docs_data_v2.json | 20 +++++++++---------- .../checkout/components/MoneyField.d.ts | 16 +++------------ .../checkout/components/NumberField.d.ts | 16 +++------------ 4 files changed, 26 insertions(+), 46 deletions(-) diff --git a/packages/ui-extensions/docs/surfaces/checkout/generated/generated_docs_data_v2.json b/packages/ui-extensions/docs/surfaces/checkout/generated/generated_docs_data_v2.json index 19ec0598a1..e4aaee1a31 100644 --- a/packages/ui-extensions/docs/surfaces/checkout/generated/generated_docs_data_v2.json +++ b/packages/ui-extensions/docs/surfaces/checkout/generated/generated_docs_data_v2.json @@ -96886,7 +96886,7 @@ "syntaxKind": "PropertySignature", "name": "blur", "value": "CallbackEventListener", - "description": "<<<<<<< HEAD A callback fired when the element loses focus. Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n======= A callback fired when the money field loses focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) \n Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).", + "description": "A callback fired when the money field loses focus.\n\nLearn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).", "isOptional": true }, { @@ -96894,7 +96894,7 @@ "syntaxKind": "PropertySignature", "name": "change", "value": "CallbackEventListener", - "description": "<<<<<<< HEAD Callback when the user has **finished editing** a field, for example, once they have blurred the field.\n======= A callback fired when the money field value changes.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) \n Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).", + "description": "A callback fired when the money field value is committed on blur or after pressing Enter. Also fired on each step when using the Up Arrow and Down Arrow keys.\n\nLearn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).", "isOptional": true }, { @@ -96902,7 +96902,7 @@ "syntaxKind": "PropertySignature", "name": "focus", "value": "CallbackEventListener", - "description": "<<<<<<< HEAD A callback fired when the element receives focus. Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n======= A callback fired when the money field receives focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) \n Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).", + "description": "A callback fired when the money field receives focus.\n\nLearn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).", "isOptional": true }, { @@ -96910,11 +96910,11 @@ "syntaxKind": "PropertySignature", "name": "input", "value": "CallbackEventListener", - "description": "A callback fired when the user inputs data into the money field.\n\nLearn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).", + "description": "A callback fired when the user inputs data into the money field. Also fired on each step when using the Up Arrow and Down Arrow keys.\n\nLearn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).", "isOptional": true } ], - "value": "export interface MoneyFieldElementEvents {\n /**\n<<<<<<< HEAD\n * A callback fired when the element loses focus. Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n=======\n * A callback fired when the money field loses focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality)\n *\n * Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n */\n blur?: CallbackEventListener;\n /**\n<<<<<<< HEAD\n * Callback when the user has **finished editing** a field, for example, once they have blurred the field.\n=======\n * A callback fired when the money field value changes.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality)\n *\n * Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).\n */\n change?: CallbackEventListener;\n /**\n<<<<<<< HEAD\n * A callback fired when the element receives focus. Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n=======\n * A callback fired when the money field receives focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality)\n *\n * Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n */\n focus?: CallbackEventListener;\n /**\n * A callback fired when the user inputs data into the money field.\n *\n * Learn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).\n */\n input?: CallbackEventListener;\n}" + "value": "export interface MoneyFieldElementEvents {\n /**\n * A callback fired when the money field loses focus.\n *\n * Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n */\n blur?: CallbackEventListener;\n /**\n * A callback fired when the money field value is committed on blur or after pressing Enter.\n * Also fired on each step when using the Up Arrow and Down Arrow keys.\n *\n * Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).\n */\n change?: CallbackEventListener;\n /**\n * A callback fired when the money field receives focus.\n *\n * Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n */\n focus?: CallbackEventListener;\n /**\n * A callback fired when the user inputs data into the money field.\n * Also fired on each step when using the Up Arrow and Down Arrow keys.\n *\n * Learn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).\n */\n input?: CallbackEventListener;\n}" } }, "MoneyFieldElement": { @@ -97480,7 +97480,7 @@ "syntaxKind": "PropertySignature", "name": "blur", "value": "CallbackEventListener", - "description": "<<<<<<< HEAD A callback fired when the element loses focus. Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n======= A callback fired when the number field loses focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) \n Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).", + "description": "A callback fired when the number field loses focus.\n\nLearn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).", "isOptional": true }, { @@ -97488,7 +97488,7 @@ "syntaxKind": "PropertySignature", "name": "change", "value": "CallbackEventListener", - "description": "<<<<<<< HEAD Callback when the user has **finished editing** a field, for example, once they have blurred the field.\n======= A callback fired when the number field value changes.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) \n Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).", + "description": "A callback fired when the number field value is committed on blur or after pressing Enter. Also fired on each step when using the increment/decrement controls or the Up Arrow and Down Arrow keys.\n\nLearn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).", "isOptional": true }, { @@ -97496,7 +97496,7 @@ "syntaxKind": "PropertySignature", "name": "focus", "value": "CallbackEventListener", - "description": "<<<<<<< HEAD A callback fired when the element receives focus. Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n======= A callback fired when the number field receives focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) \n Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).", + "description": "A callback fired when the number field receives focus.\n\nLearn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).", "isOptional": true }, { @@ -97504,11 +97504,11 @@ "syntaxKind": "PropertySignature", "name": "input", "value": "CallbackEventListener", - "description": "A callback fired when the user inputs data into the number field.\n\nLearn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).", + "description": "A callback fired when the user inputs data into the number field. Also fired on each step when using the increment/decrement controls or the Up Arrow and Down Arrow keys.\n\nLearn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).", "isOptional": true } ], - "value": "export interface NumberFieldElementEvents {\n /**\n<<<<<<< HEAD\n * A callback fired when the element loses focus. Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n=======\n * A callback fired when the number field loses focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality)\n *\n * Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n */\n blur?: CallbackEventListener;\n /**\n<<<<<<< HEAD\n * Callback when the user has **finished editing** a field, for example, once they have blurred the field.\n=======\n * A callback fired when the number field value changes.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality)\n *\n * Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).\n */\n change?: CallbackEventListener;\n /**\n<<<<<<< HEAD\n * A callback fired when the element receives focus. Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n=======\n * A callback fired when the number field receives focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality)\n *\n * Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n */\n focus?: CallbackEventListener;\n /**\n * A callback fired when the user inputs data into the number field.\n *\n * Learn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).\n */\n input?: CallbackEventListener;\n}" + "value": "export interface NumberFieldElementEvents {\n /**\n * A callback fired when the number field loses focus.\n *\n * Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n */\n blur?: CallbackEventListener;\n /**\n * A callback fired when the number field value is committed on blur or after pressing Enter.\n * Also fired on each step when using the increment/decrement controls or the Up Arrow and Down Arrow keys.\n *\n * Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).\n */\n change?: CallbackEventListener;\n /**\n * A callback fired when the number field receives focus.\n *\n * Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n */\n focus?: CallbackEventListener;\n /**\n * A callback fired when the user inputs data into the number field.\n * Also fired on each step when using the increment/decrement controls or the Up Arrow and Down Arrow keys.\n *\n * Learn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).\n */\n input?: CallbackEventListener;\n}" } }, "NumberFieldElementSlots": { diff --git a/packages/ui-extensions/docs/surfaces/customer-account/generated/customer_account_ui_extensions/2026-01/generated_docs_data_v2.json b/packages/ui-extensions/docs/surfaces/customer-account/generated/customer_account_ui_extensions/2026-01/generated_docs_data_v2.json index 89cf78cfb9..af6649902f 100644 --- a/packages/ui-extensions/docs/surfaces/customer-account/generated/customer_account_ui_extensions/2026-01/generated_docs_data_v2.json +++ b/packages/ui-extensions/docs/surfaces/customer-account/generated/customer_account_ui_extensions/2026-01/generated_docs_data_v2.json @@ -124770,7 +124770,7 @@ "syntaxKind": "PropertySignature", "name": "blur", "value": "CallbackEventListener", - "description": "<<<<<<< HEAD A callback fired when the element loses focus. Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n======= A callback fired when the money field loses focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) \n Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).", + "description": "A callback fired when the money field loses focus.\n\nLearn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).", "isOptional": true }, { @@ -124778,7 +124778,7 @@ "syntaxKind": "PropertySignature", "name": "change", "value": "CallbackEventListener", - "description": "<<<<<<< HEAD Callback when the user has **finished editing** a field, for example, once they have blurred the field.\n======= A callback fired when the money field value changes.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) \n Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).", + "description": "A callback fired when the money field value is committed on blur or after pressing Enter. Also fired on each step when using the Up Arrow and Down Arrow keys.\n\nLearn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).", "isOptional": true }, { @@ -124786,7 +124786,7 @@ "syntaxKind": "PropertySignature", "name": "focus", "value": "CallbackEventListener", - "description": "<<<<<<< HEAD A callback fired when the element receives focus. Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n======= A callback fired when the money field receives focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) \n Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).", + "description": "A callback fired when the money field receives focus.\n\nLearn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).", "isOptional": true }, { @@ -124794,11 +124794,11 @@ "syntaxKind": "PropertySignature", "name": "input", "value": "CallbackEventListener", - "description": "A callback fired when the user inputs data into the money field.\n\nLearn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).", + "description": "A callback fired when the user inputs data into the money field. Also fired on each step when using the Up Arrow and Down Arrow keys.\n\nLearn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).", "isOptional": true } ], - "value": "export interface MoneyFieldElementEvents {\n /**\n<<<<<<< HEAD\n * A callback fired when the element loses focus. Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n=======\n * A callback fired when the money field loses focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality)\n *\n * Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n */\n blur?: CallbackEventListener;\n /**\n<<<<<<< HEAD\n * Callback when the user has **finished editing** a field, for example, once they have blurred the field.\n=======\n * A callback fired when the money field value changes.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality)\n *\n * Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).\n */\n change?: CallbackEventListener;\n /**\n<<<<<<< HEAD\n * A callback fired when the element receives focus. Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n=======\n * A callback fired when the money field receives focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality)\n *\n * Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n */\n focus?: CallbackEventListener;\n /**\n * A callback fired when the user inputs data into the money field.\n *\n * Learn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).\n */\n input?: CallbackEventListener;\n}" + "value": "export interface MoneyFieldElementEvents {\n /**\n * A callback fired when the money field loses focus.\n *\n * Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n */\n blur?: CallbackEventListener;\n /**\n * A callback fired when the money field value is committed on blur or after pressing Enter.\n * Also fired on each step when using the Up Arrow and Down Arrow keys.\n *\n * Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).\n */\n change?: CallbackEventListener;\n /**\n * A callback fired when the money field receives focus.\n *\n * Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n */\n focus?: CallbackEventListener;\n /**\n * A callback fired when the user inputs data into the money field.\n * Also fired on each step when using the Up Arrow and Down Arrow keys.\n *\n * Learn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).\n */\n input?: CallbackEventListener;\n}" } }, "MoneyFieldElement": { @@ -125364,7 +125364,7 @@ "syntaxKind": "PropertySignature", "name": "blur", "value": "CallbackEventListener", - "description": "<<<<<<< HEAD A callback fired when the element loses focus. Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n======= A callback fired when the number field loses focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) \n Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).", + "description": "A callback fired when the number field loses focus.\n\nLearn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).", "isOptional": true }, { @@ -125372,7 +125372,7 @@ "syntaxKind": "PropertySignature", "name": "change", "value": "CallbackEventListener", - "description": "<<<<<<< HEAD Callback when the user has **finished editing** a field, for example, once they have blurred the field.\n======= A callback fired when the number field value changes.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) \n Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).", + "description": "A callback fired when the number field value is committed on blur or after pressing Enter. Also fired on each step when using the increment/decrement controls or the Up Arrow and Down Arrow keys.\n\nLearn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).", "isOptional": true }, { @@ -125380,7 +125380,7 @@ "syntaxKind": "PropertySignature", "name": "focus", "value": "CallbackEventListener", - "description": "<<<<<<< HEAD A callback fired when the element receives focus. Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n======= A callback fired when the number field receives focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) \n Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).", + "description": "A callback fired when the number field receives focus.\n\nLearn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).", "isOptional": true }, { @@ -125388,11 +125388,11 @@ "syntaxKind": "PropertySignature", "name": "input", "value": "CallbackEventListener", - "description": "A callback fired when the user inputs data into the number field.\n\nLearn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).", + "description": "A callback fired when the user inputs data into the number field. Also fired on each step when using the increment/decrement controls or the Up Arrow and Down Arrow keys.\n\nLearn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).", "isOptional": true } ], - "value": "export interface NumberFieldElementEvents {\n /**\n<<<<<<< HEAD\n * A callback fired when the element loses focus. Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n=======\n * A callback fired when the number field loses focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality)\n *\n * Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n */\n blur?: CallbackEventListener;\n /**\n<<<<<<< HEAD\n * Callback when the user has **finished editing** a field, for example, once they have blurred the field.\n=======\n * A callback fired when the number field value changes.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality)\n *\n * Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).\n */\n change?: CallbackEventListener;\n /**\n<<<<<<< HEAD\n * A callback fired when the element receives focus. Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n=======\n * A callback fired when the number field receives focus.\n>>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality)\n *\n * Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n */\n focus?: CallbackEventListener;\n /**\n * A callback fired when the user inputs data into the number field.\n *\n * Learn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).\n */\n input?: CallbackEventListener;\n}" + "value": "export interface NumberFieldElementEvents {\n /**\n * A callback fired when the number field loses focus.\n *\n * Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).\n */\n blur?: CallbackEventListener;\n /**\n * A callback fired when the number field value is committed on blur or after pressing Enter.\n * Also fired on each step when using the increment/decrement controls or the Up Arrow and Down Arrow keys.\n *\n * Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).\n */\n change?: CallbackEventListener;\n /**\n * A callback fired when the number field receives focus.\n *\n * Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).\n */\n focus?: CallbackEventListener;\n /**\n * A callback fired when the user inputs data into the number field.\n * Also fired on each step when using the increment/decrement controls or the Up Arrow and Down Arrow keys.\n *\n * Learn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event).\n */\n input?: CallbackEventListener;\n}" } }, "NumberFieldElementSlots": { diff --git a/packages/ui-extensions/src/surfaces/checkout/components/MoneyField.d.ts b/packages/ui-extensions/src/surfaces/checkout/components/MoneyField.d.ts index a0457a93de..8a17df8380 100644 --- a/packages/ui-extensions/src/surfaces/checkout/components/MoneyField.d.ts +++ b/packages/ui-extensions/src/surfaces/checkout/components/MoneyField.d.ts @@ -41,37 +41,27 @@ export interface MoneyFieldEvents extends Pick>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) * * Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event). */ blur?: CallbackEventListener; /** -<<<<<<< HEAD - * Callback when the user has **finished editing** a field, for example, once they have blurred the field. -======= - * A callback fired when the money field value changes. ->>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) + * A callback fired when the money field value is committed on blur or after pressing Enter. + * Also fired on each step when using the Up Arrow and Down Arrow keys. * * Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event). */ change?: CallbackEventListener; /** -<<<<<<< HEAD - * A callback fired when the element receives focus. Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event). -======= * A callback fired when the money field receives focus. ->>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) * * Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event). */ focus?: CallbackEventListener; /** * A callback fired when the user inputs data into the money field. + * Also fired on each step when using the Up Arrow and Down Arrow keys. * * Learn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event). */ diff --git a/packages/ui-extensions/src/surfaces/checkout/components/NumberField.d.ts b/packages/ui-extensions/src/surfaces/checkout/components/NumberField.d.ts index 519668b1c1..9f949ac160 100644 --- a/packages/ui-extensions/src/surfaces/checkout/components/NumberField.d.ts +++ b/packages/ui-extensions/src/surfaces/checkout/components/NumberField.d.ts @@ -88,37 +88,27 @@ export interface NumberFieldEvents extends Pick>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) * * Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event). */ blur?: CallbackEventListener; /** -<<<<<<< HEAD - * Callback when the user has **finished editing** a field, for example, once they have blurred the field. -======= - * A callback fired when the number field value changes. ->>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) + * A callback fired when the number field value is committed on blur or after pressing Enter. + * Also fired on each step when using the increment/decrement controls or the Up Arrow and Down Arrow keys. * * Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event). */ change?: CallbackEventListener; /** -<<<<<<< HEAD - * A callback fired when the element receives focus. Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event). -======= * A callback fired when the number field receives focus. ->>>>>>> eb0f07393 (Improve Forms component descriptions to match admin quality) * * Learn more about the [focus event](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event). */ focus?: CallbackEventListener; /** * A callback fired when the user inputs data into the number field. + * Also fired on each step when using the increment/decrement controls or the Up Arrow and Down Arrow keys. * * Learn more about the [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event). */