From 85299baed6fab1164647ff312c6a5ab4afe80fc7 Mon Sep 17 00:00:00 2001
From: Gabriel Garcia <ggarciaseco@gmail.com>
Date: Wed, 14 Oct 2026 05:43:17 +0200
Subject: [PATCH 1/2] chore(example): bump MYS contract_details schema version
 to 5

Pin Malaysia to contract_details v5 in the example app and document v3-v5
in the MYS schema changelog and the version matrix.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../eor/contract-details/countries/MYS.md     | 65 ++++++++++++++++++-
 .../eor/contract-details/countries/README.md  |  2 +-
 .../flows/Onboarding/jsonSchemaVersions.ts    |  2 +-
 3 files changed, 65 insertions(+), 4 deletions(-)

diff --git a/docs/schema-changes/eor/contract-details/countries/MYS.md b/docs/schema-changes/eor/contract-details/countries/MYS.md
index 7ecab871c..180396ff8 100644
--- a/docs/schema-changes/eor/contract-details/countries/MYS.md
+++ b/docs/schema-changes/eor/contract-details/countries/MYS.md
@@ -4,11 +4,72 @@ Schema versions for employee onboarding in Malaysia.
 
 ## Current Version
 
-**Contract Details:** v2 (Since SDK 1.23.0)
+**Contract Details:** v5
 
 ## Contract Details
 
-### v2 - Current (Since SDK 1.23.0, March 2026)
+### v5 - Current
+
+**What changed:**
+
+- The contract duration fields move to the shared `contract_duration` component with unlimited maximum duration. The standalone `contract_duration_type` and `contract_end_date` field definitions and the contract duration help center metadata are removed from the schema (inferred from the schema diff).
+
+**Migration:**
+
+```tsx
+<OnboardingFlow
+  options={
+    jsonSchemaVersionByCountry: {
+      MYS: { contract_details: 5 },
+    },
+  }
+/>
+```
+
+---
+
+### v4
+
+**What changed:**
+
+- Adds an extreme-salary acknowledgement: a warning and a required checkbox appear when the annual salary is at or above the USD 1,000,000 equivalent. Additive and flag-gated, so no action is required unless a submitted salary crosses that threshold.
+
+**Migration:**
+
+```tsx
+<OnboardingFlow
+  options={
+    jsonSchemaVersionByCountry: {
+      MYS: { contract_details: 4 },
+    },
+  }
+/>
+```
+
+---
+
+### v3
+
+**What changed:**
+
+- `annual_gross_salary` adds high-salary reserve messaging, grouped with the currency selection in a titled fieldset. Additive and flag-gated, so no action is required.
+- The form moves to the JSON Schema Form v1 engine. Validation and form generation follow v1 semantics.
+
+**Migration:**
+
+```tsx
+<OnboardingFlow
+  options={
+    jsonSchemaVersionByCountry: {
+      MYS: { contract_details: 3 },
+    },
+  }
+/>
+```
+
+---
+
+### v2 (Since SDK 1.23.0, March 2026)
 
 **What changed:**
 
diff --git a/docs/schema-changes/eor/contract-details/countries/README.md b/docs/schema-changes/eor/contract-details/countries/README.md
index f66255eb7..0870a1f8f 100644
--- a/docs/schema-changes/eor/contract-details/countries/README.md
+++ b/docs/schema-changes/eor/contract-details/countries/README.md
@@ -67,7 +67,7 @@ These countries have upgraded to different versions, check each guide to know ho
 | Kenya                | KEN  | v2               | March 2026     |
 | Lebanon              | LBN  | v2               | March 2026     |
 | Mauritius            | MUS  | v2               | March 2026     |
-| Malaysia             | MYS  | v2               | March 2026     |
+| Malaysia             | MYS  | v5               | October 2026   |
 | Mexico               | MEX  | v2               | March 2026     |
 | Netherlands          | NLD  | v6               | October 2026   |
 | Nigeria              | NGA  | v5               | October 2026   |
diff --git a/example/src/flows/Onboarding/jsonSchemaVersions.ts b/example/src/flows/Onboarding/jsonSchemaVersions.ts
index 2870a70ab..6791cd219 100644
--- a/example/src/flows/Onboarding/jsonSchemaVersions.ts
+++ b/example/src/flows/Onboarding/jsonSchemaVersions.ts
@@ -237,7 +237,7 @@ export const ONBOARDING_JSON_SCHEMA_VERSION_BY_COUNTRY = {
   },
   MYS: {
     // Malaysia
-    contract_details: 2,
+    contract_details: 5,
   },
   NGA: {
     // Nigeria

From 4641c153dcd34c58f2ae566cded433ea9e02be39 Mon Sep 17 00:00:00 2001
From: Gabriel Garcia <ggarciaseco@gmail.com>
Date: Wed, 14 Oct 2026 05:44:40 +0200
Subject: [PATCH 2/2] docs(mys): fix the single braces in the migration
 snippets

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../eor/contract-details/countries/MYS.md            | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/schema-changes/eor/contract-details/countries/MYS.md b/docs/schema-changes/eor/contract-details/countries/MYS.md
index 180396ff8..ea99ef746 100644
--- a/docs/schema-changes/eor/contract-details/countries/MYS.md
+++ b/docs/schema-changes/eor/contract-details/countries/MYS.md
@@ -18,11 +18,11 @@ Schema versions for employee onboarding in Malaysia.
 
 ```tsx
 <OnboardingFlow
-  options={
+  options={{
     jsonSchemaVersionByCountry: {
       MYS: { contract_details: 5 },
     },
-  }
+  }}
 />
 ```
 
@@ -38,11 +38,11 @@ Schema versions for employee onboarding in Malaysia.
 
 ```tsx
 <OnboardingFlow
-  options={
+  options={{
     jsonSchemaVersionByCountry: {
       MYS: { contract_details: 4 },
     },
-  }
+  }}
 />
 ```
 
@@ -59,11 +59,11 @@ Schema versions for employee onboarding in Malaysia.
 
 ```tsx
 <OnboardingFlow
-  options={
+  options={{
     jsonSchemaVersionByCountry: {
       MYS: { contract_details: 3 },
     },
-  }
+  }}
 />
 ```