@langchain/macaw-components 1.2.0 → 1.2.2

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.
Files changed (33) hide show
  1. package/dist/catalog.json +492 -492
  2. package/dist/components/Input/inputStyles.js +2 -2
  3. package/dist/components/Input/inputStyles.js.map +1 -1
  4. package/dist/components/LineChart/LineChart.d.ts +5 -5
  5. package/dist/components/LineChart/LineChart.js +24 -8
  6. package/dist/components/LineChart/LineChart.js.map +1 -1
  7. package/dist/components/LineChart/LineChart.types.d.ts +18 -0
  8. package/dist/components/LineChart/LineChart.utils.d.ts +7 -1
  9. package/dist/components/LineChart/LineChart.utils.js +35 -1
  10. package/dist/components/LineChart/LineChart.utils.js.map +1 -1
  11. package/dist/components/LineChart/LineChartPlot.d.ts +4 -2
  12. package/dist/components/LineChart/LineChartPlot.js +29 -5
  13. package/dist/components/LineChart/LineChartPlot.js.map +1 -1
  14. package/dist/components/LineChart/index.d.ts +1 -1
  15. package/dist/components/Select/Select.js +1 -1
  16. package/dist/components/Select/Select.js.map +1 -1
  17. package/dist/components/Select/SelectPrimitive.js +3 -3
  18. package/dist/components/Select/SelectPrimitive.js.map +1 -1
  19. package/dist/components/Textarea/Textarea.js +2 -2
  20. package/dist/components/Textarea/Textarea.js.map +1 -1
  21. package/dist/components/TopList/TopList.d.ts +1 -1
  22. package/dist/components/TopList/TopList.js +5 -3
  23. package/dist/components/TopList/TopList.js.map +1 -1
  24. package/dist/components/TopList/TopList.types.d.ts +2 -0
  25. package/dist/components/Typeahead/TypeaheadView.js +1 -1
  26. package/dist/components/Typeahead/TypeaheadView.js.map +1 -1
  27. package/dist/utilities.css +1 -1
  28. package/dist/utils/cn.js +3 -0
  29. package/dist/utils/cn.js.map +1 -1
  30. package/docs/DESIGN.md +3 -0
  31. package/docs/STYLES.md +42 -6
  32. package/package.json +2 -2
  33. package/tailwind.preset.cjs +3 -0
