Merge pull request #24 from s-group-dev/language

Add features for specifying the CMP language

Author: iiroj

README.md

@@ -88,7 +88,16 @@ The script tag that loads the Usercentrics Browser UI and API.
 ```tsx
 interface UsercentricsScriptProps
     extends React.DetailedHTMLProps<React.ScriptHTMLAttributes<HTMLScriptElement>, HTMLScriptElement> {
+    /**
+     * The language code the Usercentrics UI should load by default. If not set, it will be automatically selected.
+     *
+     * @example "fi"
+     * @see https://usercentrics.atlassian.net/wiki/spaces/SKB/pages/1183678648
+     */
+    language?: string
+
     settingsId: string
+
     /**
      * The specific version of Usercentrics UI to load instead of "latest", as a string value
      *
@@ -97,11 +106,13 @@ interface UsercentricsScriptProps
      * @see https://releases.usercentrics.com/en?category=browser+ui&role=cmpv1%3Bcmpv2%3B
      */
     uiVersion?: string
+
     /**
      * Whether to run Usercentrics in "production" or "preview" mode
      * @default "production"
      */
     version?: 'production' | 'preview'
+
     src?: never
 }
 
@@ -113,6 +124,9 @@ interface UsercentricsScriptProps
 
 /* Fixed UI version instead of latest */
 ;() => <UsercentricsScript settingsId="1234" uiVersion="3.24.0" />
+
+/* Fixed language code */
+;() => <UsercentricsScript settingsId="1234" language="fi" />
 ```
 
 #### `UsercentricsProvider`
@@ -454,3 +468,14 @@ A method to get array of all services from local storage
 const services = getServicesFromLocalStorage()
 const myService = services.find((service) => service.id === 'my-service-id')
 ```
+
+#### `updateLanguage`
+
+Programmatic way to set language for the CMP.
+The param `countryCode` is a two character country code, e.g. "en" = set language to English
+
+See also https://docs.usercentrics.com/#/cmp-v2-ui-api?id=updatelanguage
+
+```tsx
+updateLanguage('fi')
+```

jest-setup.ts

@@ -1,2 +1 @@
-// eslint-disable-next-line import/extensions
-import '@testing-library/jest-dom/extend-expect'
+import '@testing-library/jest-dom'