@stackone/malachite 2.103.0 → 2.104.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.
package/COMPONENTS.md CHANGED
@@ -117,6 +117,8 @@ The catalog of components exported from `@stackone/malachite`. **Reach for one o
117
117
  ## Data display
118
118
 
119
119
  - **`LevelMeter`** — Rising bars, shortest first, that picture how much of a scale is on — an access level in a level menu or on a level chip. Each step is `on` (a solid accent-green bar), `partial` (a green outline over a faint tint, for a step only some of whose actions are on) or `off` (an empty grey outline); every step keeps 3:1 against the surface, and colours come from the theme. Styled inline so it still draws inside an `ActionMenu`, which portals outside the shadow root and its stylesheet. Beside text that already names the level it is decorative and hidden from assistive tech; give it a `label` only when it stands alone and it reads as an image of that name. As an `ActionMenu` item `icon` or a `Button` `icon`, leave `label` off: the icon joins the item name, and the text already says the level. _Key props:_ `steps` (`LevelMeterStep[]`: `on` | `partial` | `off`), `label`, `className`.
120
+ - **`Hexagon`** — A filled hexagon in one status tone, the mark for an outcome as a `LinkCard` `icon` and the unit of a `HexagonScale`. Tones fill from the theme: `neutral` grey (`text.dimmed`), `success` green (`text.success`), `caution` pale amber (`warning.fillMuted`), `warning` amber (`warning.fill`), `error` red (`error.background`, as `TimeBarChart` fills it). `dimmed` draws it at 20% for a step of a scale that is not the current one. Always decorative and hidden from assistive tech, so the text beside it has to name the outcome. Styled inline so it still draws outside the shadow root’s stylesheet. _Key props:_ `tone` (`HexagonTone`: `neutral` | `success` | `caution` | `warning` | `error`; default `neutral`), `size` (`HexagonSize`: `small` 16px | `medium` 18px; default `medium`), `dimmed`, `className`.
121
+ - **`HexagonScale`** — A row of small hexagons, one per step of an ordered scale, with the `current` step at full strength and the rest dimmed to 20%; with no `current` every step is dimmed. Built for a `LinkCard`’s `trailing` slot, where it places an outcome on a scale such as allowed → redacted → monitored → denied. Beside text that already names the step it is decorative and hidden from assistive tech; give it a `label` only when it stands alone and it reads as an image of that name. Styled inline so it still draws inside an `ActionMenu`, which portals outside the shadow root. _Key props:_ `steps` (`HexagonTone[]`, in order), `current` (index of the step drawn at full strength), `label`, `className`.
120
122
  - **`TimeBarChart`** — Counts per time bucket as stacked bars on a UTC axis, the request-volume chart above a log list. Every bucket in `range` takes a slot whether or not it has data, so gaps read as gaps; a zone-less time string is read as UTC. Hover or arrow-key through buckets for a tooltip listing every series and the total; `highlightTime` shades the bucket holding a time from elsewhere on the page, such as the hovered log row. With `onRangeSelect`, dragging across bars reports the whole buckets covered, `end` exclusive so it goes straight back in as `range`, and whether the selection takes in the last bucket. `loading` dims bars already drawn rather than replacing them, and shows a spinner only when there is nothing to dim. Series colours follow the theme’s status tokens by `tone`, and failures always stack above successes whatever order `series` comes in, so position separates them where colour alone might not; a legend names them unless `legend={false}`. A visually hidden table carries the same numbers for screen readers. _Key props:_ `series` (`{ key, label, tone }[]`, stacked by tone with `error` on top; `TimeBarChartTone`: `success` | `error` | `neutral`), `buckets` (`{ start, values }[]`), `interval` (`{ unit, step }`; `TimeBarChartUnit`: `minute` | `hour` | `day` | `week` | `month`), `range` (`end` exclusive, as a selection reports it; at most 2,000 buckets, the newest kept), `TimeBarChartSize` (`small` | `medium` | `large`), `loading`, `error`, `errorTitle`, `errorSubTitle`, `valueLabel`, `legend`, `highlightTime`, `onRangeSelect`, `aria-label`, `aria-labelledby`, `className`, `style`.
121
123
  - **`TimeBarChartSwatch`** — The mark a `TimeBarChart` draws a series in, by its `tone`, for naming the series somewhere other than the chart's legend, such as a count beside the chart standing in for it. It matches the legend and the tooltip, and the bars draw the same colour at 40%; it follows the theme with them. Decorative: the label beside it does the naming. _Key props:_ `tone` (`TimeBarChartTone`).