@@ -1 +1 @@
1
- {"version":3,"file":"cn.js","names":[],"sources":["../../src/utils/cn.tsx"],"sourcesContent":["import type { ClassValue } from 'clsx';\nimport { clsx } from 'clsx';\nimport { extendTailwindMerge } from 'tailwind-merge';\n\n/** Numeric brand palette keys from `theme.colors.brand` (Tailwind). */\nconst BRAND_PALETTE_STEPS = [\n '10',\n '25',\n '50',\n '75',\n '100',\n '200',\n '300',\n '400',\n '500',\n '600',\n '700',\n '800',\n '900',\n '950',\n] as const;\n\nconst brandBgClasses = BRAND_PALETTE_STEPS.map((step) => `bg-brand-${step}`);\nconst brandBorderClasses = BRAND_PALETTE_STEPS.map(\n (step) => `border-brand-${step}`\n);\nconst brandTextClasses = BRAND_PALETTE_STEPS.map(\n (step) => `text-brand-${step}`\n);\nconst buttonBorderColorClasses = [\n 'button-primary-underlined-border',\n 'button-primary-underlined-border-hover',\n 'button-secondary-border',\n 'button-secondary-border-hover',\n 'button-secondary-underlined-border',\n 'button-secondary-underlined-border-hover',\n 'button-error-border',\n 'button-error-outlined-border',\n 'button-error-underlined-border',\n 'button-error-underlined-border-hover',\n 'button-error-disabled-border',\n];\nconst buttonTextColorClasses = [\n 'button-primary-underlined-foreground',\n 'button-primary-underlined-foreground-hover',\n 'button-error-underlined-foreground-hover',\n 'button-error-disabled-foreground',\n];\n\n// Lets `space-*` tokens dedupe against built-in spacing (keep in sync with tailwind.config.js).\nconst SPACE_SCALE_STEPS = [\n 'space-1',\n 'space-2',\n 'space-3',\n 'space-4',\n 'space-5',\n 'space-6',\n 'space-7',\n 'space-8',\n 'space-9',\n];\n\nconst customTwMerge = extendTailwindMerge({\n extend: {\n theme: {\n spacing: SPACE_SCALE_STEPS,\n shadow: ['slider-thumb'],\n },\n classGroups: {\n // Extend font-size to include custom display and caps classes\n 'font-size': [\n 'display-sm',\n 'display-base',\n 'display-lg',\n 'display-xl',\n 'display-2xl',\n 'caps-label-sm',\n 'caps-label-xs',\n 'text-xxs',\n 'text-xs',\n 'text-sm',\n 'text-base',\n 'text-lg',\n 'text-xl',\n ],\n // Extend bg-color to include custom background colors\n 'bg-color': [\n 'bg-primary',\n 'bg-primary-hover',\n 'bg-secondary',\n 'bg-secondary-hover',\n 'bg-tertiary',\n 'bg-quaternary',\n 'bg-surface-level-1',\n 'bg-surface-level-1-hover',\n 'bg-surface-level-2',\n 'bg-surface-level-2-hover',\n 'bg-surface-level-3',\n 'bg-surface-level-4',\n 'bg-disabled',\n 'bg-input',\n 'bg-input-disabled',\n 'bg-elevated',\n 'bg-elevated-hover',\n 'bg-elevated-selected',\n 'bg-overlay',\n 'bg-brand',\n 'bg-brand-hover',\n 'bg-brand-subtle',\n 'bg-brand-subtle-gradient',\n 'bg-brand-subtle-hover',\n 'bg-brand-illustration',\n 'bg-brand-muted',\n 'bg-brand-primary',\n 'bg-brand-primary-hover',\n 'bg-brand-secondary',\n 'bg-brand-secondary-hover',\n 'bg-brand-tertiary',\n 'bg-purple',\n 'bg-success',\n 'bg-success-subtle',\n 'bg-success-primary',\n 'bg-success-secondary',\n 'bg-success-strong',\n 'bg-error',\n 'bg-error-subtle',\n 'bg-error-primary',\n 'bg-error-secondary',\n 'bg-error-strong',\n 'button-error-bg-hover',\n 'bg-warning',\n 'bg-warning-subtle',\n 'bg-warning-primary',\n 'bg-warning-secondary',\n 'bg-warning-strong',\n 'bg-control-active',\n 'bg-control-active-hover',\n 'bg-control-thumb',\n 'bg-control-disabled',\n 'bg-selected',\n 'bg-selected-hover',\n ...brandBgClasses,\n ],\n // Extend border-color to include custom border colors\n 'border-color': [\n 'border-default',\n 'border-subtle',\n 'border-muted',\n 'border-faint',\n 'border-primary',\n 'border-secondary',\n 'border-tertiary',\n 'border-quaternary',\n 'border-error',\n 'border-error-strong',\n 'border-brand',\n 'border-brand-strong',\n 'border-brand-subtle',\n 'border-strong',\n 'border-disabled',\n 'border-focus',\n 'border-warning',\n 'border-success',\n 'border-purple',\n 'border-status-green',\n 'border-status-orange',\n 'border-status-yellow',\n 'border-status-red',\n ...brandBorderClasses,\n ...buttonBorderColorClasses,\n ],\n // Extend text-color to include custom text colors\n 'text-color': [\n 'text-primary',\n 'text-secondary',\n 'text-tertiary',\n 'text-quaternary',\n 'text-disabled',\n 'text-error-secondary',\n 'text-warning-secondary',\n 'text-success-secondary',\n 'text-placeholder',\n 'text-control-active-foreground',\n 'text-purple',\n 'text-brand-primary',\n 'text-brand-secondary',\n 'text-brand-tertiary',\n 'text-brand-disabled',\n 'text-brand-on-fill',\n 'text-link',\n 'text-link-hover',\n 'text-status-green',\n 'text-status-orange',\n 'text-status-yellow',\n 'text-status-red',\n 'text-button-primary',\n 'text-icon-primary',\n 'text-icon-secondary',\n 'text-icon-tertiary',\n 'text-icon-disabled',\n 'text-icon-brand',\n 'text-icon-error',\n 'text-icon-success',\n 'text-icon-warning',\n ...brandTextClasses,\n ...buttonTextColorClasses,\n ],\n },\n },\n});\n\nexport const cn = (...inputs: ClassValue[]) => {\n return customTwMerge(clsx(inputs));\n};\n"],"mappings":";;;;AAKA,IAAM,sBAAsB;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,IAAM,iBAAiB,oBAAoB,KAAK,SAAS,YAAY,MAAM;AAC3E,IAAM,qBAAqB,oBAAoB,KAC5C,SAAS,gBAAgB,MAC5B;AACA,IAAM,mBAAmB,oBAAoB,KAC1C,SAAS,cAAc,MAC1B;AACA,IAAM,2BAA2B;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AACA,IAAM,yBAAyB;CAC7B;CACA;CACA;CACA;AACF;AAeA,IAAM,gBAAgB,oBAAoB,EACxC,QAAQ;CACN,OAAO;EACL,SAAS;GAdb;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EAMa;EACT,QAAQ,CAAC,cAAc;CACzB;CACA,aAAa;EAEX,aAAa;GACX;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF;EAEA,YAAY;GACV;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,GAAG;EACL;EAEA,gBAAgB;GACd;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,GAAG;GACH,GAAG;EACL;EAEA,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,GAAG;GACH,GAAG;EACL;CACF;AACF,EACF,CAAC;AAED,IAAa,MAAM,GAAG,WAAyB;CAC7C,OAAO,cAAc,KAAK,MAAM,CAAC;AACnC"}
1
+ {"version":3,"file":"cn.js","names":[],"sources":["../../src/utils/cn.tsx"],"sourcesContent":["import type { ClassValue } from 'clsx';\nimport { clsx } from 'clsx';\nimport { extendTailwindMerge } from 'tailwind-merge';\n\n/** Numeric brand palette keys from `theme.colors.brand` (Tailwind). */\nconst BRAND_PALETTE_STEPS = [\n '10',\n '25',\n '50',\n '75',\n '100',\n '200',\n '300',\n '400',\n '500',\n '600',\n '700',\n '800',\n '900',\n '950',\n] as const;\n\nconst brandBgClasses = BRAND_PALETTE_STEPS.map((step) => `bg-brand-${step}`);\nconst brandBorderClasses = BRAND_PALETTE_STEPS.map(\n (step) => `border-brand-${step}`\n);\nconst brandTextClasses = BRAND_PALETTE_STEPS.map(\n (step) => `text-brand-${step}`\n);\nconst buttonBorderColorClasses = [\n 'button-primary-underlined-border',\n 'button-primary-underlined-border-hover',\n 'button-secondary-border',\n 'button-secondary-border-hover',\n 'button-secondary-underlined-border',\n 'button-secondary-underlined-border-hover',\n 'button-error-border',\n 'button-error-outlined-border',\n 'button-error-underlined-border',\n 'button-error-underlined-border-hover',\n 'button-error-disabled-border',\n];\nconst buttonTextColorClasses = [\n 'button-primary-underlined-foreground',\n 'button-primary-underlined-foreground-hover',\n 'button-error-underlined-foreground-hover',\n 'button-error-disabled-foreground',\n];\n\n// Lets `space-*` tokens dedupe against built-in spacing (keep in sync with tailwind.config.js).\nconst SPACE_SCALE_STEPS = [\n 'space-1',\n 'space-2',\n 'space-3',\n 'space-4',\n 'space-5',\n 'space-6',\n 'space-7',\n 'space-8',\n 'space-9',\n];\n\nconst customTwMerge = extendTailwindMerge({\n extend: {\n theme: {\n spacing: SPACE_SCALE_STEPS,\n shadow: ['slider-thumb'],\n },\n classGroups: {\n // Extend font-size to include custom display and caps classes\n 'font-size': [\n 'display-sm',\n 'display-base',\n 'display-lg',\n 'display-xl',\n 'display-2xl',\n 'caps-label-sm',\n 'caps-label-xs',\n 'text-xxs',\n 'text-xs',\n 'text-sm',\n 'text-base',\n 'text-lg',\n 'text-xl',\n ],\n // Extend bg-color to include custom background colors\n 'bg-color': [\n 'bg-primary',\n 'bg-primary-hover',\n 'bg-secondary',\n 'bg-secondary-hover',\n 'bg-tertiary',\n 'bg-quaternary',\n 'bg-surface-level-1',\n 'bg-surface-level-1-hover',\n 'bg-surface-level-2',\n 'bg-surface-level-2-hover',\n 'bg-surface-level-3',\n 'bg-surface-level-4',\n 'bg-disabled',\n 'bg-input',\n 'bg-input-hover',\n 'bg-input-disabled',\n 'bg-elevated',\n 'bg-elevated-hover',\n 'bg-elevated-selected',\n 'bg-overlay',\n 'bg-brand',\n 'bg-brand-hover',\n 'bg-brand-subtle',\n 'bg-brand-subtle-gradient',\n 'bg-brand-subtle-hover',\n 'bg-brand-illustration',\n 'bg-brand-muted',\n 'bg-brand-primary',\n 'bg-brand-primary-hover',\n 'bg-brand-secondary',\n 'bg-brand-secondary-hover',\n 'bg-brand-tertiary',\n 'bg-purple',\n 'bg-success',\n 'bg-success-subtle',\n 'bg-success-primary',\n 'bg-success-secondary',\n 'bg-success-strong',\n 'bg-error',\n 'bg-error-subtle',\n 'bg-error-primary',\n 'bg-error-secondary',\n 'bg-error-strong',\n 'button-error-bg-hover',\n 'bg-warning',\n 'bg-warning-subtle',\n 'bg-warning-primary',\n 'bg-warning-secondary',\n 'bg-warning-strong',\n 'bg-control-active',\n 'bg-control-active-hover',\n 'bg-control-thumb',\n 'bg-control-disabled',\n 'bg-selected',\n 'bg-selected-hover',\n ...brandBgClasses,\n ],\n // Extend border-color to include custom border colors\n 'border-color': [\n 'border-input',\n 'border-input-hover',\n 'border-default',\n 'border-subtle',\n 'border-muted',\n 'border-faint',\n 'border-primary',\n 'border-secondary',\n 'border-tertiary',\n 'border-quaternary',\n 'border-error',\n 'border-error-strong',\n 'border-brand',\n 'border-brand-strong',\n 'border-brand-subtle',\n 'border-strong',\n 'border-disabled',\n 'border-focus',\n 'border-warning',\n 'border-success',\n 'border-purple',\n 'border-status-green',\n 'border-status-orange',\n 'border-status-yellow',\n 'border-status-red',\n ...brandBorderClasses,\n ...buttonBorderColorClasses,\n ],\n // Extend text-color to include custom text colors\n 'text-color': [\n 'text-primary',\n 'text-secondary',\n 'text-tertiary',\n 'text-quaternary',\n 'text-disabled',\n 'text-error-secondary',\n 'text-warning-secondary',\n 'text-success-secondary',\n 'text-placeholder',\n 'text-control-active-foreground',\n 'text-purple',\n 'text-brand-primary',\n 'text-brand-secondary',\n 'text-brand-tertiary',\n 'text-brand-disabled',\n 'text-brand-on-fill',\n 'text-link',\n 'text-link-hover',\n 'text-status-green',\n 'text-status-orange',\n 'text-status-yellow',\n 'text-status-red',\n 'text-button-primary',\n 'text-icon-primary',\n 'text-icon-secondary',\n 'text-icon-tertiary',\n 'text-icon-disabled',\n 'text-icon-brand',\n 'text-icon-error',\n 'text-icon-success',\n 'text-icon-warning',\n ...brandTextClasses,\n ...buttonTextColorClasses,\n ],\n },\n },\n});\n\nexport const cn = (...inputs: ClassValue[]) => {\n return customTwMerge(clsx(inputs));\n};\n"],"mappings":";;;;AAKA,IAAM,sBAAsB;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,IAAM,iBAAiB,oBAAoB,KAAK,SAAS,YAAY,MAAM;AAC3E,IAAM,qBAAqB,oBAAoB,KAC5C,SAAS,gBAAgB,MAC5B;AACA,IAAM,mBAAmB,oBAAoB,KAC1C,SAAS,cAAc,MAC1B;AACA,IAAM,2BAA2B;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AACA,IAAM,yBAAyB;CAC7B;CACA;CACA;CACA;AACF;AAeA,IAAM,gBAAgB,oBAAoB,EACxC,QAAQ;CACN,OAAO;EACL,SAAS;GAdb;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EAMa;EACT,QAAQ,CAAC,cAAc;CACzB;CACA,aAAa;EAEX,aAAa;GACX;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF;EAEA,YAAY;GACV;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,GAAG;EACL;EAEA,gBAAgB;GACd;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,GAAG;GACH,GAAG;EACL;EAEA,cAAc;GACZ;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,GAAG;GACH,GAAG;EACL;CACF;AACF,EACF,CAAC;AAED,IAAa,MAAM,GAAG,WAAyB;CAC7C,OAAO,cAAc,KAAK,MAAM,CAAC;AACnC"}
package/docs/DESIGN.md CHANGED
@@ -123,6 +123,7 @@ Choose color by meaning:
123
123
  - `bg-sidebar` is reserved for app navigation, independent of fields and floating surfaces.
