@nuskin/shipping-address-form 1.7.1 → 1.7.2

package/README.md

@@ -9,7 +9,7 @@ The component:
 - loads a shipping form definition from Contentstack based on the logged-in country and form type
 - renders pre-address and post-address shipping fields in the order defined by content
 - loads localized strings once and passes the derived `formStrings` subset into `AddressLookup`
-- emits a single `onAction` callback for `save` and `cancel`
+- emits a single `onAction` callback for save, cancel, and AddressLookup service errors
 
 ## Installation
 
@@ -86,9 +86,9 @@ import {
 } from '@nuskin/shipping-address-form'
 ```
 
-`AddressLookup` accepts `onAddressSelect`, `country`, `language`, `address`, `entryMode`, `requireValidation`,
-`readOnlyView`, `showManualValidateButton`, `validationRequestId`, `strings`, `formDefinition`, and
-`deferFormLookup`. It supports Smarty autocomplete and validation for US and international
+`AddressLookup` accepts `onAddressSelect`, `country`, `language`, `address`, `readOnlyView`,
+`validationRequestId`, `strings`, `formDefinition`, and `deferFormLookup`. It supports Smarty
+autocomplete and validation for US and international
 addresses. `normalizeAddressForm`, `DEFAULT_ADDRESS_FORM`, and `SUPPORTED_COUNTRIES` are exported
 for consumers that need to provide or reuse address form definitions.
 
@@ -165,7 +165,7 @@ The incoming `address` object may also include `AddressLookup` verification meta
 ```js
 {
   verification: {
-    status: 'verified', // or 'autocomplete' | 'unverified'
+    status: 'verified', // or 'autocomplete' | 'partial' | 'unverified'
     source: 'smarty-us', // or 'smarty-intl'
     verifiedAt: '2026-05-01T15:01:07.905Z'
   }
@@ -219,31 +219,49 @@ Readonly mode is intended for displaying an existing address without allowing ed
 
 ### Address Entry and Validation
 
-`entryMode` controls which address entry experience is available when the component initializes:
+Address entry and validation behavior are configured in the address form definition:
 
-- `'both'` (default) starts with autocomplete and lets the user switch to manual entry.
-- `'manual'` starts with manual entry and hides the mode switch.
-- `'autocomplete'` starts with autocomplete and hides the mode switch.
+```js
+addressEntry: {
+  entryMode: 'both', // 'both' | 'autocomplete' | 'manual'
+  validationMode: 'required', // 'required' | 'optional' | 'disabled'
+  minimumAcceptedLevel: 'verified' // 'verified' | 'partial'
+}
+```
 
-`requireValidation` defaults to `true`. Set it to `false` when a market accepts manually entered
-addresses without validation. `showManualValidateButton` defaults to `true` for `ShippingAddressForm`
-and controls whether manual entry shows its Verify Address button. For example:
+`entryMode` defaults to `'both'`. `validationMode` defaults to `'required'`; `'optional'` allows
+users to validate without making verification a requirement, while `'disabled'` hides validation
+actions and does not call Smarty validation. The manual Verify Address button is shown whenever
+manual entry and validation are both enabled.
 
-```jsx
-<ShippingAddressForm
-  entryMode="manual"
-  requireValidation={false}
-  showManualValidateButton={false}
-/>
+`minimumAcceptedLevel` applies when validation is required. `'verified'` accepts only fully verified
+addresses. `'partial'` also accepts Smarty International partial-verification results. The returned
+`status.canProceed` is the primary signal for whether the selected address is complete and accepted
+under this configuration. The status also includes `validationMode`, `minimumAcceptedLevel`, and
+`meetsVerificationRequirement` for callers that need the underlying detail.
+
+Individual address elements can opt into limited exceptions after an accepted verification result:
+
+```js
+{
+  field: 'postalCode',
+  required: true,
+  allowMissingAfterVerification: true,
+  trustVerifiedFormat: true
+}
 ```
 
-For standalone `AddressLookup`, `showManualValidateButton` defaults to `false`.
+Both options default to `false`. `allowMissingAfterVerification` permits that required field to be
+absent only after accepted verification. `trustVerifiedFormat` applies to `postalCode` and accepts
+a verified API value that does not match the local postal-code regex. It also triggers verification
+after autocomplete when the returned postal code fails that regex. When either exception is used,
+the status includes `verificationExceptions` with the affected fields.
 
 ### `onAction`
 
 - Type: `(payload) => void`
 
-Single callback for form actions.
+Single callback for form actions and AddressLookup service errors.
 
 #### Cancel payload
 
@@ -256,7 +274,7 @@ Single callback for form actions.
 Only emitted after:
 
 - `AddressLookup` validation is triggered
-- `AddressLookup` reports `status.completeness === 'complete'`
+- `AddressLookup` reports `status.canProceed === true`
 - required shipping fields are complete
 - any `allowedCharacters` regex rules defined for shipping fields pass
 
@@ -279,6 +297,7 @@ Only emitted after:
   },
   validationStatus: {
     verification: 'verified',
+    canProceed: true,
     completeness: 'complete',
     missingFields: [],
     mode: 'manual',
@@ -291,6 +310,30 @@ Only emitted after:
 
 The exact shipping-field keys in `data` depend on the current form definition.
 
+#### AddressLookup error payload
+
+When Smarty autocomplete or validation is unavailable, the wrapper forwards the AddressLookup error payload:
+
+```js
+{
+  type: 'lookup-error', // or 'validation-error'
+  address: {
+    address1: '123 Main St'
+  },
+  status: {
+    verification: 'unverified',
+    needsValidation: true
+  },
+  error: {
+    kind: 'api', // or 'rate-limited'
+    source: 'autocomplete', // or 'validation'
+    message: 'We could not validate that address right now.'
+  }
+}
+```
+
+Consumers can use this event to apply their own fail-open or fail-closed policy when Smarty is unavailable.
+
 ## Form Definition
 
 Shipping form layout is loaded from Contentstack content type:
@@ -433,7 +476,7 @@ yarn dev
 The local test app supports entry configuration and readonly mode through query params:
 
 ```text
-?country=US&language=en&type=shipping&entryMode=manual&requireValidation=false&showManualValidateButton=false
+?country=US&language=en&type=shipping&readOnlyView=true
 ```
 
 Build the package:

package/dist/addressLookup/AddressLookup.js

@@ -15,10 +15,7 @@ const AddressLookup = ({
   onAddressSelect,
   country = 'US',
   address = null,
-  entryMode = 'both',
-  requireValidation = true,
   readOnlyView = false,
-  showManualValidateButton = false,
   validationRequestId = 0,
   language = 'en',
   strings = null,
@@ -31,10 +28,7 @@ const AddressLookup = ({
     children: isUS ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_SmartyUSResults.default, {
       onSelect: onAddressSelect,
       initialAddress: address,
-      entryMode: entryMode,
-      requireValidation: requireValidation,
       readOnlyView: readOnlyView,
-      showManualValidateButton: showManualValidateButton,
       validationRequestId: validationRequestId,
       language: language,
       strings: strings,
@@ -44,10 +38,7 @@ const AddressLookup = ({
       countryCode: country,
       onSelect: onAddressSelect,
       initialAddress: address,
-      entryMode: entryMode,
-      requireValidation: requireValidation,
       readOnlyView: readOnlyView,
-      showManualValidateButton: showManualValidateButton,
       validationRequestId: validationRequestId,
       language: language,
       strings: strings,
@@ -60,10 +51,7 @@ AddressLookup.propTypes = {
   onAddressSelect: _propTypes.default.func,
   country: _propTypes.default.string,
   address: _componentPropTypes.addressPropType,
-  entryMode: _propTypes.default.oneOf(['both', 'autocomplete', 'manual']),
-  requireValidation: _propTypes.default.bool,
   readOnlyView: _propTypes.default.bool,
-  showManualValidateButton: _propTypes.default.bool,
   validationRequestId: _propTypes.default.number,
   language: _propTypes.default.string,
   strings: _componentPropTypes.labelStringsPropType,

package/dist/addressLookup/AddressLookup.js.map

@@ -1 +1 @@
-{"version":3,"file":"AddressLookup.js","names":["_propTypes","_interopRequireDefault","require","_SmartyUSResults","_SmartyIntlResults","_componentPropTypes","_jsxRuntime","e","__esModule","default","AddressLookup","onAddressSelect","country","address","entryMode","requireValidation","readOnlyView","showManualValidateButton","validationRequestId","language","strings","formDefinition","deferFormLookup","isUS","jsx","className","children","onSelect","initialAddress","countryCode","propTypes","PropTypes","func","string","addressPropType","oneOf","bool","number","labelStringsPropType","formDefinitionPropType","_default","exports"],"sources":["../../src/addressLookup/AddressLookup.jsx"],"sourcesContent":["import PropTypes from 'prop-types';\nimport './styles/addressLookup.css';\nimport SmartyUSResults from './components/SmartyUSResults';\nimport SmartyIntlResults from './components/SmartyIntlResults';\nimport { addressPropType, formDefinitionPropType, labelStringsPropType } from './utils/componentPropTypes';\n\nconst AddressLookup = ({ \n  onAddressSelect, \n  country = 'US',\n  address = null,\n  entryMode = 'both',\n  requireValidation = true,\n  readOnlyView = false,\n  showManualValidateButton = false,\n  validationRequestId = 0,\n  language = 'en',\n  strings = null,\n  formDefinition = null,\n  deferFormLookup = false\n}) => {\n  const isUS = country === 'US';\n\n  return (\n    <div className='ns-address-lookup'>\n      {isUS ? (\n        <SmartyUSResults \n          onSelect={onAddressSelect}\n          initialAddress={address}\n          entryMode={entryMode}\n          requireValidation={requireValidation}\n          readOnlyView={readOnlyView}\n          showManualValidateButton={showManualValidateButton}\n          validationRequestId={validationRequestId}\n          language={language}\n          strings={strings}\n          formDefinition={formDefinition}\n          deferFormLookup={deferFormLookup}\n        />\n      ) : (\n        <SmartyIntlResults \n          countryCode={country}\n          onSelect={onAddressSelect}\n          initialAddress={address}\n          entryMode={entryMode}\n          requireValidation={requireValidation}\n          readOnlyView={readOnlyView}\n          showManualValidateButton={showManualValidateButton}\n          validationRequestId={validationRequestId}\n          language={language}\n          strings={strings}\n          formDefinition={formDefinition}\n          deferFormLookup={deferFormLookup}\n        />\n      )}\n    </div>\n  );\n};\n\nAddressLookup.propTypes = {\n  onAddressSelect: PropTypes.func,\n  country: PropTypes.string,\n  address: addressPropType,\n  entryMode: PropTypes.oneOf(['both', 'autocomplete', 'manual']),\n  requireValidation: PropTypes.bool,\n  readOnlyView: PropTypes.bool,\n  showManualValidateButton: PropTypes.bool,\n  validationRequestId: PropTypes.number,\n  language: PropTypes.string,\n  strings: labelStringsPropType,\n  formDefinition: formDefinitionPropType,\n  deferFormLookup: PropTypes.bool\n};\n\nexport default AddressLookup;\n"],"mappings":";;;;;;AAAA,IAAAA,UAAA,GAAAC,sBAAA,CAAAC,OAAA;AACAA,OAAA;AACA,IAAAC,gBAAA,GAAAF,sBAAA,CAAAC,OAAA;AACA,IAAAE,kBAAA,GAAAH,sBAAA,CAAAC,OAAA;AACA,IAAAG,mBAAA,GAAAH,OAAA;AAA2G,IAAAI,WAAA,GAAAJ,OAAA;AAAA,SAAAD,uBAAAM,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAE3G,MAAMG,aAAa,GAAGA,CAAC;EACrBC,eAAe;EACfC,OAAO,GAAG,IAAI;EACdC,OAAO,GAAG,IAAI;EACdC,SAAS,GAAG,MAAM;EAClBC,iBAAiB,GAAG,IAAI;EACxBC,YAAY,GAAG,KAAK;EACpBC,wBAAwB,GAAG,KAAK;EAChCC,mBAAmB,GAAG,CAAC;EACvBC,QAAQ,GAAG,IAAI;EACfC,OAAO,GAAG,IAAI;EACdC,cAAc,GAAG,IAAI;EACrBC,eAAe,GAAG;AACpB,CAAC,KAAK;EACJ,MAAMC,IAAI,GAAGX,OAAO,KAAK,IAAI;EAE7B,oBACE,IAAAN,WAAA,CAAAkB,GAAA;IAAKC,SAAS,EAAC,mBAAmB;IAAAC,QAAA,EAC/BH,IAAI,gBACH,IAAAjB,WAAA,CAAAkB,GAAA,EAACrB,gBAAA,CAAAM,OAAe;MACdkB,QAAQ,EAAEhB,eAAgB;MAC1BiB,cAAc,EAAEf,OAAQ;MACxBC,SAAS,EAAEA,SAAU;MACrBC,iBAAiB,EAAEA,iBAAkB;MACrCC,YAAY,EAAEA,YAAa;MAC3BC,wBAAwB,EAAEA,wBAAyB;MACnDC,mBAAmB,EAAEA,mBAAoB;MACzCC,QAAQ,EAAEA,QAAS;MACnBC,OAAO,EAAEA,OAAQ;MACjBC,cAAc,EAAEA,cAAe;MAC/BC,eAAe,EAAEA;IAAgB,CAClC,CAAC,gBAEF,IAAAhB,WAAA,CAAAkB,GAAA,EAACpB,kBAAA,CAAAK,OAAiB;MAChBoB,WAAW,EAAEjB,OAAQ;MACrBe,QAAQ,EAAEhB,eAAgB;MAC1BiB,cAAc,EAAEf,OAAQ;MACxBC,SAAS,EAAEA,SAAU;MACrBC,iBAAiB,EAAEA,iBAAkB;MACrCC,YAAY,EAAEA,YAAa;MAC3BC,wBAAwB,EAAEA,wBAAyB;MACnDC,mBAAmB,EAAEA,mBAAoB;MACzCC,QAAQ,EAAEA,QAAS;MACnBC,OAAO,EAAEA,OAAQ;MACjBC,cAAc,EAAEA,cAAe;MAC/BC,eAAe,EAAEA;IAAgB,CAClC;EACF,CACE,CAAC;AAEV,CAAC;AAEDZ,aAAa,CAACoB,SAAS,GAAG;EACxBnB,eAAe,EAAEoB,kBAAS,CAACC,IAAI;EAC/BpB,OAAO,EAAEmB,kBAAS,CAACE,MAAM;EACzBpB,OAAO,EAAEqB,mCAAe;EACxBpB,SAAS,EAAEiB,kBAAS,CAACI,KAAK,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;EAC9DpB,iBAAiB,EAAEgB,kBAAS,CAACK,IAAI;EACjCpB,YAAY,EAAEe,kBAAS,CAACK,IAAI;EAC5BnB,wBAAwB,EAAEc,kBAAS,CAACK,IAAI;EACxClB,mBAAmB,EAAEa,kBAAS,CAACM,MAAM;EACrClB,QAAQ,EAAEY,kBAAS,CAACE,MAAM;EAC1Bb,OAAO,EAAEkB,wCAAoB;EAC7BjB,cAAc,EAAEkB,0CAAsB;EACtCjB,eAAe,EAAES,kBAAS,CAACK;AAC7B,CAAC;AAAC,IAAAI,QAAA,GAAAC,OAAA,CAAAhC,OAAA,GAEaC,aAAa","ignoreList":[]}
+{"version":3,"file":"AddressLookup.js","names":["_propTypes","_interopRequireDefault","require","_SmartyUSResults","_SmartyIntlResults","_componentPropTypes","_jsxRuntime","e","__esModule","default","AddressLookup","onAddressSelect","country","address","readOnlyView","validationRequestId","language","strings","formDefinition","deferFormLookup","isUS","jsx","className","children","onSelect","initialAddress","countryCode","propTypes","PropTypes","func","string","addressPropType","bool","number","labelStringsPropType","formDefinitionPropType","_default","exports"],"sources":["../../src/addressLookup/AddressLookup.jsx"],"sourcesContent":["import PropTypes from 'prop-types';\nimport './styles/addressLookup.css';\nimport SmartyUSResults from './components/SmartyUSResults';\nimport SmartyIntlResults from './components/SmartyIntlResults';\nimport { addressPropType, formDefinitionPropType, labelStringsPropType } from './utils/componentPropTypes';\n\nconst AddressLookup = ({ \n  onAddressSelect, \n  country = 'US',\n  address = null,\n  readOnlyView = false,\n  validationRequestId = 0,\n  language = 'en',\n  strings = null,\n  formDefinition = null,\n  deferFormLookup = false\n}) => {\n  const isUS = country === 'US';\n\n  return (\n    <div className='ns-address-lookup'>\n      {isUS ? (\n        <SmartyUSResults \n          onSelect={onAddressSelect}\n          initialAddress={address}\n          readOnlyView={readOnlyView}\n          validationRequestId={validationRequestId}\n          language={language}\n          strings={strings}\n          formDefinition={formDefinition}\n          deferFormLookup={deferFormLookup}\n        />\n      ) : (\n        <SmartyIntlResults \n          countryCode={country}\n          onSelect={onAddressSelect}\n          initialAddress={address}\n          readOnlyView={readOnlyView}\n          validationRequestId={validationRequestId}\n          language={language}\n          strings={strings}\n          formDefinition={formDefinition}\n          deferFormLookup={deferFormLookup}\n        />\n      )}\n    </div>\n  );\n};\n\nAddressLookup.propTypes = {\n  onAddressSelect: PropTypes.func,\n  country: PropTypes.string,\n  address: addressPropType,\n  readOnlyView: PropTypes.bool,\n  validationRequestId: PropTypes.number,\n  language: PropTypes.string,\n  strings: labelStringsPropType,\n  formDefinition: formDefinitionPropType,\n  deferFormLookup: PropTypes.bool\n};\n\nexport default AddressLookup;\n"],"mappings":";;;;;;AAAA,IAAAA,UAAA,GAAAC,sBAAA,CAAAC,OAAA;AACAA,OAAA;AACA,IAAAC,gBAAA,GAAAF,sBAAA,CAAAC,OAAA;AACA,IAAAE,kBAAA,GAAAH,sBAAA,CAAAC,OAAA;AACA,IAAAG,mBAAA,GAAAH,OAAA;AAA2G,IAAAI,WAAA,GAAAJ,OAAA;AAAA,SAAAD,uBAAAM,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAE3G,MAAMG,aAAa,GAAGA,CAAC;EACrBC,eAAe;EACfC,OAAO,GAAG,IAAI;EACdC,OAAO,GAAG,IAAI;EACdC,YAAY,GAAG,KAAK;EACpBC,mBAAmB,GAAG,CAAC;EACvBC,QAAQ,GAAG,IAAI;EACfC,OAAO,GAAG,IAAI;EACdC,cAAc,GAAG,IAAI;EACrBC,eAAe,GAAG;AACpB,CAAC,KAAK;EACJ,MAAMC,IAAI,GAAGR,OAAO,KAAK,IAAI;EAE7B,oBACE,IAAAN,WAAA,CAAAe,GAAA;IAAKC,SAAS,EAAC,mBAAmB;IAAAC,QAAA,EAC/BH,IAAI,gBACH,IAAAd,WAAA,CAAAe,GAAA,EAAClB,gBAAA,CAAAM,OAAe;MACde,QAAQ,EAAEb,eAAgB;MAC1Bc,cAAc,EAAEZ,OAAQ;MACxBC,YAAY,EAAEA,YAAa;MAC3BC,mBAAmB,EAAEA,mBAAoB;MACzCC,QAAQ,EAAEA,QAAS;MACnBC,OAAO,EAAEA,OAAQ;MACjBC,cAAc,EAAEA,cAAe;MAC/BC,eAAe,EAAEA;IAAgB,CAClC,CAAC,gBAEF,IAAAb,WAAA,CAAAe,GAAA,EAACjB,kBAAA,CAAAK,OAAiB;MAChBiB,WAAW,EAAEd,OAAQ;MACrBY,QAAQ,EAAEb,eAAgB;MAC1Bc,cAAc,EAAEZ,OAAQ;MACxBC,YAAY,EAAEA,YAAa;MAC3BC,mBAAmB,EAAEA,mBAAoB;MACzCC,QAAQ,EAAEA,QAAS;MACnBC,OAAO,EAAEA,OAAQ;MACjBC,cAAc,EAAEA,cAAe;MAC/BC,eAAe,EAAEA;IAAgB,CAClC;EACF,CACE,CAAC;AAEV,CAAC;AAEDT,aAAa,CAACiB,SAAS,GAAG;EACxBhB,eAAe,EAAEiB,kBAAS,CAACC,IAAI;EAC/BjB,OAAO,EAAEgB,kBAAS,CAACE,MAAM;EACzBjB,OAAO,EAAEkB,mCAAe;EACxBjB,YAAY,EAAEc,kBAAS,CAACI,IAAI;EAC5BjB,mBAAmB,EAAEa,kBAAS,CAACK,MAAM;EACrCjB,QAAQ,EAAEY,kBAAS,CAACE,MAAM;EAC1Bb,OAAO,EAAEiB,wCAAoB;EAC7BhB,cAAc,EAAEiB,0CAAsB;EACtChB,eAAe,EAAES,kBAAS,CAACI;AAC7B,CAAC;AAAC,IAAAI,QAAA,GAAAC,OAAA,CAAA5B,OAAA,GAEaC,aAAa","ignoreList":[]}

package/dist/addressLookup/components/SmartyIntlResults.js

@@ -31,20 +31,20 @@ const stripGeocode = (address = {}) => {
   return nextAddress;
 };
 const FIELD_TEST_IDS = {
-  address1: 'qa-address-1',
-  address2: 'qa-address-2',
-  district: 'qa-address-district',
+  address1: 'qa-address1',
+  address2: 'qa-address2',
+  district: 'qa-address-county',
   region: 'qa-address-region',
   city: 'qa-address-city',
-  postalCode: 'qa-address-postal-code'
+  postalCode: 'qa-address-zip'
 };
 const FIELD_IDS = {
-  address1: 'address-line-1',
-  address2: 'address-line-2',
-  district: 'address-district',
+  address1: 'qa-address1',
+  address2: 'qa-address2',
+  district: 'qa-address-county',
   region: 'address-region',
   city: 'address-city',
-  postalCode: 'address-postal-code'
+  postalCode: 'qa-address-zip'
 };
 const getFieldTestId = field => FIELD_TEST_IDS[field] || `qa-address-${field}`;
 const getFieldId = field => FIELD_IDS[field] || `address-${field}`;
@@ -53,10 +53,7 @@ const SmartyIntlResults = ({
   countryCode,
   onSelect,
   initialAddress = null,
-  entryMode = 'both',
-  requireValidation = true,
   readOnlyView = false,
-  showManualValidateButton = false,
   validationRequestId = 0,
   language = 'en',
   strings = null,
@@ -64,7 +61,7 @@ const SmartyIntlResults = ({
   deferFormLookup = false
 }) => {
   var _formDefinition$addre;
-  const [mode, setMode] = (0, _react.useState)(entryMode === 'manual' ? 'manual' : 'autocomplete');
+  const [mode, setMode] = (0, _react.useState)('autocomplete');
   const [query, setQuery] = (0, _react.useState)('');
   const [selectedAddress, setSelectedAddress] = (0, _react.useState)(null);
   const [selectedIntlAddressId, setSelectedIntlAddressId] = (0, _react.useState)(null);
@@ -125,14 +122,18 @@ const SmartyIntlResults = ({
   } = (0, _useAddressForm.default)(countryCode, shouldLoadAddressForm);
   const providedAddressForm = formDefinition !== null && formDefinition !== void 0 && (_formDefinition$addre = formDefinition.addressElements) !== null && _formDefinition$addre !== void 0 && _formDefinition$addre.length ? formDefinition : null;
   const resolvedAddressForm = providedAddressForm || loadedAddressForm;
-  const allowValidation = requireValidation && !readOnlyView;
+  const entryMode = (resolvedAddressForm === null || resolvedAddressForm === void 0 ? void 0 : resolvedAddressForm.entryMode) || 'both';
+  const allowValidation = (resolvedAddressForm === null || resolvedAddressForm === void 0 ? void 0 : resolvedAddressForm.validationMode) !== 'disabled' && !readOnlyView;
   const lookupField = (resolvedAddressForm === null || resolvedAddressForm === void 0 ? void 0 : resolvedAddressForm.lookupField) || 'address1';
+  (0, _react.useEffect)(() => {
+    setMode(entryMode === 'manual' ? 'manual' : 'autocomplete');
+  }, [entryMode]);
   const requiredFields = (0, _addressStatus.getRequiredFieldsFromAddressForm)(resolvedAddressForm);
   const hasEmailField = ((resolvedAddressForm === null || resolvedAddressForm === void 0 ? void 0 : resolvedAddressForm.addressElements) || []).some(field => field.field === 'email');
   const hasMapCoordinates = (formData === null || formData === void 0 ? void 0 : formData.latitude) !== undefined && (formData === null || formData === void 0 ? void 0 : formData.longitude) !== undefined;
   const hasLookupValue = Boolean(String((formData === null || formData === void 0 ? void 0 : formData[lookupField]) || '').trim());
   const canAttemptMap = Boolean(!isAutocompleteMode && hasLookupValue || isAutocompleteMode && ['autocomplete', 'verified'].includes(verificationStatus) && hasLookupValue);
-  const showMapAction = !readOnlyView && (hasMapCoordinates || canAttemptMap);
+  const showMapAction = !readOnlyView && (hasMapCoordinates || allowValidation && canAttemptMap);
   const mapInfoLines = (mapAddressLines.length ? mapAddressLines : [formData.address1, formData.address2, formData.district, [formData.postalCode, formData.city].filter(Boolean).join(' '), formData.region]).filter(Boolean);
   const {
     mapContainerRef,
@@ -587,7 +588,7 @@ const SmartyIntlResults = ({
     }
   };
   const handleValidationSelect = validatedAddress => {
-    var _validatedAddress$met, _validatedAddress$met2, _validatedAddress$ana;
+    var _validatedAddress$met, _validatedAddress$met2;
     clearServiceErrors({
       lookup: false,
       validation: true,
@@ -616,7 +617,16 @@ const SmartyIntlResults = ({
       latitude: (_validatedAddress$met = validatedAddress.metadata) === null || _validatedAddress$met === void 0 ? void 0 : _validatedAddress$met.latitude,
       longitude: (_validatedAddress$met2 = validatedAddress.metadata) === null || _validatedAddress$met2 === void 0 ? void 0 : _validatedAddress$met2.longitude
     };
-    const currentVerificationStatus = ((_validatedAddress$ana = validatedAddress.analysis) === null || _validatedAddress$ana === void 0 ? void 0 : _validatedAddress$ana.verification_status) === 'Verified' ? 'verified' : 'unverified';
+    const currentVerificationStatus = (_validatedAddress$ana => {
+      switch ((_validatedAddress$ana = validatedAddress.analysis) === null || _validatedAddress$ana === void 0 ? void 0 : _validatedAddress$ana.verification_status) {
+        case 'Verified':
+          return 'verified';
+        case 'Partial':
+          return 'partial';
+        default:
+          return 'unverified';
+      }
+    })();
     const normalizedFormData = buildTrackedAddress(updatedFormData, currentVerificationStatus, 'smarty-intl');
     setShowValidationSuggestions(false);
     setValidationTriggerSource(null);
@@ -706,7 +716,7 @@ const SmartyIntlResults = ({
       setShowMapModal(true);
       return;
     }
-    if (!canAttemptMap || validationLoading) {
+    if (!allowValidation || !canAttemptMap || validationLoading) {
       return;
     }
     clearServiceErrors({
@@ -731,7 +741,7 @@ const SmartyIntlResults = ({
       children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_LocationPinIcon.default, {
         className: "ns-address-lookup__icon"
       })
-    }), !isAutocompleteMode && allowValidation && showManualValidateButton && /*#__PURE__*/(0, _jsxRuntime.jsx)(_foundationUiComponents.NsButton, {
+    }), !isAutocompleteMode && allowValidation && /*#__PURE__*/(0, _jsxRuntime.jsx)(_foundationUiComponents.NsButton, {
       type: "button",
       onClick: handleValidate,
       disabled: validationLoading || !String(formData[lookupField] || '').trim(),
@@ -1006,10 +1016,7 @@ SmartyIntlResults.propTypes = {
   countryCode: _propTypes.default.string.isRequired,
   onSelect: _propTypes.default.func,
   initialAddress: _componentPropTypes.addressPropType,
-  entryMode: _propTypes.default.oneOf(['both', 'autocomplete', 'manual']),
-  requireValidation: _propTypes.default.bool,
   readOnlyView: _propTypes.default.bool,
-  showManualValidateButton: _propTypes.default.bool,
   validationRequestId: _propTypes.default.number,
   language: _propTypes.default.string,
   strings: _componentPropTypes.labelStringsPropType,