122
124
  - **`Timeline`** — A vertical sequence of steps as an ordered list (`Timeline.Item`): a dot on a connecting line, a title, its timing at the right and a free-form body below, such as what happened to one API call. The dot is painted by `tone` from the theme’s text tokens (`neutral` is secondary text, the rest their status colours), or replaced by a decorative `marker` such as the caller’s logo. `stopped` puts an error badge (`stoppedLabel`, default "Stopped here") after the title of the step a flow ended on and paints its dot `error` unless a `tone` is set; the line ends at the last item. `meta` puts facts about a step in one wrapping row under its title, such as `calls` 2 and `status` 200, each label secondary and its value in the mono face, 18px apart, as a `dl`. `skipped` marks a step that never ran with a grey chevron in place of the dot; the title has to say so. For steps a person works through (complete, open, locked) use `StepList`. _Key props:_ `aria-label`, `aria-labelledby`; on `Timeline.Item`: `title`, `time`, `tone` (`TimelineTone`: `neutral` | `info` | `success` | `warning` | `error`), `marker` (fills the 24px circle in place of the ringed dot), `skipped`, `stopped`, `stoppedLabel`, `meta` (`TimelineMetaEntry[]`: `label`, `value`).
@@ -0,0 +1,36 @@
1
+ import { jsx as e } from "react/jsx-runtime";
2
+ const t = { small: 16, medium: 18 }, c = 0.2, n = {
3
+ neutral: "var(--malachite-text-dimmed, rgb(161, 161, 161))",
4
+ success: "var(--malachite-text-success, rgb(2, 122, 66))",
5
+ caution: "var(--malachite-warning-fill-muted, rgb(227, 196, 143))",
6
+ warning: "var(--malachite-warning-fill, rgb(201, 138, 46))",
7
+ error: "var(--malachite-error-background, rgb(197, 63, 63))"
8
+ }, s = ({
9
+ tone: a = "neutral",
10
+ size: r = "medium",
11
+ dimmed: l = !1,
12
+ className: i
13
+ }) => /* @__PURE__ */ e(
14
+ "svg",
15
+ {
16
+ width: t[r],
17
+ height: t[r],
18
+ viewBox: "0 0 24 24",
19
+ fill: "currentColor",
20
+ "aria-hidden": "true",
21
+ "data-tone": a,
22
+ className: i,
23
+ style: {
24
+ display: "block",
25
+ flexShrink: 0,
26
+ color: n[a],
27
+ opacity: l ? c : 1
28
+ },
29
+ children: /* @__PURE__ */ e("path", { d: "M12 2.5l8.2 4.75v9.5L12 21.5l-8.2-4.75v-9.5z" })
30
+ }
31
+ );
32
+ export {
33
+ s as Hexagon,
34
+ s as default
35
+ };
36
+ //# sourceMappingURL=Hexagon.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Hexagon.js","sources":["../../src/components/Hexagon.tsx"],"sourcesContent":["import type React from 'react';\n\nexport type HexagonTone = 'neutral' | 'success' | 'caution' | 'warning' | 'error';\nexport type HexagonSize = 'small' | 'medium';\n\nexport interface HexagonProps {\n tone?: HexagonTone;\n /** `small` is 16px, `medium` 18px. */\n size?: HexagonSize;\n /** Draws it at 20% strength, for a step of a scale that isn't the current one. */\n dimmed?: boolean;\n className?: string;\n}\n\nconst SIZES: Record<HexagonSize, number> = { small: 16, medium: 18 };\nconst DIMMED_OPACITY = 0.2;\n\n// `error` fills from `error-background`, as TimeBarChart's TONE_FILL does; `text-error` is\n// the brighter text red.\nconst TONE_FILL: Record<HexagonTone, string> = {\n neutral: 'var(--malachite-text-dimmed, rgb(161, 161, 161))',\n success: 'var(--malachite-text-success, rgb(2, 122, 66))',\n caution: 'var(--malachite-warning-fill-muted, rgb(227, 196, 143))',\n warning: 'var(--malachite-warning-fill, rgb(201, 138, 46))',\n error: 'var(--malachite-error-background, rgb(197, 63, 63))',\n};\n\n// Inline, not Tailwind: menus portal outside the shadow root's stylesheet. The fill rides on\n// `color` because the shadow root's `svg path` rule forces paths to `currentColor`.\nexport const Hexagon: React.FC<HexagonProps> = ({\n tone = 'neutral',\n size = 'medium',\n dimmed = false,\n className,\n}) => (\n <svg\n width={SIZES[size]}\n height={SIZES[size]}\n viewBox=\"0 0 24 24\"\n fill=\"currentColor\"\n aria-hidden=\"true\"\n data-tone={tone}\n className={className}\n style={{\n display: 'block',\n flexShrink: 0,\n color: TONE_FILL[tone],\n opacity: dimmed ? DIMMED_OPACITY : 1,\n }}\n >\n <path d=\"M12 2.5l8.2 4.75v9.5L12 21.5l-8.2-4.75v-9.5z\" />\n </svg>\n);\n\nexport default Hexagon;\n"],"names":["SIZES","DIMMED_OPACITY","TONE_FILL","Hexagon","tone","size","dimmed","className","jsx"],"mappings":";AAcA,MAAMA,IAAqC,EAAE,OAAO,IAAI,QAAQ,GAAA,GAC1DC,IAAiB,KAIjBC,IAAyC;AAAA,EAC3C,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,OAAO;AACX,GAIaC,IAAkC,CAAC;AAAA,EAC5C,MAAAC,IAAO;AAAA,EACP,MAAAC,IAAO;AAAA,EACP,QAAAC,IAAS;AAAA,EACT,WAAAC;AACJ,MACI,gBAAAC;AAAA,EAAC;AAAA,EAAA;AAAA,IACG,OAAOR,EAAMK,CAAI;AAAA,IACjB,QAAQL,EAAMK,CAAI;AAAA,IAClB,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,eAAY;AAAA,IACZ,aAAWD;AAAA,IACX,WAAAG;AAAA,IACA,OAAO;AAAA,MACH,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,OAAOL,EAAUE,CAAI;AAAA,MACrB,SAASE,IAASL,IAAiB;AAAA,IAAA;AAAA,IAGvC,UAAA,gBAAAO,EAAC,QAAA,EAAK,GAAE,+CAAA,CAA+C;AAAA,EAAA;AAC3D;"}
@@ -0,0 +1,18 @@
1
+ import { jsx as a } from "react/jsx-runtime";
2
+ import { Hexagon as n } from "./Hexagon.js";
3
+ const d = ({ steps: r, current: o, label: e, className: l }) => /* @__PURE__ */ a(
4
+ "span",
5
+ {
6
+ role: e ? "img" : void 0,
7
+ "aria-label": e,
8
+ "aria-hidden": e ? void 0 : !0,
9
+ className: l,
10
+ style: { display: "inline-flex", flexShrink: 0, alignItems: "center", gap: 2 },
11
+ children: r.map((m, i) => /* @__PURE__ */ a(n, { tone: m, size: "small", dimmed: i !== o }, i))
12
+ }
13
+ );
14
+ export {
15
+ d as HexagonScale,
16
+ d as default
17
+ };
18
+ //# sourceMappingURL=HexagonScale.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"HexagonScale.js","sources":["../../src/components/HexagonScale.tsx"],"sourcesContent":["import type React from 'react';\nimport Hexagon, { type HexagonTone } from './Hexagon';\n\nexport interface HexagonScaleProps {\n /** One hexagon per step, in order. */\n steps: readonly HexagonTone[];\n /** Index of the step drawn at full strength; the rest are dimmed. Omit to dim them all. */\n current?: number;\n /** Only when it stands alone; beside text naming the step it is decorative. */\n label?: string;\n className?: string;\n}\n\n// Inline, not Tailwind: menus portal outside the shadow root's stylesheet.\nexport const HexagonScale: React.FC<HexagonScaleProps> = ({ steps, current, label, className }) => (\n <span\n role={label ? 'img' : undefined}\n aria-label={label}\n aria-hidden={label ? undefined : true}\n className={className}\n style={{ display: 'inline-flex', flexShrink: 0, alignItems: 'center', gap: 2 }}\n >\n {steps.map((tone, index) => (\n <Hexagon key={index} tone={tone} size=\"small\" dimmed={index !== current} />\n ))}\n </span>\n);\n\nexport default HexagonScale;\n"],"names":["HexagonScale","steps","current","label","className","jsx","tone","index","Hexagon"],"mappings":";;AAcO,MAAMA,IAA4C,CAAC,EAAE,OAAAC,GAAO,SAAAC,GAAS,OAAAC,GAAO,WAAAC,QAC/E,gBAAAC;AAAA,EAAC;AAAA,EAAA;AAAA,IACG,MAAMF,IAAQ,QAAQ;AAAA,IACtB,cAAYA;AAAA,IACZ,eAAaA,IAAQ,SAAY;AAAA,IACjC,WAAAC;AAAA,IACA,OAAO,EAAE,SAAS,eAAe,YAAY,GAAG,YAAY,UAAU,KAAK,EAAA;AAAA,IAE1E,UAAAH,EAAM,IAAI,CAACK,GAAMC,MACd,gBAAAF,EAACG,GAAA,EAAoB,MAAAF,GAAY,MAAK,SAAQ,QAAQC,MAAUL,EAAA,GAAlDK,CAA2D,CAC5E;AAAA,EAAA;AACL;"}
@@ -1 +1 @@
1
- {"version":3,"file":"LinkCard.js","sources":["../../src/components/LinkCard.tsx"],"sourcesContent":["import type React from 'react';\nimport ForwardArrowIcon from './CustomIcons/ForwardArrowIcon';\nimport EllipsisText from './Typography/EllipsisText';\nimport Text from './Typography/Text';\nimport { devWarning } from './devWarning';\nimport { FOCUS_RING } from './focusRing';\nimport { isRenderableNode } from './renderableNode';\nimport { safeHref } from './safeHref';\n\nexport type LinkCardTone = 'neutral' | 'success' | 'warning' | 'error';\n\nexport interface LinkCardProps {\n title: string;\n /** One line under the title; truncated text shows in full on hover. */\n description?: string;\n /** Colours the title. */\n tone?: LinkCardTone;\n /** Decorative, before the title. Coloured paths need `data-malachite-shape`. */\n icon?: React.ReactNode;\n /** Decorative content before the action, e.g. a level scale. Must not be interactive. */\n trailing?: React.ReactNode;\n actionLabel?: string;\n onClick?: (event: React.MouseEvent<HTMLElement>) => void;\n /** Renders a link instead of a button; unsafe schemes are dropped. */\n href?: string;\n className?: string;\n}\n\nconst TITLE_COLOR = {\n neutral: 'primary',\n success: 'success',\n warning: 'warning',\n error: 'error',\n} as const;\n\nconst CARD_CLASSES =\n 'flex w-full items-center gap-[12px] rounded-[var(--malachite-radius-10,10px)] border border-solid border-[var(--malachite-card-border,rgb(232,232,232))] bg-[var(--malachite-card-background,rgb(255,255,255))] px-[12px] py-[10px] text-start text-[var(--malachite-text-primary,rgb(10,10,10))] no-underline';\n\nconst INTERACTIVE_CLASSES = `cursor-pointer transition-colors hover:border-[var(--malachite-secondary-border-hover,rgb(186,186,186))] hover:bg-[var(--malachite-buttonlist-hover-background,rgb(245,245,245))] ${FOCUS_RING}`;\n\n/** A compact card that opens more detail elsewhere, such as another tab of a panel. */\nconst LinkCard: React.FC<LinkCardProps> = ({\n title,\n description,\n tone = 'neutral',\n icon,\n trailing,\n actionLabel = 'Open',\n onClick,\n href: rawHref,\n className = '',\n}) => {\n const href = safeHref(rawHref);\n if (rawHref && !href) {\n devWarning(\n `LinkCard.href:${rawHref}`,\n `LinkCard dropped the unsafe href \"${rawHref}\"; without an onClick it is a static card.`,\n );\n }\n const interactive = Boolean(href || onClick);\n const body = (\n <>\n {isRenderableNode(icon) && (\n <span aria-hidden=\"true\" className=\"flex flex-none items-center\">\n {icon}\n </span>\n )}\n <span className=\"flex min-w-0 flex-1 flex-col gap-[1px] leading-[15px]\">\n <Text\n size=\"small\"\n fontWeight=\"bold\"\n color={TITLE_COLOR[tone]}\n className=\"leading-[17px]\"\n >\n {title}\n </Text>\n {description && (\n <EllipsisText\n size=\"xsmall\"\n color=\"secondary\"\n tooltip={description}\n tooltipWhenTruncated\n inline\n >\n {description}\n </EllipsisText>\n )}\n </span>\n {isRenderableNode(trailing) && (\n <span aria-hidden=\"true\" className=\"flex flex-none items-center\">\n {trailing}\n </span>\n )}\n {interactive && (\n <span className=\"flex flex-none items-center gap-[3px] text-[var(--malachite-accent-foreground,rgb(2,122,66))]\">\n <Text size=\"xsmall\" fontWeight=\"semi-bold\" color=\"inherit\" wrap={false}>\n {actionLabel}\n </Text>\n <span aria-hidden=\"true\" className=\"flex\">\n <ForwardArrowIcon size={12} />\n </span>\n </span>\n )}\n </>\n );\n if (href) {\n return (\n <a\n href={href}\n onClick={onClick}\n className={`${CARD_CLASSES} ${INTERACTIVE_CLASSES} ${className}`}\n >\n {body}\n </a>\n );\n }\n if (onClick) {\n return (\n <button\n type=\"button\"\n onClick={onClick}\n className={`m-0 appearance-none font-[inherit] ${CARD_CLASSES} ${INTERACTIVE_CLASSES} ${className}`}\n >\n {body}\n </button>\n );\n }\n return <div className={`${CARD_CLASSES} ${className}`}>{body}</div>;\n};\n\nexport default LinkCard;\nexport { LinkCard };\n"],"names":["TITLE_COLOR","CARD_CLASSES","INTERACTIVE_CLASSES","FOCUS_RING","LinkCard","title","description","tone","icon","trailing","actionLabel","onClick","rawHref","className","href","safeHref","devWarning","interactive","body","jsxs","Fragment","isRenderableNode","jsx","Text","EllipsisText","ForwardArrowIcon"],"mappings":";;;;;;;;AA4BA,MAAMA,IAAc;AAAA,EAChB,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,OAAO;AACX,GAEMC,IACF,kTAEEC,IAAsB,qLAAqLC,CAAU,IAGrNC,IAAoC,CAAC;AAAA,EACvC,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA,MAAAC,IAAO;AAAA,EACP,MAAAC;AAAA,EACA,UAAAC;AAAA,EACA,aAAAC,IAAc;AAAA,EACd,SAAAC;AAAA,EACA,MAAMC;AAAA,EACN,WAAAC,IAAY;AAChB,MAAM;AACF,QAAMC,IAAOC,EAASH,CAAO;AAC7B,EAAIA,KAAW,CAACE,KACZE;AAAA,IACI,iBAAiBJ,CAAO;AAAA,IACxB,qCAAqCA,CAAO;AAAA,EAAA;AAGpD,QAAMK,IAAc,GAAQH,KAAQH,IAC9BO,IACF,gBAAAC,EAAAC,GAAA,EACK,UAAA;AAAA,IAAAC,EAAiBb,CAAI,KAClB,gBAAAc,EAAC,QAAA,EAAK,eAAY,QAAO,WAAU,+BAC9B,UAAAd,EAAA,CACL;AAAA,IAEJ,gBAAAW,EAAC,QAAA,EAAK,WAAU,yDACZ,UAAA;AAAA,MAAA,gBAAAG;AAAA,QAACC;AAAA,QAAA;AAAA,UACG,MAAK;AAAA,UACL,YAAW;AAAA,UACX,OAAOvB,EAAYO,CAAI;AAAA,UACvB,WAAU;AAAA,UAET,UAAAF;AAAA,QAAA;AAAA,MAAA;AAAA,MAEJC,KACG,gBAAAgB;AAAA,QAACE;AAAA,QAAA;AAAA,UACG,MAAK;AAAA,UACL,OAAM;AAAA,UACN,SAASlB;AAAA,UACT,sBAAoB;AAAA,UACpB,QAAM;AAAA,UAEL,UAAAA;AAAA,QAAA;AAAA,MAAA;AAAA,IACL,GAER;AAAA,IACCe,EAAiBZ,CAAQ,KACtB,gBAAAa,EAAC,UAAK,eAAY,QAAO,WAAU,+BAC9B,UAAAb,EAAA,CACL;AAAA,IAEHQ,KACG,gBAAAE,EAAC,QAAA,EAAK,WAAU,iGACZ,UAAA;AAAA,MAAA,gBAAAG,EAACC,GAAA,EAAK,MAAK,UAAS,YAAW,aAAY,OAAM,WAAU,MAAM,IAC5D,UAAAb,EAAA,CACL;AAAA,MACA,gBAAAY,EAAC,QAAA,EAAK,eAAY,QAAO,WAAU,QAC/B,UAAA,gBAAAA,EAACG,GAAA,EAAiB,MAAM,GAAA,CAAI,EAAA,CAChC;AAAA,IAAA,EAAA,CACJ;AAAA,EAAA,GAER;AAEJ,SAAIX,IAEI,gBAAAQ;AAAA,IAAC;AAAA,IAAA;AAAA,MACG,MAAAR;AAAA,MACA,SAAAH;AAAA,MACA,WAAW,GAAGV,CAAY,IAAIC,CAAmB,IAAIW,CAAS;AAAA,MAE7D,UAAAK;AAAA,IAAA;AAAA,EAAA,IAITP,IAEI,gBAAAW;AAAA,IAAC;AAAA,IAAA;AAAA,MACG,MAAK;AAAA,MACL,SAAAX;AAAA,MACA,WAAW,sCAAsCV,CAAY,IAAIC,CAAmB,IAAIW,CAAS;AAAA,MAEhG,UAAAK;AAAA,IAAA;AAAA,EAAA,IAIN,gBAAAI,EAAC,SAAI,WAAW,GAAGrB,CAAY,IAAIY,CAAS,IAAK,UAAAK,EAAA,CAAK;AACjE;"}
1
+ {"version":3,"file":"LinkCard.js","sources":["../../src/components/LinkCard.tsx"],"sourcesContent":["import type React from 'react';\nimport ForwardArrowIcon from './CustomIcons/ForwardArrowIcon';\nimport EllipsisText from './Typography/EllipsisText';\nimport Text from './Typography/Text';\nimport { devWarning } from './devWarning';\nimport { FOCUS_RING } from './focusRing';\nimport { isRenderableNode } from './renderableNode';\nimport { safeHref } from './safeHref';\n\nexport type LinkCardTone = 'neutral' | 'success' | 'warning' | 'error';\n\nexport interface LinkCardProps {\n title: string;\n /** One line under the title; truncated text shows in full on hover. */\n description?: string;\n /** Colours the title. */\n tone?: LinkCardTone;\n /**\n * Decorative, before the title. Paths are filled with `currentColor`, so colour one through\n * `color`, as `Hexagon` does; a path keeping its own `fill` needs `data-malachite-shape`.\n */\n icon?: React.ReactNode;\n /** Decorative content before the action, e.g. a level scale. Must not be interactive. */\n trailing?: React.ReactNode;\n actionLabel?: string;\n onClick?: (event: React.MouseEvent<HTMLElement>) => void;\n /** Renders a link instead of a button; unsafe schemes are dropped. */\n href?: string;\n className?: string;\n}\n\nconst TITLE_COLOR = {\n neutral: 'primary',\n success: 'success',\n warning: 'warning',\n error: 'error',\n} as const;\n\nconst CARD_CLASSES =\n 'flex w-full items-center gap-[12px] rounded-[var(--malachite-radius-10,10px)] border border-solid border-[var(--malachite-card-border,rgb(232,232,232))] bg-[var(--malachite-card-background,rgb(255,255,255))] px-[12px] py-[10px] text-start text-[var(--malachite-text-primary,rgb(10,10,10))] no-underline';\n\nconst INTERACTIVE_CLASSES = `cursor-pointer transition-colors hover:border-[var(--malachite-secondary-border-hover,rgb(186,186,186))] hover:bg-[var(--malachite-buttonlist-hover-background,rgb(245,245,245))] ${FOCUS_RING}`;\n\n/** A compact card that opens more detail elsewhere, such as another tab of a panel. */\nconst LinkCard: React.FC<LinkCardProps> = ({\n title,\n description,\n tone = 'neutral',\n icon,\n trailing,\n actionLabel = 'Open',\n onClick,\n href: rawHref,\n className = '',\n}) => {\n const href = safeHref(rawHref);\n if (rawHref && !href) {\n devWarning(\n `LinkCard.href:${rawHref}`,\n `LinkCard dropped the unsafe href \"${rawHref}\"; without an onClick it is a static card.`,\n );\n }\n const interactive = Boolean(href || onClick);\n const body = (\n <>\n {isRenderableNode(icon) && (\n <span aria-hidden=\"true\" className=\"flex flex-none items-center\">\n {icon}\n </span>\n )}\n <span className=\"flex min-w-0 flex-1 flex-col gap-[1px] leading-[15px]\">\n <Text\n size=\"small\"\n fontWeight=\"bold\"\n color={TITLE_COLOR[tone]}\n className=\"leading-[17px]\"\n >\n {title}\n </Text>\n {description && (\n <EllipsisText\n size=\"xsmall\"\n color=\"secondary\"\n tooltip={description}\n tooltipWhenTruncated\n inline\n >\n {description}\n </EllipsisText>\n )}\n </span>\n {isRenderableNode(trailing) && (\n <span aria-hidden=\"true\" className=\"flex flex-none items-center\">\n {trailing}\n </span>\n )}\n {interactive && (\n <span className=\"flex flex-none items-center gap-[3px] text-[var(--malachite-accent-foreground,rgb(2,122,66))]\">\n <Text size=\"xsmall\" fontWeight=\"semi-bold\" color=\"inherit\" wrap={false}>\n {actionLabel}\n </Text>\n <span aria-hidden=\"true\" className=\"flex\">\n <ForwardArrowIcon size={12} />\n </span>\n </span>\n )}\n </>\n );\n if (href) {\n return (\n <a\n href={href}\n onClick={onClick}\n className={`${CARD_CLASSES} ${INTERACTIVE_CLASSES} ${className}`}\n >\n {body}\n </a>\n );\n }\n if (onClick) {\n return (\n <button\n type=\"button\"\n onClick={onClick}\n className={`m-0 appearance-none font-[inherit] ${CARD_CLASSES} ${INTERACTIVE_CLASSES} ${className}`}\n >\n {body}\n </button>\n );\n }\n return <div className={`${CARD_CLASSES} ${className}`}>{body}</div>;\n};\n\nexport default LinkCard;\nexport { LinkCard };\n"],"names":["TITLE_COLOR","CARD_CLASSES","INTERACTIVE_CLASSES","FOCUS_RING","LinkCard","title","description","tone","icon","trailing","actionLabel","onClick","rawHref","className","href","safeHref","devWarning","interactive","body","jsxs","Fragment","isRenderableNode","jsx","Text","EllipsisText","ForwardArrowIcon"],"mappings":";;;;;;;;AA+BA,MAAMA,IAAc;AAAA,EAChB,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,OAAO;AACX,GAEMC,IACF,kTAEEC,IAAsB,qLAAqLC,CAAU,IAGrNC,IAAoC,CAAC;AAAA,EACvC,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA,MAAAC,IAAO;AAAA,EACP,MAAAC;AAAA,EACA,UAAAC;AAAA,EACA,aAAAC,IAAc;AAAA,EACd,SAAAC;AAAA,EACA,MAAMC;AAAA,EACN,WAAAC,IAAY;AAChB,MAAM;AACF,QAAMC,IAAOC,EAASH,CAAO;AAC7B,EAAIA,KAAW,CAACE,KACZE;AAAA,IACI,iBAAiBJ,CAAO;AAAA,IACxB,qCAAqCA,CAAO;AAAA,EAAA;AAGpD,QAAMK,IAAc,GAAQH,KAAQH,IAC9BO,IACF,gBAAAC,EAAAC,GAAA,EACK,UAAA;AAAA,IAAAC,EAAiBb,CAAI,KAClB,gBAAAc,EAAC,QAAA,EAAK,eAAY,QAAO,WAAU,+BAC9B,UAAAd,EAAA,CACL;AAAA,IAEJ,gBAAAW,EAAC,QAAA,EAAK,WAAU,yDACZ,UAAA;AAAA,MAAA,gBAAAG;AAAA,QAACC;AAAA,QAAA;AAAA,UACG,MAAK;AAAA,UACL,YAAW;AAAA,UACX,OAAOvB,EAAYO,CAAI;AAAA,UACvB,WAAU;AAAA,UAET,UAAAF;AAAA,QAAA;AAAA,MAAA;AAAA,MAEJC,KACG,gBAAAgB;AAAA,QAACE;AAAA,QAAA;AAAA,UACG,MAAK;AAAA,UACL,OAAM;AAAA,UACN,SAASlB;AAAA,UACT,sBAAoB;AAAA,UACpB,QAAM;AAAA,UAEL,UAAAA;AAAA,QAAA;AAAA,MAAA;AAAA,IACL,GAER;AAAA,IACCe,EAAiBZ,CAAQ,KACtB,gBAAAa,EAAC,UAAK,eAAY,QAAO,WAAU,+BAC9B,UAAAb,EAAA,CACL;AAAA,IAEHQ,KACG,gBAAAE,EAAC,QAAA,EAAK,WAAU,iGACZ,UAAA;AAAA,MAAA,gBAAAG,EAACC,GAAA,EAAK,MAAK,UAAS,YAAW,aAAY,OAAM,WAAU,MAAM,IAC5D,UAAAb,EAAA,CACL;AAAA,MACA,gBAAAY,EAAC,QAAA,EAAK,eAAY,QAAO,WAAU,QAC/B,UAAA,gBAAAA,EAACG,GAAA,EAAiB,MAAM,GAAA,CAAI,EAAA,CAChC;AAAA,IAAA,EAAA,CACJ;AAAA,EAAA,GAER;AAEJ,SAAIX,IAEI,gBAAAQ;AAAA,IAAC;AAAA,IAAA;AAAA,MACG,MAAAR;AAAA,MACA,SAAAH;AAAA,MACA,WAAW,GAAGV,CAAY,IAAIC,CAAmB,IAAIW,CAAS;AAAA,MAE7D,UAAAK;AAAA,IAAA;AAAA,EAAA,IAITP,IAEI,gBAAAW;AAAA,IAAC;AAAA,IAAA;AAAA,MACG,MAAK;AAAA,MACL,SAAAX;AAAA,MACA,WAAW,sCAAsCV,CAAY,IAAIC,CAAmB,IAAIW,CAAS;AAAA,MAEhG,UAAAK;AAAA,IAAA;AAAA,EAAA,IAIN,gBAAAI,EAAC,SAAI,WAAW,GAAGrB,CAAY,IAAIY,CAAS,IAAK,UAAAK,EAAA,CAAK;AACjE;"}
package/dist/index.d.ts CHANGED
@@ -2293,6 +2293,33 @@ export declare interface GroupedStepperProps extends StepperBaseProps {
2293
2293
  steps?: never;
2294
2294
  }