124
124
  - `bg-elevated` is for raised cards and panes; `bg-elevated-hover` and `bg-elevated-selected` are interaction states within raised or floating surfaces.
125
125
  - `bg-input` is for Input and Textarea fields, Select and Typeahead controls. Select and Typeahead own their field styles; Button does not infer appearance from ARIA attributes. Custom Button-based picker migration is deferred; prefer Select for standard pickers. Action-menu buttons retain their normal button styles. Embedded inputs can use `inputContainerClassName="border-0 bg-transparent"`; embedded Textarea uses `variant="plain"`. Plain button triggers remain transparent.
126
+ - Outlined fields use `border-input` at rest and `border-input-hover` on hover. Light-mode fields use a white `bg-input` fill. Input, Textarea, and Typeahead keep `bg-input` on hover; Select uses `bg-input-hover` to override the Button hover fill. Plain fields remain borderless.
126
127
  - `bg-input-disabled` is for disabled fields, paired with `border-muted` and disabled text/icon colors. Do not fade the entire field with opacity.
127
128
  - `bg-popover` is for floating overlays: tooltips (including chart tooltips), popovers, select and typeahead menus, dropdowns, context menus, and command menus. It is independent of the field fill even when the colors match.
128
129
  - Success, warning, and error tokens describe general feedback and validation.
