@visma-swno/gaia-chat-ui 4.1.0 → 4.2.0-beta.2

package/CHANGELOG.md

@@ -1,100 +1,100 @@
-# Changelog
-
-## [4.1.0](https://github.com/visma-swno/vsn-assistant/compare/web-component@v4.0.0...web-component@v4.1.0) (2026-01-23)
-
-
-### Features
-
-* **web-component:** support fullscreen layout up to any size ([#1643](https://github.com/visma-swno/vsn-assistant/issues/1643)) ([e8be725](https://github.com/visma-swno/vsn-assistant/commit/e8be725c288ef0262b316f4a8d4891c4516bb537)), closes [#1619](https://github.com/visma-swno/vsn-assistant/issues/1619)
-* **web-component:** update chat button labels and tooltips for clarity ([#1682](https://github.com/visma-swno/vsn-assistant/issues/1682)) ([4954481](https://github.com/visma-swno/vsn-assistant/commit/4954481edd93eb9f10689d97666149379da0263f))
-
-
-### Bug Fixes
-
-* upgrade set-cookie-parser to 2.7.2 to address CVE ([#1532](https://github.com/visma-swno/vsn-assistant/issues/1532)) ([abc2a91](https://github.com/visma-swno/vsn-assistant/commit/abc2a91f24c1ea4c9800f086616ad486eb7b7843)), closes [#1355](https://github.com/visma-swno/vsn-assistant/issues/1355)
-* **webcomponent:** prevent text break for any character in tables ([#1681](https://github.com/visma-swno/vsn-assistant/issues/1681)) ([26160fb](https://github.com/visma-swno/vsn-assistant/commit/26160fb70a0f72fe010e93f5b1af5d8dd8c3a300)), closes [#1668](https://github.com/visma-swno/vsn-assistant/issues/1668)
-
-## [4.0.0](https://github.com/visma-swno/vsn-assistant/compare/web-component@v3.0.0...web-component@v4.0.0) (2025-12-02)
-
-
-### Features
-
-* add Dutch and Finnish language support ([#1488](https://github.com/visma-swno/vsn-assistant/issues/1488)) ([1e2bf12](https://github.com/visma-swno/vsn-assistant/commit/1e2bf12b9fb544a248b1e666d2684efbceb9a93c))
-* add icon component ([#1209](https://github.com/visma-swno/vsn-assistant/issues/1209)) ([ec48ccd](https://github.com/visma-swno/vsn-assistant/commit/ec48ccd63c1737388168a40431b28d6dd7cd2931))
-* add popover/tooltip component for icon buttons ([#1169](https://github.com/visma-swno/vsn-assistant/issues/1169)) ([#1318](https://github.com/visma-swno/vsn-assistant/issues/1318)) ([9eeed50](https://github.com/visma-swno/vsn-assistant/commit/9eeed50f2b502f618dd0a11dcc244e6cc8cd486d))
-* implement Host Context API for context-aware conversations ([#1313](https://github.com/visma-swno/vsn-assistant/issues/1313)) ([3a7a973](https://github.com/visma-swno/vsn-assistant/commit/3a7a9733c4f6d6c21d1952c137a36e7f3ccc88f0))
-* **support:** web-component sends outbound support requests over HTTP ([#1435](https://github.com/visma-swno/vsn-assistant/issues/1435)) ([0f6c5a0](https://github.com/visma-swno/vsn-assistant/commit/0f6c5a0693f21bab2f312d3d987d7ce16eea763b))
-* **web-component:** support relative image sources ([#1487](https://github.com/visma-swno/vsn-assistant/issues/1487)) ([6ccc8f9](https://github.com/visma-swno/vsn-assistant/commit/6ccc8f91a1305c13422f1ffa7e444b5cb92ba7b7))
-
-
-### Bug Fixes
-
-* add white background ([#1207](https://github.com/visma-swno/vsn-assistant/issues/1207)) ([9fb01d4](https://github.com/visma-swno/vsn-assistant/commit/9fb01d4b0579f195915243ed5e39d0d726d43b65)), closes [#1202](https://github.com/visma-swno/vsn-assistant/issues/1202)
-* **deps:** bump js-yaml from 4.1.0 to 4.1.1 in /web-component ([#1408](https://github.com/visma-swno/vsn-assistant/issues/1408)) ([475aa18](https://github.com/visma-swno/vsn-assistant/commit/475aa1893ce03351785a1031cab3f4bf29fa1c53))
-* popover is hidden when slot element is disabled ([#1334](https://github.com/visma-swno/vsn-assistant/issues/1334)) ([fe78b8f](https://github.com/visma-swno/vsn-assistant/commit/fe78b8fc936b06db2b91d504ee4cb62c73963a46))
-* re-add supporthub methods so support both old and new gaia-chat ([#1438](https://github.com/visma-swno/vsn-assistant/issues/1438)) ([ae86b2d](https://github.com/visma-swno/vsn-assistant/commit/ae86b2d76bf05050e213f24c499130475c4c6a15))
-
-
-### Build System
-
-* **deps-dev:** bump happy-dom from 19.0.2 to 20.0.0 in /web-component in the npm_and_yarn group across 1 directory ([#1187](https://github.com/visma-swno/vsn-assistant/issues/1187)) ([1aab790](https://github.com/visma-swno/vsn-assistant/commit/1aab790aac45be55497fe29ddc82ca542e30ef69))
-
-## [3.0.0](https://github.com/visma-swno/vsn-assistant/compare/web-component@v2.1.3...web-component@v3.0.0) (2025-10-14)
-
-
-### ⚠ BREAKING CHANGES
-
-* The authentication system has been completely redesigned for better flexibility and security.
-* **deps-dev:** <a href="https://redirect.github.com/capricorn86/happy-dom/issues/1620">#1620</a> Release v18.0.0</li> <li>See full diff in <a href="https://github.com/capricorn86/happy-dom/compare/v18.0.1...v19.0.2">compare view</a></li> </ul> </details> <br />
-
-### Features
-
-* add on-demand callback for token refresh ([#1192](https://github.com/visma-swno/vsn-assistant/issues/1192)) ([e5d6918](https://github.com/visma-swno/vsn-assistant/commit/e5d6918a9dc3eacecb2a4df77e724b9a53805a85))
-
-
-### Bug Fixes
-
-* add fixed container sizes ([#1188](https://github.com/visma-swno/vsn-assistant/issues/1188)) ([b2b30c9](https://github.com/visma-swno/vsn-assistant/commit/b2b30c91da672beff532409436ab3037f53c66bc))
-
-
-### Build System
-
-* **deps-dev:** bump happy-dom from 18.0.1 to 19.0.2 in /web-component ([#1158](https://github.com/visma-swno/vsn-assistant/issues/1158)) ([8eb4203](https://github.com/visma-swno/vsn-assistant/commit/8eb420315bbf0f2daae0b121570aba374c5af7a5))
-
-## [2.1.3](https://github.com/visma-swno/vsn-assistant/compare/web-component@v2.1.2...web-component@v2.1.3) (2025-09-26)
-
-
-### Bug Fixes
-
-* support dynamic locale updates ([#1148](https://github.com/visma-swno/vsn-assistant/issues/1148)) ([d57b277](https://github.com/visma-swno/vsn-assistant/commit/d57b2773b66f31f8fe09b6e92a62aeb76842db64))
-
-## 2.1.2 (2025-09-25)
-
-
-### Features
-
-* add custom token expiry timer ([#1111](https://github.com/visma-swno/vsn-assistant/issues/1111)) ([f9e8a0c](https://github.com/visma-swno/vsn-assistant/commit/f9e8a0cfbcb67bbce6259582fe65f8478efe86ca))
-* chat sends optional partner id ([#1066](https://github.com/visma-swno/vsn-assistant/issues/1066)) ([6ffcbbb](https://github.com/visma-swno/vsn-assistant/commit/6ffcbbbcd39411269e2e1e5cb991922989e781fa))
-* make web component closeable ([#1069](https://github.com/visma-swno/vsn-assistant/issues/1069)) ([adbf47c](https://github.com/visma-swno/vsn-assistant/commit/adbf47cb91f70d1e67e33bd2a15df83b5c1ce965))
-* **wc:** complete overhaul of the web component ([#1006](https://github.com/visma-swno/vsn-assistant/issues/1006)) ([51bc5b4](https://github.com/visma-swno/vsn-assistant/commit/51bc5b4875c28eb18ee78d9a8bb5f167f45aa1ab))
-
-
-### Bug Fixes
-
-* add custom prompt for support feedback ([#1082](https://github.com/visma-swno/vsn-assistant/issues/1082)) ([d0098ae](https://github.com/visma-swno/vsn-assistant/commit/d0098aef43939455c3b0de9324c65ec696b0a4b2))
-* add fallback for operator image ([#1081](https://github.com/visma-swno/vsn-assistant/issues/1081)) ([a2fd4ee](https://github.com/visma-swno/vsn-assistant/commit/a2fd4ee8ad4af4872bda9678402f15ced4de930b))
-* add padding for macOS overlay scrollbars ([#1073](https://github.com/visma-swno/vsn-assistant/issues/1073)) ([7a837d9](https://github.com/visma-swno/vsn-assistant/commit/7a837d91c46c6a53b7a540c1f827292bffe87b85))
-* add support for swedish and danish ([#1113](https://github.com/visma-swno/vsn-assistant/issues/1113)) ([904ff26](https://github.com/visma-swno/vsn-assistant/commit/904ff26a553a3ac8c611268e6dd41e90a442fa39))
-* display error message when profile is incorrect ([#1108](https://github.com/visma-swno/vsn-assistant/issues/1108)) ([59c8008](https://github.com/visma-swno/vsn-assistant/commit/59c800804ad3aebb6ce3c8ebb21325cf7dc7d7a0))
-* move icons to icon-folder ([#1061](https://github.com/visma-swno/vsn-assistant/issues/1061)) ([e83abf2](https://github.com/visma-swno/vsn-assistant/commit/e83abf270f648b6a4a6d8e18ed7dc03a31b6c73d))
-* replace rem with px ([#1102](https://github.com/visma-swno/vsn-assistant/issues/1102)) ([5e08cb8](https://github.com/visma-swno/vsn-assistant/commit/5e08cb81df94edbdd026817d59849a1e98284e8a))
-* reset state on principal change ([#1060](https://github.com/visma-swno/vsn-assistant/issues/1060)) ([369f12a](https://github.com/visma-swno/vsn-assistant/commit/369f12a0f13308dfab5e414e8c146236a5ef7afe))
-* scope down error controller ([#1070](https://github.com/visma-swno/vsn-assistant/issues/1070)) ([8c51382](https://github.com/visma-swno/vsn-assistant/commit/8c51382fd0716b90fe7150a8ec53e7c6ced83928))
-* services dynamically change base url ([#1118](https://github.com/visma-swno/vsn-assistant/issues/1118)) ([bc0e59e](https://github.com/visma-swno/vsn-assistant/commit/bc0e59e401b598e4a0c4fd82c4376735b2eb985a))
-* set min height for message list ([#1086](https://github.com/visma-swno/vsn-assistant/issues/1086)) ([df9159a](https://github.com/visma-swno/vsn-assistant/commit/df9159a50d10b56da0df79b7094716d885ca924c))
-* sse parsing in Safari browser ([#1063](https://github.com/visma-swno/vsn-assistant/issues/1063)) ([9c5d33d](https://github.com/visma-swno/vsn-assistant/commit/9c5d33d61edf3ef86775df3985ff95adcbc20de6))
-
-
-### Reverts
-
-* style: add inline padding for scrollbar in Safari ([#1080](https://github.com/visma-swno/vsn-assistant/issues/1080)) ([b4fa513](https://github.com/visma-swno/vsn-assistant/commit/b4fa51393e66e1fbd2cc2d2beebcf5eecc5ae773))
+# Changelog
+
+## [4.1.0](https://github.com/visma-swno/vsn-assistant/compare/web-component@v4.0.0...web-component@v4.1.0) (2026-01-23)
+
+
+### Features
+
+* **web-component:** support fullscreen layout up to any size ([#1643](https://github.com/visma-swno/vsn-assistant/issues/1643)) ([e8be725](https://github.com/visma-swno/vsn-assistant/commit/e8be725c288ef0262b316f4a8d4891c4516bb537)), closes [#1619](https://github.com/visma-swno/vsn-assistant/issues/1619)
+* **web-component:** update chat button labels and tooltips for clarity ([#1682](https://github.com/visma-swno/vsn-assistant/issues/1682)) ([4954481](https://github.com/visma-swno/vsn-assistant/commit/4954481edd93eb9f10689d97666149379da0263f))
+
+
+### Bug Fixes
+
+* upgrade set-cookie-parser to 2.7.2 to address CVE ([#1532](https://github.com/visma-swno/vsn-assistant/issues/1532)) ([abc2a91](https://github.com/visma-swno/vsn-assistant/commit/abc2a91f24c1ea4c9800f086616ad486eb7b7843)), closes [#1355](https://github.com/visma-swno/vsn-assistant/issues/1355)
+* **webcomponent:** prevent text break for any character in tables ([#1681](https://github.com/visma-swno/vsn-assistant/issues/1681)) ([26160fb](https://github.com/visma-swno/vsn-assistant/commit/26160fb70a0f72fe010e93f5b1af5d8dd8c3a300)), closes [#1668](https://github.com/visma-swno/vsn-assistant/issues/1668)
+
+## [4.0.0](https://github.com/visma-swno/vsn-assistant/compare/web-component@v3.0.0...web-component@v4.0.0) (2025-12-02)
+
+
+### Features
+
+* add Dutch and Finnish language support ([#1488](https://github.com/visma-swno/vsn-assistant/issues/1488)) ([1e2bf12](https://github.com/visma-swno/vsn-assistant/commit/1e2bf12b9fb544a248b1e666d2684efbceb9a93c))
+* add icon component ([#1209](https://github.com/visma-swno/vsn-assistant/issues/1209)) ([ec48ccd](https://github.com/visma-swno/vsn-assistant/commit/ec48ccd63c1737388168a40431b28d6dd7cd2931))
+* add popover/tooltip component for icon buttons ([#1169](https://github.com/visma-swno/vsn-assistant/issues/1169)) ([#1318](https://github.com/visma-swno/vsn-assistant/issues/1318)) ([9eeed50](https://github.com/visma-swno/vsn-assistant/commit/9eeed50f2b502f618dd0a11dcc244e6cc8cd486d))
+* implement Host Context API for context-aware conversations ([#1313](https://github.com/visma-swno/vsn-assistant/issues/1313)) ([3a7a973](https://github.com/visma-swno/vsn-assistant/commit/3a7a9733c4f6d6c21d1952c137a36e7f3ccc88f0))
+* **support:** web-component sends outbound support requests over HTTP ([#1435](https://github.com/visma-swno/vsn-assistant/issues/1435)) ([0f6c5a0](https://github.com/visma-swno/vsn-assistant/commit/0f6c5a0693f21bab2f312d3d987d7ce16eea763b))
+* **web-component:** support relative image sources ([#1487](https://github.com/visma-swno/vsn-assistant/issues/1487)) ([6ccc8f9](https://github.com/visma-swno/vsn-assistant/commit/6ccc8f91a1305c13422f1ffa7e444b5cb92ba7b7))
+
+
+### Bug Fixes
+
+* add white background ([#1207](https://github.com/visma-swno/vsn-assistant/issues/1207)) ([9fb01d4](https://github.com/visma-swno/vsn-assistant/commit/9fb01d4b0579f195915243ed5e39d0d726d43b65)), closes [#1202](https://github.com/visma-swno/vsn-assistant/issues/1202)
+* **deps:** bump js-yaml from 4.1.0 to 4.1.1 in /web-component ([#1408](https://github.com/visma-swno/vsn-assistant/issues/1408)) ([475aa18](https://github.com/visma-swno/vsn-assistant/commit/475aa1893ce03351785a1031cab3f4bf29fa1c53))
+* popover is hidden when slot element is disabled ([#1334](https://github.com/visma-swno/vsn-assistant/issues/1334)) ([fe78b8f](https://github.com/visma-swno/vsn-assistant/commit/fe78b8fc936b06db2b91d504ee4cb62c73963a46))
+* re-add supporthub methods so support both old and new gaia-chat ([#1438](https://github.com/visma-swno/vsn-assistant/issues/1438)) ([ae86b2d](https://github.com/visma-swno/vsn-assistant/commit/ae86b2d76bf05050e213f24c499130475c4c6a15))
+
+
+### Build System
+
+* **deps-dev:** bump happy-dom from 19.0.2 to 20.0.0 in /web-component in the npm_and_yarn group across 1 directory ([#1187](https://github.com/visma-swno/vsn-assistant/issues/1187)) ([1aab790](https://github.com/visma-swno/vsn-assistant/commit/1aab790aac45be55497fe29ddc82ca542e30ef69))
+
+## [3.0.0](https://github.com/visma-swno/vsn-assistant/compare/web-component@v2.1.3...web-component@v3.0.0) (2025-10-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* The authentication system has been completely redesigned for better flexibility and security.
+* **deps-dev:** <a href="https://redirect.github.com/capricorn86/happy-dom/issues/1620">#1620</a> Release v18.0.0</li> <li>See full diff in <a href="https://github.com/capricorn86/happy-dom/compare/v18.0.1...v19.0.2">compare view</a></li> </ul> </details> <br />
+
+### Features
+
+* add on-demand callback for token refresh ([#1192](https://github.com/visma-swno/vsn-assistant/issues/1192)) ([e5d6918](https://github.com/visma-swno/vsn-assistant/commit/e5d6918a9dc3eacecb2a4df77e724b9a53805a85))
+
+
+### Bug Fixes
+
+* add fixed container sizes ([#1188](https://github.com/visma-swno/vsn-assistant/issues/1188)) ([b2b30c9](https://github.com/visma-swno/vsn-assistant/commit/b2b30c91da672beff532409436ab3037f53c66bc))
+
+
+### Build System
+
+* **deps-dev:** bump happy-dom from 18.0.1 to 19.0.2 in /web-component ([#1158](https://github.com/visma-swno/vsn-assistant/issues/1158)) ([8eb4203](https://github.com/visma-swno/vsn-assistant/commit/8eb420315bbf0f2daae0b121570aba374c5af7a5))
+
+## [2.1.3](https://github.com/visma-swno/vsn-assistant/compare/web-component@v2.1.2...web-component@v2.1.3) (2025-09-26)
+
+
+### Bug Fixes
+
+* support dynamic locale updates ([#1148](https://github.com/visma-swno/vsn-assistant/issues/1148)) ([d57b277](https://github.com/visma-swno/vsn-assistant/commit/d57b2773b66f31f8fe09b6e92a62aeb76842db64))
+
+## 2.1.2 (2025-09-25)
+
+
+### Features
+
+* add custom token expiry timer ([#1111](https://github.com/visma-swno/vsn-assistant/issues/1111)) ([f9e8a0c](https://github.com/visma-swno/vsn-assistant/commit/f9e8a0cfbcb67bbce6259582fe65f8478efe86ca))
+* chat sends optional partner id ([#1066](https://github.com/visma-swno/vsn-assistant/issues/1066)) ([6ffcbbb](https://github.com/visma-swno/vsn-assistant/commit/6ffcbbbcd39411269e2e1e5cb991922989e781fa))
+* make web component closeable ([#1069](https://github.com/visma-swno/vsn-assistant/issues/1069)) ([adbf47c](https://github.com/visma-swno/vsn-assistant/commit/adbf47cb91f70d1e67e33bd2a15df83b5c1ce965))
+* **wc:** complete overhaul of the web component ([#1006](https://github.com/visma-swno/vsn-assistant/issues/1006)) ([51bc5b4](https://github.com/visma-swno/vsn-assistant/commit/51bc5b4875c28eb18ee78d9a8bb5f167f45aa1ab))
+
+
+### Bug Fixes
+
+* add custom prompt for support feedback ([#1082](https://github.com/visma-swno/vsn-assistant/issues/1082)) ([d0098ae](https://github.com/visma-swno/vsn-assistant/commit/d0098aef43939455c3b0de9324c65ec696b0a4b2))
+* add fallback for operator image ([#1081](https://github.com/visma-swno/vsn-assistant/issues/1081)) ([a2fd4ee](https://github.com/visma-swno/vsn-assistant/commit/a2fd4ee8ad4af4872bda9678402f15ced4de930b))
+* add padding for macOS overlay scrollbars ([#1073](https://github.com/visma-swno/vsn-assistant/issues/1073)) ([7a837d9](https://github.com/visma-swno/vsn-assistant/commit/7a837d91c46c6a53b7a540c1f827292bffe87b85))
+* add support for swedish and danish ([#1113](https://github.com/visma-swno/vsn-assistant/issues/1113)) ([904ff26](https://github.com/visma-swno/vsn-assistant/commit/904ff26a553a3ac8c611268e6dd41e90a442fa39))
+* display error message when profile is incorrect ([#1108](https://github.com/visma-swno/vsn-assistant/issues/1108)) ([59c8008](https://github.com/visma-swno/vsn-assistant/commit/59c800804ad3aebb6ce3c8ebb21325cf7dc7d7a0))
+* move icons to icon-folder ([#1061](https://github.com/visma-swno/vsn-assistant/issues/1061)) ([e83abf2](https://github.com/visma-swno/vsn-assistant/commit/e83abf270f648b6a4a6d8e18ed7dc03a31b6c73d))
+* replace rem with px ([#1102](https://github.com/visma-swno/vsn-assistant/issues/1102)) ([5e08cb8](https://github.com/visma-swno/vsn-assistant/commit/5e08cb81df94edbdd026817d59849a1e98284e8a))
+* reset state on principal change ([#1060](https://github.com/visma-swno/vsn-assistant/issues/1060)) ([369f12a](https://github.com/visma-swno/vsn-assistant/commit/369f12a0f13308dfab5e414e8c146236a5ef7afe))
+* scope down error controller ([#1070](https://github.com/visma-swno/vsn-assistant/issues/1070)) ([8c51382](https://github.com/visma-swno/vsn-assistant/commit/8c51382fd0716b90fe7150a8ec53e7c6ced83928))
+* services dynamically change base url ([#1118](https://github.com/visma-swno/vsn-assistant/issues/1118)) ([bc0e59e](https://github.com/visma-swno/vsn-assistant/commit/bc0e59e401b598e4a0c4fd82c4376735b2eb985a))
+* set min height for message list ([#1086](https://github.com/visma-swno/vsn-assistant/issues/1086)) ([df9159a](https://github.com/visma-swno/vsn-assistant/commit/df9159a50d10b56da0df79b7094716d885ca924c))
+* sse parsing in Safari browser ([#1063](https://github.com/visma-swno/vsn-assistant/issues/1063)) ([9c5d33d](https://github.com/visma-swno/vsn-assistant/commit/9c5d33d61edf3ef86775df3985ff95adcbc20de6))
+
+
+### Reverts
+
+* style: add inline padding for scrollbar in Safari ([#1080](https://github.com/visma-swno/vsn-assistant/issues/1080)) ([b4fa513](https://github.com/visma-swno/vsn-assistant/commit/b4fa51393e66e1fbd2cc2d2beebcf5eecc5ae773))

package/README.md

@@ -1,55 +1,239 @@
-# @visma-swno/gaia-chat-ui
-
-Web component library for the GAiA Assistant Chat UI, built with Lit for Visma Software Nordic products.
-
-## Installation
-
-```bash
-npm install @visma-swno/gaia-chat-ui
-```
-
-**Note:** This package requires `lit` as a peer dependency:
-
-```bash
-npm install lit@^3.3.0
-```
-
-## Usage
-
-```javascript
-import '@visma-swno/gaia-chat-ui';
-```
-
-```html
-<gaia-chat
-  profile-id="YOUR_PROFILE_ID"
-  base-url="https://api.assistant.vsn.dev"
-  auth-strategy="visitor"
->
-</gaia-chat>
-```
-
-For authenticated Visma users, switch to the Visma strategy and provide a token provider. Implement caching and refresh: reuse a valid token until shortly before its `exp` claim, then silently refresh.
-
-```html
-<gaia-chat
-  id="assistant"
-  profile-id="YOUR_PROFILE_ID"
-  base-url="https://api.assistant.vsn.dev"
-  auth-strategy="visma"
->
-</gaia-chat>
-<script type="module">
-  const assistant = document.getElementById('assistant');
-
-  assistant.tokenProvider = async () => {
-    const res = await fetch('/api/auth/assistant-token');
-    const { token } = await res.json();
-    return token;
-  };
-</script>
-```
-
-## Documentation
-
-For detailed documentation and development instructions, see the [main repository](https://github.com/visma-swno/vsn-assistant).
+# @visma-swno/gaia-chat-ui
+
+Web component library for the GAiA Assistant Chat UI, built with [Lit](https://lit.dev/) for Visma Software Nordic products.
+
+## Installation
+
+```bash
+npm install @visma-swno/gaia-chat-ui
+```
+
+`lit` is an external dependency and must be available in your bundle:
+
+```bash
+npm install lit@^3.3.0
+```
+
+## Quick Start
+
+```javascript
+import '@visma-swno/gaia-chat-ui';
+```
+
+### Visitor Mode (Anonymous)
+
+```html
+<gaia-chat
+  profile-id="YOUR_PROFILE_ID"
+  base-url="https://api.assistant.vsn.dev"
+  auth-strategy="visitor"
+></gaia-chat>
+```
+
+### Visma Connect Mode (Authenticated)
+
+Provide a `tokenProvider` that returns a valid OAuth access token. Implement caching and refresh: reuse a valid token until shortly before its `exp` claim, then silently refresh.
+
+```html
+<gaia-chat
+  id="assistant"
+  profile-id="YOUR_PROFILE_ID"
+  base-url="https://api.assistant.vsn.dev"
+  auth-strategy="visma"
+></gaia-chat>
+
+<script type="module">
+  const assistant = document.getElementById('assistant');
+
+  assistant.tokenProvider = async () => {
+    const res = await fetch('/api/auth/assistant-token');
+    const { token } = await res.json();
+    return token;
+  };
+</script>
+```
+
+## Properties
+
+| Property / Attribute    | Type                    | Default                                    | Description                                                  |
+| ----------------------- | ----------------------- | ------------------------------------------ | ------------------------------------------------------------ |
+| `base-url`              | `string`                | `'https://api.assistant.stag.vsn.dev'`     | Backend API base URL.                                        |
+| `profile-id`            | `string`                | `'default'`                                | Assistant profile identifier.                                |
+| `auth-strategy`         | `'visitor' \| 'visma'`  | `'visitor'`                                | Authentication strategy.                                     |
+| `closeable`             | `boolean`               | `true`                                     | Show a close button in the header.                           |
+| `selected-model`        | `string`                | `''`                                       | Override the default AI model. Must be in the profile's allowed overrides. |
+| `enable-charts`         | `boolean`               | `false`                                    | Enable inline chart rendering via the built-in echarts tool. |
+| `tokenProvider`         | `() => Promise<string>` | —                                          | Async function returning an OAuth access token (Visma mode). Set via JS. |
+| `hostContextProvider`   | `HostContextProvider`   | —                                          | Async function returning application context per message. Set via JS.    |
+| `tools`                 | `FrontendTool[]`        | `[]`                                       | Frontend tool definitions sent to the agent. Set via JS.     |
+
+## Events
+
+All events bubble and are composed (cross shadow DOM).
+
+| Event                  | Detail Type                                                                                      | Description                             |
+| ---------------------- | ------------------------------------------------------------------------------------------------ | --------------------------------------- |
+| `conversation-cleared` | `void`                                                                                           | User cleared the conversation.          |
+| `message-sent`         | `{ message: string; channel: 'assistant' \| 'support' }`                                        | User sent a message.                    |
+| `tool-call-approved`   | `{ messageId: string }`                                                                          | User approved a tool call.              |
+| `tool-call-declined`   | `{ messageId: string }`                                                                          | User declined a tool call.              |
+| `feedback-submitted`   | `{ rating: number; comment: string \| null }`                                                    | User submitted feedback.                |
+| `close-requested`      | `void`                                                                                           | User clicked the close button.          |
+| `tool-call`            | `{ toolCallId: string; toolCallName: string; arguments: Record<string, unknown> \| string \| null; result: unknown }` | A frontend tool call was executed.      |
+
+```javascript
+document.querySelector('gaia-chat').addEventListener('message-sent', (e) => {
+  console.log('User sent:', e.detail.message);
+});
+```
+
+## Methods
+
+| Method               | Description                                       |
+| -------------------- | ------------------------------------------------- |
+| `clearConversation()`| Clear the current conversation and reset the chat.|
+| `stopSupport()`      | Stop any active support session.                  |
+
+## Host Context Provider
+
+Provide dynamic application context with each message. The agent and its plugins can use this context for personalized responses.
+
+```javascript
+const chat = document.querySelector('gaia-chat');
+
+chat.hostContextProvider = async () => ({
+  customerId: getCurrentCustomerId(),
+  companyId: getCurrentCompanyId(),
+  partnerId: getPartnerId(),
+  data: {
+    environment: 'production',
+    userRole: getUserRole(),
+  },
+});
+```
+
+### HostContext
+
+```typescript
+interface HostContext {
+  customerId?: string;
+  companyId?: string;
+  partnerId?: string;
+  data?: Record<string, unknown>;
+}
+
+type HostContextProvider = () => HostContext | Promise<HostContext | null> | null;
+```
+
+## Frontend Tools
+
+Register custom tools that the agent can invoke. Tool results are returned to the agent and a `tool-call` event is dispatched to the host.
+
+```javascript
+const chat = document.querySelector('gaia-chat');
+
+chat.tools = [
+  {
+    name: 'getInvoice',
+    description: 'Retrieve an invoice by ID',
+    parameters: {
+      type: 'object',
+      properties: {
+        invoiceId: { type: 'string', description: 'The invoice ID' },
+      },
+      required: ['invoiceId'],
+    },
+  },
+];
+
+chat.addEventListener('tool-call', (e) => {
+  const { toolCallName, arguments: args } = e.detail;
+  // Handle the tool call and return data to the agent
+});
+```
+
+### FrontendTool
+
+```typescript
+interface FrontendTool {
+  name: string;
+  description: string;
+  parameters: JSONSchema7; // JSON Schema draft-07, must be type: 'object'
+}
+```
+
+## Charts
+
+Set `enable-charts` to enable the built-in echarts frontend tool. When enabled, the agent can render inline charts using [Apache ECharts](https://echarts.apache.org/).
+
+```html
+<gaia-chat enable-charts></gaia-chat>
+```
+
+## Icon Registry
+
+Register custom SVG icons for use in the component:
+
+```javascript
+import { registerIcons } from '@visma-swno/gaia-chat-ui';
+
+registerIcons({ 'my-icon': '<svg>...</svg>' });
+```
+
+## Styling
+
+The component exposes CSS custom properties prefixed with `--gaia-` for theming. Set these on the `<gaia-chat>` element or any ancestor.
+
+### Typography
+
+| Property                         | Description        |
+| -------------------------------- | ------------------ |
+| `--gaia-font-family`             | Font family        |
+| `--gaia-font-size-xs` … `3xl`   | Font sizes         |
+| `--gaia-line-height-xs` … `3xl` | Line heights       |
+| `--gaia-font-weight-regular`     | Regular weight     |
+| `--gaia-font-weight-medium`      | Medium weight      |
+| `--gaia-font-weight-semibold`    | Semibold weight    |
+| `--gaia-font-weight-bold`        | Bold weight        |
+
+### Colors
+
+| Property group                  | Examples                                                     |
+| ------------------------------- | ------------------------------------------------------------ |
+| `--gaia-color-surface-*`        | `page`, `primary`, `action`, `action-hover`, `error`, `success`, `information`, `warning`, `disabled`, `selected` |
+| `--gaia-color-text-*`           | `headings`, `body`, `body-secondary`, `action`, `action-hover`, `disabled`, `error`, `success`, `link-visited`    |
+| `--gaia-color-border-*`         | `primary`, `secondary`, `tertiary`, `action`, `action-hover`, `focus`, `error`, `success`                         |
+| `--gaia-color-icon-*`           | `primary`, `action`, `action-hover`, `disabled`, `error`, `success`, `on-action`, `on-primary`                    |
+| `--gaia-color-message-*`        | `user`, `system`, `operator`                                 |
+| `--gaia-color-neutral-*`        | `10` through `100`                                           |
+
+### Example
+
+```css
+gaia-chat {
+  --gaia-font-family: 'Inter', sans-serif;
+  --gaia-color-surface-page: #ffffff;
+  --gaia-color-surface-action: #0066cc;
+  --gaia-color-text-body: #1a1a1a;
+  --gaia-color-message-user: #e6f0ff;
+}
+```
+
+## Localization
+
+The component reads the `lang` attribute (on itself or `<html>`) and responds to changes at runtime. Supported locales are bundled with the component.
+
+```html
+<gaia-chat lang="nb"></gaia-chat>
+```
+
+## Exports
+
+```typescript
+import { ChatApp, ToolCallEvent, registerIcons } from '@visma-swno/gaia-chat-ui';
+import type { FrontendTool, HostContext, HostContextProvider } from '@visma-swno/gaia-chat-ui';
+```
+
+## Documentation
+
+For development instructions and architecture details, see the [main repository](https://github.com/visma-swno/vsn-assistant).

package/dist/app/app.d.ts

@@ -1,37 +1,73 @@
 import { PropertyValues } from 'lit';
-import { TokenProvider } from '../auth/types';
-import { HostContextProvider } from '../core/types/host-context';
-import { StrategyType } from '../auth/strategy-factory';
+import { StrategyType } from '../core/store';
+import { TokenFetcher } from '../services/auth-service';
+import { FrontendTool, HostContextProvider } from '../types';
 import { BaseElement } from '../components/shared/base-element';
+/**
+ * Root chat widget component.
+ *
+ * Bootstraps services, manages authentication, and renders the chat UI.
+ * Embed in any page to add AI-powered chat with support handoff.
+ *
+ * @element gaia-chat
+ *
+ * @fires {ConversationClearedEvent} conversation-cleared - When the user clears the conversation
+ * @fires {MessageSentEvent} message-sent - When the user sends a message
+ * @fires {ToolCallApprovedEvent} tool-call-approved - When the user approves a tool call
+ * @fires {ToolCallDeclinedEvent} tool-call-declined - When the user declines a tool call
+ * @fires {FeedbackSubmittedEvent} feedback-submitted - When the user submits feedback
+ * @fires {CloseRequestedEvent} close-requested - When the user clicks the close button
+ * @fires {ToolCallEvent} tool-call - When a frontend tool call is executed
+ *
+ * @example
+ * ```html
+ * <gaia-chat
+ *   base-url="https://api.assistant.stag.vsn.dev"
+ *   profile-id="default"
+ *   auth-strategy="visitor"
+ * ></gaia-chat>
+ * ```
+ */
 export declare class ChatApp extends BaseElement {
     static styles: import('lit').CSSResult[];
+    /** Backend API base URL. */
     baseUrl: string;
+    /** Assistant profile identifier. */
     profileId: string;
     /**
-     * @deprecated Use hostContextProvider instead
+     * Partner ID for support handoff.
+     * @deprecated Use hostContextProvider instead.
      */
     supportPartnerId?: string;
-    tokenProvider?: TokenProvider;
+    /** Async function that returns an OAuth access token for Visma Connect auth. */
+    tokenProvider?: TokenFetcher;
+    /** Async function that returns application context sent with each message. */
     hostContextProvider?: HostContextProvider;
+    /** Authentication strategy: "visitor" (anonymous) or "visma" (Visma Connect). */
     authStrategy: StrategyType;
+    /** Whether to show a close button in the header. */
     closeable: boolean;
+    /** Override the default AI model. Must be in the profile's allowed overrides list. */
+    selectedModel: string;
+    /** Frontend tool definitions sent to the agent. */
+    tools: FrontendTool[];
+    /** Enable inline chart rendering for the echarts frontend tool. */
+    enableCharts: boolean;
+    private get activeLang();
     private langObserver?;
     private store;
-    private bootstrapEffect;
-    private streamEffect;
-    private supportEffect;
-    private conversationEffect;
-    private feedbackEffect;
-    private state;
-    private isConnectedToSupport;
-    private unsubscribe?;
-    private strategyFactory;
-    private authProvider;
+    private storeState;
+    private unsubscribeStore?;
     private apiClient;
     connectedCallback(): void;
     disconnectedCallback(): void;
     private handleAuthChanged;
     willUpdate(changedProperties: PropertyValues): void;
+    private applySelectedModel;
+    /** Clears the current conversation and resets the chat. */
+    clearConversation(): void;
+    /** Stops any active support session. */
+    stopSupport(): void;
     render(): import('lit-html').TemplateResult<1>;
 }
 declare global {