@filigran/chatbot 3.22.0 → 3.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,42 @@
1
+ # Design-system library feedback (@filigran/chatbot)
2
+
3
+ Gaps met while moving the chat panel onto `@filigran/design-system` 1.5.0
4
+ (filigran-ui#521, chatbot 3.23.0, UX round 1 B4 and B6). Each entry names the
5
+ DS component, what the panel needs that it cannot do today, the local
6
+ stand-in kept in the package, and the change that would let the stand-in go.
7
+ Every stand-in is a documented exemption of the audit table of filigran-ui#521.
8
+
9
+ ## 1. `Combobox`: a header trigger and footer actions (agent switcher)
10
+
11
+ - **Where:** `src/components/ChatHeader.tsx`, `data-ds-exempt="agent-switcher-combobox-trigger"`
12
+ and `"agent-listbox-option"`.
13
+ - **Need:** the agent switcher opens from the panel title itself (agent icon,
14
+ agent name as the header title, chevron), not from a text field; its list
15
+ shows each agent's avatar and badge, and ends with footer actions
16
+ ("Open agent page", the history actions) that are not options.
17
+ - **What `Combobox` 1.5.0 does:** the trigger is the input field (typing in
18
+ the field filters a grouped list); no slot for a custom trigger, for a
19
+ leading avatar per option, or for non-option footer actions.
20
+ - **Stand-in:** a raw trigger button plus a `role="combobox"` search field and
21
+ a `role="listbox"` list in the DS `Dropdown` look (tokens, elevation
22
+ shadow, DS `Button` for the footer actions).
23
+ - **Ask:** a `Combobox` `trigger` slot (render prop or `asChild`), an option
24
+ `leading` slot, and a `footer` slot outside the listbox.
25
+
26
+ ## 2. `Tooltip` and menus: a portal container
27
+
28
+ - **Where:** `src/components/Tooltip.tsx` and `src/components/Dropdown.tsx`.
29
+ - **Need:** the panel renders inside host apps (OpenCTI, OpenAEV, XTM One)
30
+ whose fixed bars sit above `document.body` children; the panel's theme
31
+ variables are declared on its root (`.filigran-chatbot`), not on the host
32
+ document.
33
+ - **What 1.5.0 does:** `Tooltip` (and the Radix menus under it) portal to
34
+ `document.body`: outside the panel's stacking context, where a host bar hides
35
+ the bubble, and outside the root that declares the theme, so the bubble loses
36
+ the panel's tokens.
37
+ - **Stand-in:** `Tooltip.tsx` (the `chat-tooltip` utility reading the DS
38
+ tooltip tokens first) and `Dropdown.tsx` (portals into `findChatbotRoot`).
39
+ The stylesheet test "every overlay the panel portals is mounted inside the
40
+ panel root" holds both.
41
+ - **Ask:** a `container` prop (or a `PortalContainerProvider`) on `Tooltip`,
42
+ `Menu`, `Popover` and `Combobox`, passed to the Radix portal.
package/package.json CHANGED
@@ -7,7 +7,7 @@
7
7
  "type": "git",
8
8
  "url": "git+https://github.com/FiligranHQ/filigran-ui.git"
9
9
  },
10
- "version": "3.22.0",
10
+ "version": "3.23.0",
11
11
  "type": "module",
12
12
  "exports": {
13
13
  ".": {
@@ -40,6 +40,7 @@
40
40
  "unified": "^11.0.0"
41
41
  },
42
42
  "peerDependencies": {
43
+ "@filigran/design-system": "^1.5.0",
43
44
  "react": ">=18",
44
45
  "react-dom": ">=18",
45
46
  "react-markdown": ">=10",
@@ -48,6 +49,7 @@
48
49
  },
49
50
  "devDependencies": {
50
51
  "@eslint/js": "10.0.1",
52
+ "@filigran/design-system": "1.5.0",
51
53
  "@rollup/plugin-commonjs": "29.0.2",
52
54
  "@rollup/plugin-json": "6.1.0",
53
55
  "@rollup/plugin-node-resolve": "16.0.3",