@@ -132,6 +133,8 @@ Choose color by meaning:
132
133
 
133
134
  Chart SVG `fill` and `stroke` are the exception to Tailwind-only color usage. Import semantic values from `@langchain/macaw-components/utils/chartColors`; do not use raw visualization variables or literals.
134
135
 
136
+ Import `LineChart` from `@langchain/macaw-components/LineChart` for series over time. Keep the default `line` variant to compare how individual series change. Use `variant="stacked-area"` to show a total and each series' contribution, and only for same-unit values that add up, such as counts; never stack averages, rates, latency, or percentiles. See **Line Charts** in [`STYLES.md`](./STYLES.md).
137
+
135
138
  Import `SankeyChart` from `@langchain/macaw-components/SankeyChart` for weighted flow diagrams. Compose it with `ChartCard`, `ChartLegend`, and `ChartTooltip`; consumers own data, value formatting, tooltips, and navigation.
136
139
 
137
140
  Import `HeatmapChart` and `HeatmapBlock` from `@langchain/macaw-components/HeatmapChart` for percentage matrices. Supply `getBlockLabel` for meaningful row and column names; cells expose details on hover and keyboard focus. The matrix has one Tab stop; arrow keys move between cells, Home/End move within a row, and Ctrl+Home/End move to the first/last cell.