2295
2295
 
2296
+ export declare const Hexagon: default_2.FC<HexagonProps>;
2297
+
2298
+ export declare interface HexagonProps {
2299
+ tone?: HexagonTone;
2300
+ /** `small` is 16px, `medium` 18px. */
2301
+ size?: HexagonSize;
2302
+ /** Draws it at 20% strength, for a step of a scale that isn't the current one. */
2303
+ dimmed?: boolean;
2304
+ className?: string;
2305
+ }
2306
+
2307
+ export declare const HexagonScale: default_2.FC<HexagonScaleProps>;
2308
+
2309
+ export declare interface HexagonScaleProps {
2310
+ /** One hexagon per step, in order. */
2311
+ steps: readonly HexagonTone[];
2312
+ /** Index of the step drawn at full strength; the rest are dimmed. Omit to dim them all. */
2313
+ current?: number;
2314
+ /** Only when it stands alone; beside text naming the step it is decorative. */
2315
+ label?: string;
2316
+ className?: string;
2317
+ }
2318
+
2319
+ export declare type HexagonSize = 'small' | 'medium';
2320
+
2321
+ export declare type HexagonTone = 'neutral' | 'success' | 'caution' | 'warning' | 'error';
2322
+
2296
2323
  export declare const IconBadge: default_2.FC<IconBadgeProps>;
