@langchain/macaw-components 1.3.0 → 1.3.1

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.
@@ -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-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"}
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-plain',\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;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
@@ -57,7 +57,7 @@ Use existing components for their interaction contracts, not just their appearan
57
57
  - Use `RadioGroup` for a short visible choice set and `RadioCard` when an option needs supporting content.
58
58
  - Use `Dialog` for a short blocking decision and `Pane` for substantial editing or detail work.
59
59
  - Use the Tabs family for tabbed navigation, with routing handled by the app, and `GroupedTabs` for a local view switch.
60
- - Use `Banner` for persistent regional information, `useToast().createToast(...)` for the result of an action, and field hint/error APIs for validation.
60
+ - Use `Banner` for persistent regional information, `useToast().createToast(...)` for the result of an action, and field hint/error APIs for validation. All toast variants auto-dismiss after five seconds by default; callers can set `duration: Infinity` for manual dismissal or a custom duration in milliseconds.
61
61
  - Use `ThinkingState` for active AI work (generation, reasoning, or tool use); name the work and show elapsed time only for longer waits.
62
62
  - Use `LoadingIndicator` for the AI animation alone; announce status on its surrounding control or region.
63
63
  - Use `size="xs"` on `ThinkingState` or `LoadingIndicator` for compact inline status (12px indicator).
@@ -123,7 +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
+ - 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 Input and CommandInput fields remain borderless and use `bg-input-plain`, which stays visible on white surfaces and distinct from `bg-input-disabled`.
127
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.
128
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.
129
129
  - Success, warning, and error tokens describe general feedback and validation.
package/docs/STYLES.md CHANGED
@@ -288,6 +288,7 @@ Use the lowest level that creates enough separation. Avoid skipping levels unles
288
288
  | `bg-elevated` | Raised cards and panes |
289
289
  | `bg-input` | Input and textarea fields, picker controls, filled popup triggers |
290
290
  | `bg-input-hover` | Hover fill for Select controls |
291
+ | `bg-input-plain` | Fill for borderless (`variant="plain"`) Input and CommandInput |
291
292
  | `bg-input-disabled` | Disabled field fill, independent of general disabled controls |
292
293
  | `bg-elevated-hover` | Hover state inside a raised or floating surface |
293
294
  | `bg-elevated-selected` | Selected item inside a raised or floating surface |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@langchain/macaw-components",
3
- "version": "1.3.0",
3
+ "version": "1.3.1",
4
4
  "description": "React components and usage guidance for the Macaw Design System.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -597,7 +597,7 @@
597
597
  "@fontsource/fira-code": "^5.2.7",
598
598
  "@fontsource/inter": "^5.2.8",
599
599
  "@headlessui/react": "^2.2.10",
600
- "@langchain/macaw-tokens": "1.3.0",
600
+ "@langchain/macaw-tokens": "1.3.1",
601
601
  "@lezer/common": "^1.2.1",
602
602
  "@lezer/highlight": "^1.2.0",
603
603
  "@lezer/yaml": "^1.0.4",
@@ -157,6 +157,7 @@ module.exports = {
157
157
  backgroundColor: {
158
158
  input: 'var(--bg-input)',
159
159
  'input-hover': 'var(--bg-input-hover)',
160
+ 'input-plain': 'var(--bg-input-plain)',
160
161
  'input-disabled': 'var(--bg-input-disabled)',
161
162
  'surface-level-1': 'var(--bg-surface-level-1)',
162
163
  'surface-level-1-hover': 'var(--bg-surface-level-1-hover)',