package/docs/STYLES.md CHANGED
@@ -197,6 +197,34 @@ dashboard visualization shells.
197
197
  reordering; `variant="full-width"` hides the move handle.
198
198
  - Use `expandButtonProps` and `menuItems` for optional, feature-owned actions.
199
199
 
200
+ ## Line Charts
201
+
202
+ Use `LineChart` from `@langchain/macaw-components/LineChart` for numeric series
203
+ over time or ordered buckets. Choose `variant` by the question the chart answers:
204
+
205
+ | `variant` | Answers | Example values |
206
+ | ---------------- | ------------------------------------------------------ | ---------------------------------------------- |
207
+ | `line` (default) | How does each series change, and how do they compare? | Per-category trends, latency, error rate |
208
+ | `stacked-area` | How large is the total, and what does each series add? | Request counts by environment, cost by service |
209
+
210
+ - Stack only series with the same unit whose values add up to a meaningful
211
+ total, such as counts, volumes, or costs. Keep `line` for averages, rates,
212
+ ratios, latency, percentiles, and scores; their stacked height means nothing.
213
+ - Series stack per y axis in input order, with the first series at the bottom.
214
+ Positive values stack up from zero and negative values stack down. A missing
215
+ or null value adds nothing to its stack. Legend selection restacks only the
216
+ selected series.
217
+ - Areas are solid fills from the categorical fill palette. Leave `color` unset
218
+ or pass a categorical line color, and the chart switches it to the
219
+ hue-matched fill. Any other color is used as given. Per-series stroke width
220
+ and dash patterns do not apply.
221
+ - To offer both views of the same data, pass the same series and switch
222
+ `variant`. Each series keeps its hue, and legend, crosshair, points, markers,
223
+ and bands behave the same.
224
+ - Pointer callbacks report each series' own value and its area color, not its
225
+ stacked height. Show those values in the tooltip with one `ChartTooltipRow`
226
+ per series, and add a `variant="total"` row when the total matters.
227
+
200
228
  ## Top Lists
