@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.
- package/dist/catalog.json +492 -492
- package/dist/components/Input/inputStyles.js +2 -2
- package/dist/components/Input/inputStyles.js.map +1 -1
- package/dist/components/LineChart/LineChart.d.ts +5 -5
- package/dist/components/LineChart/LineChart.js +24 -8
- package/dist/components/LineChart/LineChart.js.map +1 -1
- package/dist/components/LineChart/LineChart.types.d.ts +18 -0
- package/dist/components/LineChart/LineChart.utils.d.ts +7 -1
- package/dist/components/LineChart/LineChart.utils.js +35 -1
- package/dist/components/LineChart/LineChart.utils.js.map +1 -1
- package/dist/components/LineChart/LineChartPlot.d.ts +4 -2
- package/dist/components/LineChart/LineChartPlot.js +29 -5
- package/dist/components/LineChart/LineChartPlot.js.map +1 -1
- package/dist/components/LineChart/index.d.ts +1 -1
- package/dist/components/Select/Select.js +1 -1
- package/dist/components/Select/Select.js.map +1 -1
- package/dist/components/Select/SelectPrimitive.js +3 -3
- package/dist/components/Select/SelectPrimitive.js.map +1 -1
- package/dist/components/Textarea/Textarea.js +2 -2
- package/dist/components/Textarea/Textarea.js.map +1 -1
- package/dist/components/TopList/TopList.d.ts +1 -1
- package/dist/components/TopList/TopList.js +5 -3
- package/dist/components/TopList/TopList.js.map +1 -1
- package/dist/components/TopList/TopList.types.d.ts +2 -0
- package/dist/components/Typeahead/TypeaheadView.js +1 -1
- package/dist/components/Typeahead/TypeaheadView.js.map +1 -1
- package/dist/utilities.css +1 -1
- package/dist/utils/cn.js +3 -0
- package/dist/utils/cn.js.map +1 -1
- package/docs/DESIGN.md +3 -0
- package/docs/STYLES.md +42 -6
- package/package.json +2 -2
- package/tailwind.preset.cjs +3 -0
package/dist/utils/cn.js.map
CHANGED
|
@@ -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`
|
|
273
|
-
dark mode
|
|
274
|
-
|
|
275
|
-
use `
|
|
276
|
-
|
|
277
|
-
|
|
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.
|
|
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.
|
|
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",
|
package/tailwind.preset.cjs
CHANGED
|
@@ -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)',
|