@langchain/macaw-components 1.7.10 → 1.7.12

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.
@@ -13,12 +13,14 @@
13
13
  * - Pane (500): Side panes
14
14
  * - Popover (1000+): Popovers, dropdowns — large intentional jump to guarantee
15
15
  * portal-rendered overlays always beat any page layout complexity
16
+ * - Tooltip overlay (1500): Button tooltips above panes and non-modal popovers
16
17
  * - Modal (2000+): Modal dialogs
17
18
  * - Toast (9999): System toasts
18
19
  *
19
- * Note: Tooltips do NOT have a fixed z-index here. They always render at
20
- * contextZIndex + 1 (relative to their parent caller) via ZIndexContext,
21
- * so they naturally stack above whichever layer triggered them.
20
+ * Button tooltips use the tooltipOverlay floor or their ancestor's layer + 1,
21
+ * whichever is higher. Page tooltips therefore cover non-modal popovers and
22
+ * selection bars, but remain below modal dialogs; nested tooltips clear their
23
+ * own dialog or toast. The legacy tooltip value remains a low layout layer.
22
24
  */
23
25
  var zIndices = {
24
26
  content: 0,
@@ -31,10 +33,12 @@ var zIndices = {
31
33
  floatingBar: 2,
32
34
  resizeHandle: 2,
33
35
  sidebar: 5,
36
+ /** @deprecated Legacy layout layer; use useZIndex(zIndices.tooltipOverlay) for hover tooltips. */
34
37
  tooltip: 6,
35
38
  selectionActionBar: 12,
36
39
  pane: 500,
37
40
  popover: 1300,
41
+ tooltipOverlay: 1500,
38
42
  devToolPanel: 2500,
39
43
  dialogOverlay: 2999,
40
44
  dialogContent: 3e3,
@@ -1 +1 @@
1
- {"version":3,"file":"zIndices.js","names":[],"sources":["../../src/utils/zIndices.ts"],"sourcesContent":["/**\n * Centralized z-index values for the application.\n *\n * This file defines all z-index values used throughout the app to ensure\n * proper stacking order and avoid conflicts.\n *\n * Z-index layers (from lowest to highest):\n * - Content (0): Natural CSS baseline — regular content, sticky headers\n * - Navigation (1): Resize handles, floating bars\n * - Layout (2): Sidebar, overlays\n * - Grid interaction (4-5): Drag/resize overlays, sticky page headers\n * - Pane (500): Side panes\n * - Popover (1000+): Popovers, dropdowns — large intentional jump to guarantee\n * portal-rendered overlays always beat any page layout complexity\n * - Modal (2000+): Modal dialogs\n * - Toast (9999): System toasts\n *\n * Note: Tooltips do NOT have a fixed z-index here. They always render at\n * contextZIndex + 1 (relative to their parent caller) via ZIndexContext,\n * so they naturally stack above whichever layer triggered them.\n */\n\nconst zIndices = {\n // Content layer\n content: 0,\n stickyHeader: 1,\n tableStickyCell: 1, // Sticky table columns — above non-sticky cells (auto)\n tableStickyHeader: 3, // Sticky table header — above rows and sticky columns\n paneHeader: 4, // Above a scrolled table's sticky header\n dragOverlay: 4, // Grid drag/resize overlays — above sticky table headers (3)\n dashboardHeader: 5, // Sticky page header — above drag overlays, below tooltips\n floatingBar: 2,\n resizeHandle: 2, // Higher than sticky header to ensure it's always interactive\n\n // Layout layer (this is arbitrarily 5 to give a few layers above the content layer)\n sidebar: 5,\n\n tooltip: 6,\n\n selectionActionBar: 12, // Selection bars — above page headers and their tooltips\n\n // Pane layer\n pane: 500,\n\n // Popover layer — large jump ensures portal overlays always beat page layout\n popover: 1300,\n\n // Dev tool panels (e.g. Eppo control panel) — above popovers/Polly, below dialogs\n devToolPanel: 2500,\n\n dialogOverlay: 2999,\n dialogContent: 3000,\n\n // System toasts — above dialogs, but bounded so nested items(e.g., button labels) can overlay\n toast: 9999,\n} as const;\n\nexport default zIndices;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAM,WAAW;CAEf,SAAS;CACT,cAAc;CACd,iBAAiB;CACjB,mBAAmB;CACnB,YAAY;CACZ,aAAa;CACb,iBAAiB;CACjB,aAAa;CACb,cAAc;CAGd,SAAS;CAET,SAAS;CAET,oBAAoB;CAGpB,MAAM;CAGN,SAAS;CAGT,cAAc;CAEd,eAAe;CACf,eAAe;CAGf,OAAO;AACT"}
1
+ {"version":3,"file":"zIndices.js","names":[],"sources":["../../src/utils/zIndices.ts"],"sourcesContent":["/**\n * Centralized z-index values for the application.\n *\n * This file defines all z-index values used throughout the app to ensure\n * proper stacking order and avoid conflicts.\n *\n * Z-index layers (from lowest to highest):\n * - Content (0): Natural CSS baseline — regular content, sticky headers\n * - Navigation (1): Resize handles, floating bars\n * - Layout (2): Sidebar, overlays\n * - Grid interaction (4-5): Drag/resize overlays, sticky page headers\n * - Pane (500): Side panes\n * - Popover (1000+): Popovers, dropdowns — large intentional jump to guarantee\n * portal-rendered overlays always beat any page layout complexity\n * - Tooltip overlay (1500): Button tooltips above panes and non-modal popovers\n * - Modal (2000+): Modal dialogs\n * - Toast (9999): System toasts\n *\n * Button tooltips use the tooltipOverlay floor or their ancestor's layer + 1,\n * whichever is higher. Page tooltips therefore cover non-modal popovers and\n * selection bars, but remain below modal dialogs; nested tooltips clear their\n * own dialog or toast. The legacy tooltip value remains a low layout layer.\n */\n\nconst zIndices = {\n // Content layer\n content: 0,\n stickyHeader: 1,\n tableStickyCell: 1, // Sticky table columns — above non-sticky cells (auto)\n tableStickyHeader: 3, // Sticky table header — above rows and sticky columns\n paneHeader: 4, // Above a scrolled table's sticky header\n dragOverlay: 4, // Grid drag/resize overlays — above sticky table headers (3)\n dashboardHeader: 5, // Sticky page header — above drag overlays, below tooltip overlays\n floatingBar: 2,\n resizeHandle: 2, // Higher than sticky header to ensure it's always interactive\n\n // Layout layer (this is arbitrarily 5 to give a few layers above the content layer)\n sidebar: 5,\n\n /** @deprecated Legacy layout layer; use useZIndex(zIndices.tooltipOverlay) for hover tooltips. */\n tooltip: 6,\n\n selectionActionBar: 12, // Selection bars — above page headers, below tooltip overlays\n\n // Pane layer\n pane: 500,\n\n // Popover layer — large jump ensures portal overlays always beat page layout\n popover: 1300,\n\n tooltipOverlay: 1500,\n\n // Dev tool panels (e.g. Eppo control panel) — above popovers/Polly, below dialogs\n devToolPanel: 2500,\n\n dialogOverlay: 2999,\n dialogContent: 3000,\n\n // System toasts — above dialogs, but bounded so nested items(e.g., button labels) can overlay\n toast: 9999,\n} as const;\n\nexport default zIndices;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAwBA,IAAM,WAAW;CAEf,SAAS;CACT,cAAc;CACd,iBAAiB;CACjB,mBAAmB;CACnB,YAAY;CACZ,aAAa;CACb,iBAAiB;CACjB,aAAa;CACb,cAAc;CAGd,SAAS;;CAGT,SAAS;CAET,oBAAoB;CAGpB,MAAM;CAGN,SAAS;CAET,gBAAgB;CAGhB,cAAc;CAEd,eAAe;CACf,eAAe;CAGf,OAAO;AACT"}
package/docs/CHAT.md CHANGED
@@ -5,6 +5,21 @@ own message and event parsing, network requests, streaming, persistence,
5
5
  authorization, analytics, tool execution, and product-specific tool or logo
6
6
  mapping.
7
7
 
8
+ ## Conversation scrolling
9
+
10
+ `ChatConversation` follows new output while the reader is at the bottom;
11
+ scrolling up pauses it and shows **Jump to latest**. `follow="none"` never
12
+ scrolls on its own.
13
+
14
+ Set `pinnedMessageId` to the message the reader just sent: it moves to the top,
15
+ and the reply streams in below it. Following resumes when the reader scrolls
16
+ to the end or uses **Jump to latest**.
17
+
18
+ Earlier messages inserted above the reader keep the first visible message in
19
+ place, so the host only fetches and renders them. Both find messages by
20
+ `data-chat-message-id`, which `ChatMessage` sets; give custom rows the same
21
+ attribute.
22
+
8
23
  ## Tool calls and shared state
9
24
 
10
25
  Import `ChatState` from `@langchain/macaw-components/ChatState`. It owns the
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@langchain/macaw-components",
3
- "version": "1.7.10",
3
+ "version": "1.7.12",
4
4
  "description": "React components and usage guidance for the Macaw Design System.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -657,7 +657,7 @@
657
657
  "@fontsource/fira-code": "^5.2.7",
658
658
  "@fontsource/inter": "^5.2.8",
659
659
  "@headlessui/react": "^2.2.10",
660
- "@langchain/macaw-tokens": "1.7.10",
660
+ "@langchain/macaw-tokens": "1.7.12",
661
661
  "@lezer/common": "^1.2.1",
662
662
  "@lezer/highlight": "^1.2.0",
663
663
  "@lezer/yaml": "^1.0.4",