201
229
 
202
230
  Use `TopList` from `@langchain/macaw-components/TopList` for ranked top-K
@@ -259,6 +287,7 @@ Use the lowest level that creates enough separation. Avoid skipping levels unles
259
287
  | `bg-disabled` | Disabled input or control fill |
260
288
  | `bg-elevated` | Raised cards and panes |
261
289
  | `bg-input` | Input and textarea fields, picker controls, filled popup triggers |
290
+ | `bg-input-hover` | Hover fill for Select controls |
262
291
  | `bg-input-disabled` | Disabled field fill, independent of general disabled controls |
263
292
  | `bg-elevated-hover` | Hover state inside a raised or floating surface |
264
293
  | `bg-elevated-selected` | Selected item inside a raised or floating surface |
@@ -269,12 +298,17 @@ Use the lowest level that creates enough separation. Avoid skipping levels unles
269
298
  `bg-sidebar` is reserved for app navigation: `neutral-50` in light mode and
270
299
  `neutral-35` in dark mode, independent of fields, popovers, and raised surfaces.
271
300
 
272
- `bg-input` and `bg-popover` use `neutral-25` in light mode and `neutral-100` in
273
- dark mode but remain independent semantic roles. Light-mode hover and selection
274
- fills use `neutral-100`; raised `bg-elevated` surfaces stay white. Outlined fields
275
- use `border-muted` at rest and `border-subtle` on hover in
276
- both themes, with semantic focus and error indicators. Outlined fields use a
277
- 1px outer focus ring; native inputs stay unoutlined inside their containers.
301
+ `bg-input` is white in light mode; `bg-popover` uses `neutral-25`. Both use
302
+ `neutral-100` in dark mode and remain independent semantic roles. Raised
303
+ `bg-elevated` surfaces stay white in light mode; menu hover and selection fills
304
+ use `neutral-100`.
305
+
306
+ Outlined fields use `border-input` at rest and `border-input-hover` on hover.
307
+ These resolve to `border-subtle` / `border-default` in light mode and
308
+ `border-muted` / `border-subtle` in dark mode. Input, Textarea, and Typeahead
309
+ keep `bg-input` on hover. Select uses `bg-input-hover` to override the Button
310
+ hover fill: white in light mode and `neutral-200` in dark mode. Fields retain semantic focus and error indicators and a 1px outer
311
+ focus ring; native inputs stay unoutlined inside their containers.
278
312
  Use `text-placeholder` for field hints. Plain fields remain borderless at rest.