2297
2324
 
2298
2325
  export declare interface IconBadgeProps {
@@ -3377,7 +3404,10 @@ export declare interface LinkCardProps {
3377
3404
  description?: string;
3378
3405
  /** Colours the title. */
3379
3406
  tone?: LinkCardTone;
3380
- /** Decorative, before the title. Coloured paths need `data-malachite-shape`. */
3407
+ /**
3408
+ * Decorative, before the title. Paths are filled with `currentColor`, so colour one through
3409
+ * `color`, as `Hexagon` does; a path keeping its own `fill` needs `data-malachite-shape`.
3410
+ */
3381
3411
  icon?: default_2.ReactNode;
3382
3412
  /** Decorative content before the action, e.g. a level scale. Must not be interactive. */
3383
3413
  trailing?: default_2.ReactNode;
@@ -3649,6 +3679,10 @@ export declare interface MalachiteTheme {
3649
3679
  backgroundGlass: string;
3650
3680
  shadowLight: string;
3651
3681
  shadowMedium: string;
3682
+ /** Solid amber for a status shape, a step deeper than `fillMuted`. */
3683
+ fill: string;
3684
+ /** Pale amber for a milder status shape than `fill`. */
3685
+ fillMuted: string;
3652
3686
  };
3653
3687
  error: {
3654
3688
  background: string;