279
313
  This applies to Input, Textarea, Select, and Typeahead, including multi-value fields.
280
314
  Select and Typeahead own their field treatment; Button does not infer appearance
@@ -341,6 +375,8 @@ Used internally by Checkbox, RadioButton, Switch, and Slider. Prefer those compo
341
375
 
342
376
  | Class | When to use |
343
377
  | --------------------- | ---------------------------------------- |
378
+ | `border-input` | Enabled field border; adapts per theme |
379
+ | `border-input-hover` | Enabled field hover border |
344
380
  | `border-default` | Default input, card, or container border |
345
381
  | `border-subtle` | Subtle divider |
346
382
  | `border-muted` | Very subtle divider |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@langchain/macaw-components",
3
- "version": "1.2.0",
3
+ "version": "1.2.2",
4
4
  "description": "React components and usage guidance for the Macaw Design System.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -582,7 +582,7 @@
582
582
  "@fontsource/fira-code": "^5.2.7",
583
583
  "@fontsource/inter": "^5.2.8",
584
584
  "@headlessui/react": "^2.2.10",
585
- "@langchain/macaw-tokens": "1.2.0",
585
+ "@langchain/macaw-tokens": "1.2.2",
586
586
  "@lezer/common": "^1.2.1",
587
587
  "@lezer/highlight": "^1.2.0",
588
588
  "@lezer/yaml": "^1.0.4",
@@ -153,6 +153,7 @@ module.exports = {
153
153
  },
154
154
  backgroundColor: {
155
155
  input: 'var(--bg-input)',
156
+ 'input-hover': 'var(--bg-input-hover)',
156
157
  'input-disabled': 'var(--bg-input-disabled)',
157
158
  'surface-level-1': 'var(--bg-surface-level-1)',
158
159
  'surface-level-1-hover': 'var(--bg-surface-level-1-hover)',
@@ -252,6 +253,8 @@ module.exports = {
252
253
  'warning-secondary': 'var(--bg-warning-secondary)',
253
254
  },
254
255
  borderColor: {
256
+ input: 'var(--border-input)',
257
+ 'input-hover': 'var(--border-input-hover)',
255
258
  default: 'var(--border-default)',
256
259
  subtle: 'var(--border-subtle)',
257
260
  muted: 'var(--border-muted)',