@galaxy-io/dls 2.5.1 → 2.6.0

package/dist/beacons/Beacon.d.ts

@@ -13,7 +13,7 @@ export declare enum BeaconSize {
     /** 10px, beside `body_lg` (20px line); a label is `body_lg` with an 8px gap. */
     X_LARGE = "X_LARGE"
 }
-/** Dot color role (Constitution V-A color set). Neutral steps resolve to `color.text.*`; statuses fill with `color.solid.<status>.background` and label with `color.text.<status>`. */
+/** Dot color role (Constitution V-A color set). Neutral steps resolve to `color.text.*`; statuses fill with `color.mark.<status>` and label with `color.text.<status>`. */
 export declare enum BeaconVariant {
     /** `text.primary`. The default (1.x `BASE` / `PRIMARY`). */
     PRIMARY = "PRIMARY",
@@ -25,11 +25,11 @@ export declare enum BeaconVariant {
     DISABLED = "DISABLED",
     /** The parent's color (`currentColor`). */
     INHERIT = "INHERIT",
-    /** Status: success. Dot `solid.success.background`, label `text.success`. */
+    /** Status: success. Dot `mark.success`, label `text.success`. */
     SUCCESS = "SUCCESS",
-    /** Status: warning. Dot `solid.warning.background`, label `text.warning`. */
+    /** Status: warning. Dot `mark.warning`, label `text.warning`. */
     WARNING = "WARNING",
-    /** Status: error. Dot `solid.error.background`, label `text.error`. */
+    /** Status: error. Dot `mark.error`, label `text.error`. */
     ERROR = "ERROR"
 }
 interface BeaconBaseProps extends AriaAttributes {
@@ -73,7 +73,12 @@ interface BeaconVariantProps {
      * @default BeaconVariant.PRIMARY
      */
     variant?: BeaconVariant;
-    /** Categorical palette family. Not with `variant`. */
+    /**
+     * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
+     * (`"success"`, `"error"`): the dot and ring take `mark.<name>` and the label
+     * `text.<name>`, the way a status variant renders. For categories and data-driven marks; a status
+     * that is meaning takes `variant`. Not with `variant`.
+     */
     color?: undefined;
 }
 /** A dot colored by category (`color`). */
@@ -86,7 +91,7 @@ interface BeaconColorProps {
     variant?: undefined;
     /**
      * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
-     * (`"success"`, `"error"`): the dot and ring take `solid.<name>.background` and the label
+     * (`"success"`, `"error"`): the dot and ring take `mark.<name>` and the label
      * `text.<name>`, the way a status variant renders. For categories and data-driven marks; a status
      * that is meaning takes `variant`. Not with `variant`.
      */

package/dist/beacons/Beacon.js

@@ -19,12 +19,13 @@ import { cx } from "@linaria/core";
 *
 * Color is CSS, not JS: `BEACON_VARIANT_TO_CSS_MAP` (or `BEACON_COLOR_TO_CSS_MAP` for a categorical
 * `color`) sets `color` from `color.text.*` for the label and `--gx-beacon-fill` from
-* `color.solid.*.background` for the dot and its ring. A small solid fill is not text: the `text`
-* roles are tuned for 4.5:1 copy on the canvas, which in Light makes a dark, muddy dot, while the
-* `solid` fills are the strong, mode-stable fills the Button and Chip draw. The neutral steps have
-* no solid fill, so they and `INHERIT` fill with `currentColor` (the Icon and Circle pattern); a
-* theme switch needs no re-render. `hex` is set as the `--gx-beacon-hex` custom property in
-* `style` and read by a block, switched on only when the prop is set, that routes it to both.
+* `color.mark.*` for the dot and its ring. A small solid fill is not text: the `text` roles are
+* tuned for 4.5:1 copy on the canvas, which in Light makes a dark, muddy dot, while `mark` is the
+* vivid fill every chart, `Square` and `Circle` draws, so one status reads as one color everywhere.
+* The neutral steps have no mark, so they and `INHERIT` fill with `currentColor` (the Icon and
+* Circle pattern); a theme switch needs no re-render. `hex` is set as the `--gx-beacon-hex` custom
+* property in `style` and read by a block, switched on only when the prop is set, that routes it to
+* both.
 *
 * `isPulse` repeats an expanding ring (the root's `::after`, in the dot's own color) to say "this is
 * happening now". It stops under `prefers-reduced-motion` and `GalaxyProvider reducedMotion`. Not a
@@ -45,7 +46,7 @@ var BeaconSize = /* @__PURE__ */ function(BeaconSize) {
 	BeaconSize["X_LARGE"] = "X_LARGE";
 	return BeaconSize;
 }({});
-/** Dot color role (Constitution V-A color set). Neutral steps resolve to `color.text.*`; statuses fill with `color.solid.<status>.background` and label with `color.text.<status>`. */
+/** Dot color role (Constitution V-A color set). Neutral steps resolve to `color.text.*`; statuses fill with `color.mark.<status>` and label with `color.text.<status>`. */
 var BeaconVariant = /* @__PURE__ */ function(BeaconVariant) {
 	/** `text.primary`. The default (1.x `BASE` / `PRIMARY`). */
 	BeaconVariant["PRIMARY"] = "PRIMARY";
@@ -57,17 +58,17 @@ var BeaconVariant = /* @__PURE__ */ function(BeaconVariant) {
 	BeaconVariant["DISABLED"] = "DISABLED";
 	/** The parent's color (`currentColor`). */
 	BeaconVariant["INHERIT"] = "INHERIT";
-	/** Status: success. Dot `solid.success.background`, label `text.success`. */
+	/** Status: success. Dot `mark.success`, label `text.success`. */
 	BeaconVariant["SUCCESS"] = "SUCCESS";
-	/** Status: warning. Dot `solid.warning.background`, label `text.warning`. */
+	/** Status: warning. Dot `mark.warning`, label `text.warning`. */
 	BeaconVariant["WARNING"] = "WARNING";
-	/** Status: error. Dot `solid.error.background`, label `text.error`. */
+	/** Status: error. Dot `mark.error`, label `text.error`. */
 	BeaconVariant["ERROR"] = "ERROR";
 	return BeaconVariant;
 }({});
 /**
 * The root is the dot: phrasing content, so it is valid inside `Text`, a `<button>` or a `<label>`.
-* The fill is `--gx-beacon-fill` (a `solid` fill for a status or family), falling back to
+* The fill is `--gx-beacon-fill` (the `mark` of a status or family), falling back to
 * `currentColor` for the neutral steps and `INHERIT`; `forced-color-adjust: none` keeps it visible
 * in high contrast. The pulse ring is `::after`, invisible at rest, in the same fill.
 */
@@ -123,7 +124,7 @@ var BEACON_VARIANT_TO_CSS_MAP = {
 	["WARNING"]: "gx-Beacon-WARNING-w1d27vzd",
 	["ERROR"]: "gx-Beacon-ERROR-eshtlvu"
 };
-/** Categorical `color`: the label `text.<family>`, the dot `solid.<family>.background`, the way a status variant renders. */
+/** Categorical `color`: the label `text.<family>`, the dot `mark.<family>`, the way a status variant renders. */
 var BEACON_COLOR_TO_CSS_MAP = {
 	success: "gx-Beacon-success-s1nxs4in",
 	warning: "gx-Beacon-warning-w1dc3rbq",

package/dist/charts/ChartLegend.js

@@ -100,7 +100,7 @@ var OverflowList = /*#__PURE__*/ styled("ul")({
 });
 function Swatch({ item, swatch }) {
 	return /* @__PURE__ */ jsx(SwatchColor, {
-		style: { "--gx-chart-mark-color": item.hex ?? (item.hue !== void 0 ? t.color.text[item.hue] : CHART_PALETTE_TO_COLOR_MAP[item.palette ?? ChartPalette.TERTIARY]) },
+		style: { "--gx-chart-mark-color": item.hex ?? (item.hue !== void 0 ? t.color.mark[item.hue] : CHART_PALETTE_TO_COLOR_MAP[item.palette ?? ChartPalette.TERTIARY]) },
 		children: swatch === ChartSwatch.CIRCLE ? /* @__PURE__ */ jsx(Circle, {
 			size: CircleSize.SMALL,
 			variant: CircleVariant.INHERIT

package/dist/charts/Sparkline.d.ts

@@ -24,11 +24,11 @@ export declare enum SparklineVariant {
     TERTIARY = "TERTIARY",
     /** The parent's color (`currentColor`). */
     INHERIT = "INHERIT",
-    /** Status: success, `text.success`. */
+    /** Status: success, `mark.success`. */
     SUCCESS = "SUCCESS",
-    /** Status: warning, `text.warning`. */
+    /** Status: warning, `mark.warning`. */
     WARNING = "WARNING",
-    /** Status: error, `text.error`. */
+    /** Status: error, `mark.error`. */
     ERROR = "ERROR"
 }
 /** What the data is drawn as. A named second axis (Article V), not a variant. */
@@ -82,7 +82,12 @@ interface SparklineVariantProps {
      * @default SparklineVariant.SECONDARY
      */
     variant?: SparklineVariant;
-    /** Categorical palette family. Not with `variant`. */
+    /**
+     * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
+     * (`"success"`, `"error"`): the marks take `mark.<name>`, the way a status variant renders. For
+     * a series' category or data-driven color; a status that is meaning takes `variant`. Not with
+     * `variant`.
+     */
     color?: undefined;
 }
 /** A sparkline colored by category (`color`). */
@@ -95,7 +100,7 @@ interface SparklineColorProps {
     variant?: undefined;
     /**
      * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
-     * (`"success"`, `"error"`): the marks take `text.<name>`, the way a status variant renders. For
+     * (`"success"`, `"error"`): the marks take `mark.<name>`, the way a status variant renders. For
      * a series' category or data-driven color; a status that is meaning takes `variant`. Not with
      * `variant`.
      */

package/dist/charts/Sparkline.js

@@ -14,10 +14,10 @@ import { cx } from "@linaria/core";
 * `LineChart` / `BarChart`.
 *
 * Color is CSS: `SPARKLINE_VARIANT_TO_CSS_MAP` (or `SPARKLINE_COLOR_TO_CSS_MAP` for a categorical
-* `color`) sets `color` from `color.text.*` and the marks read
-* `currentColor`, so `INHERIT` and `hex` share one path and a theme switch needs no re-render.
-* Height is a control rung so it lines up with its row; width is four times
-* the height unless `fillWidth`.
+* `color`) sets `color` from `color.text.*` (the neutral steps) or `color.mark.*` (statuses and
+* families), and the marks read `currentColor`, so `INHERIT` and `hex` share one path and a theme
+* switch needs no re-render. Height is a control rung so it lines up with its row; width is four
+* times the height unless `fillWidth`.
 *
 * Drawn in a fixed `0 0 100 100` viewBox with `preserveAspectRatio="none"` and a non-scaling
 * stroke: no measurement, identical under SSR. Reuses LineChart's curve and the 1.x bar spacing.
@@ -47,11 +47,11 @@ var SparklineVariant = /* @__PURE__ */ function(SparklineVariant) {
 	SparklineVariant["TERTIARY"] = "TERTIARY";
 	/** The parent's color (`currentColor`). */
 	SparklineVariant["INHERIT"] = "INHERIT";
-	/** Status: success, `text.success`. */
+	/** Status: success, `mark.success`. */
 	SparklineVariant["SUCCESS"] = "SUCCESS";
-	/** Status: warning, `text.warning`. */
+	/** Status: warning, `mark.warning`. */
 	SparklineVariant["WARNING"] = "WARNING";
-	/** Status: error, `text.error`. */
+	/** Status: error, `mark.error`. */
 	SparklineVariant["ERROR"] = "ERROR";
 	return SparklineVariant;
 }({});
@@ -110,7 +110,7 @@ var SPARKLINE_VARIANT_TO_CSS_MAP = {
 	["WARNING"]: "gx-Sparkline-WARNING-w12wppjx",
 	["ERROR"]: "gx-Sparkline-ERROR-e1vjlz3y"
 };
-/** Categorical `color`: `text.<family>`, the way a status variant renders. */
+/** Categorical `color`: `mark.<family>`, the way a status variant renders. */
 var SPARKLINE_COLOR_TO_CSS_MAP = {
 	success: "gx-Sparkline-success-s1g1xl1p",
 	warning: "gx-Sparkline-warning-w1jau8rz",

package/dist/charts/chartPalette.d.ts

@@ -16,7 +16,7 @@ export declare const isChartPalette: (value: ChartPalette | RoleColor) => value
  * `violet`.
  */
 export declare const CHART_PALETTE_TO_HUE_MAP: Record<ChartPalette, ChartHue>;
-/** @internal Palette slot → the CSS color of its marks: the family's `text.<family>` (text and icons). */
+/** @internal Palette slot → the CSS color of its marks: the family's `mark.<family>`. */
 export declare const CHART_PALETTE_TO_COLOR_MAP: Record<ChartPalette, string>;
 /** @internal The color of a mark that names no series (PieChart's folded "Other" bucket): `cyan`, never gray. */
 export declare const CHART_NEUTRAL_COLOR: string;

package/dist/charts/chartPalette.js

@@ -2,10 +2,10 @@ import { t } from "../theme/tokens/t.js";
 import { ChartPalette } from "./types.js";
 //#region src/charts/chartPalette.ts
 /**
-* @internal Series colors. A palette slot maps to a `t.color.text.<family>` string (`var(--gx-…)`),
+* @internal Series colors. A palette slot maps to a `t.color.mark.<family>` string (`var(--gx-…)`),
 * so a theme switch repaints marks through CSS with no React render. Imports only `t` and types:
 * no component, no d3.
-* Apps that want a slot's color in their own CSS use `t.color.text.<family>`.
+* Apps that want a slot's color in their own CSS use `t.color.mark.<family>`.
 */
 /**
 * @internal Automatic assignment order: the eight hues, purple first. Status slots never join it
@@ -45,10 +45,10 @@ var CHART_PALETTE_TO_HUE_MAP = {
 	[ChartPalette.SECONDARY]: "sky",
 	[ChartPalette.TERTIARY]: "violet"
 };
-/** @internal Palette slot → the CSS color of its marks: the family's `text.<family>` (text and icons). */
-var CHART_PALETTE_TO_COLOR_MAP = Object.fromEntries(Object.values(ChartPalette).map((palette) => [palette, t.color.text[CHART_PALETTE_TO_HUE_MAP[palette]]]));
+/** @internal Palette slot → the CSS color of its marks: the family's `mark.<family>`. */
+var CHART_PALETTE_TO_COLOR_MAP = Object.fromEntries(Object.values(ChartPalette).map((palette) => [palette, t.color.mark[CHART_PALETTE_TO_HUE_MAP[palette]]]));
 /** @internal The color of a mark that names no series (PieChart's folded "Other" bucket): `cyan`, never gray. */
-var CHART_NEUTRAL_COLOR = t.color.text.cyan;
+var CHART_NEUTRAL_COLOR = t.color.mark.cyan;
 /** @internal The slot at a position in the automatic order (wraps after eight). */
 function chartPaletteAt(index) {
 	const order = CHART_PALETTE_ORDER;
@@ -61,7 +61,7 @@ function resolveChartSeriesColor(index, explicit, hex) {
 		hex
 	};
 	if (explicit !== void 0 && !isChartPalette(explicit)) return {
-		color: t.color.text[explicit],
+		color: t.color.mark[explicit],
 		hue: explicit
 	};
 	const palette = explicit ?? chartPaletteAt(index);

package/dist/chips/Chip.d.ts

@@ -119,20 +119,11 @@ export interface ChipBaseProps extends AriaAttributes {
     style?: CSSProperties;
 }
 /** A chip with a visible label. */
-interface ChipLabelledProps {
-    /** Visible text. */
-    label: string;
-}
+type ChipLabelledProps = Required<Pick<ChipBaseProps, "label">>;
 /** A chip with a count (a badge). */
-interface ChipCountedProps {
-    /** A number after the label (or alone, as a badge). */
-    count: number;
-}
+type ChipCountedProps = Required<Pick<ChipBaseProps, "count">>;
 /** A chip with neither a label nor a count (icon-only): the accessible name is required. */
-interface ChipNamedProps {
-    /** Accessible name. Required when there is neither `label` nor `count`. */
-    ariaLabel: string;
-}
+type ChipNamedProps = Required<Pick<ChipBaseProps, "ariaLabel">>;
 /** A chip colored by meaning (`variant`), or the default `SECONDARY`. */
 interface ChipVariantProps {
     /**
@@ -141,7 +132,12 @@ interface ChipVariantProps {
      * @default ChipVariant.SECONDARY
      */
     variant?: ChipVariant;
-    /** Categorical palette family. Not with `variant`. */
+    /**
+     * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
+     * (`"success"`, `"error"`): the name's text, fill and border, the way a status variant renders.
+     * For categories and data-driven chips (a source type, a team, a run status map); a status that
+     * is meaning takes `variant`. Not with `variant`.
+     */
     color?: undefined;
 }
 /** A chip colored by category (`color`). */

package/dist/feedback/ProgressBar.d.ts

@@ -21,11 +21,11 @@ export declare enum ProgressBarVariant {
     SECONDARY = "SECONDARY",
     /** `text.tertiary`. */
     TERTIARY = "TERTIARY",
-    /** `text.success`: healthy, on track, complete. */
+    /** `mark.success`: healthy, on track, complete. */
     SUCCESS = "SUCCESS",
-    /** `text.warning`: at risk, nearing a limit. */
+    /** `mark.warning`: at risk, nearing a limit. */
     WARNING = "WARNING",
-    /** `text.error`: failing, over a limit. */
+    /** `mark.error`: failing, over a limit. */
     ERROR = "ERROR"
 }
 /** The axes (everything except the value pair, the name pair and the passthrough). */
@@ -43,7 +43,12 @@ interface ProgressBarVariantProps {
      * @default ProgressBarVariant.PRIMARY
      */
     variant?: ProgressBarVariant;
-    /** Categorical palette family. Not with `variant`. */
+    /**
+     * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
+     * (`"success"`, `"error"`): the fill takes `mark.<name>`, the way a status variant renders. For a
+     * category's or data-driven color (a source type, a team); a status that is meaning takes
+     * `variant`. Not with `variant`.
+     */
     color?: undefined;
 }
 /** A bar colored by category (`color`). */
@@ -55,7 +60,7 @@ interface ProgressBarColorProps {
     variant?: undefined;
     /**
      * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
-     * (`"success"`, `"error"`): the fill takes `text.<name>`, the way a status variant renders. For a
+     * (`"success"`, `"error"`): the fill takes `mark.<name>`, the way a status variant renders. For a
      * category's or data-driven color (a source type, a team); a status that is meaning takes
      * `variant`. Not with `variant`.
      */

package/dist/feedback/ProgressBar.js

@@ -42,11 +42,11 @@ var ProgressBarVariant = /* @__PURE__ */ function(ProgressBarVariant) {
 	ProgressBarVariant["SECONDARY"] = "SECONDARY";
 	/** `text.tertiary`. */
 	ProgressBarVariant["TERTIARY"] = "TERTIARY";
-	/** `text.success`: healthy, on track, complete. */
+	/** `mark.success`: healthy, on track, complete. */
 	ProgressBarVariant["SUCCESS"] = "SUCCESS";
-	/** `text.warning`: at risk, nearing a limit. */
+	/** `mark.warning`: at risk, nearing a limit. */
 	ProgressBarVariant["WARNING"] = "WARNING";
-	/** `text.error`: failing, over a limit. */
+	/** `mark.error`: failing, over a limit. */
 	ProgressBarVariant["ERROR"] = "ERROR";
 	return ProgressBarVariant;
 }({});
@@ -95,7 +95,7 @@ var PROGRESS_BAR_VARIANT_TO_CSS_MAP = {
 	["WARNING"]: "gx-ProgressBar-WARNING-w1w2olvo",
 	["ERROR"]: "gx-ProgressBar-ERROR-e1qre8wf"
 };
-/** Categorical `color`: `text.<family>` on the root, the way a status variant renders. */
+/** Categorical `color`: `mark.<family>` on the root, the way a status variant renders. */
 var PROGRESS_BAR_COLOR_TO_CSS_MAP = {
 	success: "gx-ProgressBar-success-seiy0oi",
 	warning: "gx-ProgressBar-warning-w1epzlep",

package/dist/feedback/ProgressCircle.d.ts

@@ -21,11 +21,11 @@ export declare enum ProgressCircleVariant {
     SECONDARY = "SECONDARY",
     /** `text.tertiary`. */
     TERTIARY = "TERTIARY",
-    /** `text.success`: healthy, on track, complete. */
+    /** `mark.success`: healthy, on track, complete. */
     SUCCESS = "SUCCESS",
-    /** `text.warning`: at risk, nearing a limit. */
+    /** `mark.warning`: at risk, nearing a limit. */
     WARNING = "WARNING",
-    /** `text.error`: failing, over a limit. */
+    /** `mark.error`: failing, over a limit. */
     ERROR = "ERROR"
 }
 /** The value, the size and the shown value (everything except the color pair, the name pair and the passthrough). */
@@ -50,7 +50,12 @@ interface ProgressCircleVariantProps {
      * @default ProgressCircleVariant.PRIMARY
      */
     variant?: ProgressCircleVariant;
-    /** Categorical palette family. Not with `variant`. */
+    /**
+     * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
+     * (`"success"`, `"error"`): the arc takes `mark.<name>`, the way a status variant renders. For a
+     * category's or data-driven color (a source type, a team); a status that is meaning takes
+     * `variant`. Not with `variant`.
+     */
     color?: undefined;
 }
 /** A ring colored by category (`color`). */
@@ -62,7 +67,7 @@ interface ProgressCircleColorProps {
     variant?: undefined;
     /**
      * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
-     * (`"success"`, `"error"`): the arc takes `text.<name>`, the way a status variant renders. For a
+     * (`"success"`, `"error"`): the arc takes `mark.<name>`, the way a status variant renders. For a
      * category's or data-driven color (a source type, a team); a status that is meaning takes
      * `variant`. Not with `variant`.
      */

package/dist/feedback/ProgressCircle.js

@@ -42,11 +42,11 @@ var ProgressCircleVariant = /* @__PURE__ */ function(ProgressCircleVariant) {
 	ProgressCircleVariant["SECONDARY"] = "SECONDARY";
 	/** `text.tertiary`. */
 	ProgressCircleVariant["TERTIARY"] = "TERTIARY";
-	/** `text.success`: healthy, on track, complete. */
+	/** `mark.success`: healthy, on track, complete. */
 	ProgressCircleVariant["SUCCESS"] = "SUCCESS";
-	/** `text.warning`: at risk, nearing a limit. */
+	/** `mark.warning`: at risk, nearing a limit. */
 	ProgressCircleVariant["WARNING"] = "WARNING";
-	/** `text.error`: failing, over a limit. */
+	/** `mark.error`: failing, over a limit. */
 	ProgressCircleVariant["ERROR"] = "ERROR";
 	return ProgressCircleVariant;
 }({});
@@ -82,7 +82,7 @@ var PROGRESS_CIRCLE_VARIANT_TO_CSS_MAP = {
 	["WARNING"]: "gx-ProgressCircle-WARNING-w1ii09vl",
 	["ERROR"]: "gx-ProgressCircle-ERROR-e149xl4a"
 };
-/** Categorical `color`: `text.<family>` on the root, the way a status variant renders. */
+/** Categorical `color`: `mark.<family>` on the root, the way a status variant renders. */
 var PROGRESS_CIRCLE_COLOR_TO_CSS_MAP = {
 	success: "gx-ProgressCircle-success-s5wr4fy",
 	warning: "gx-ProgressCircle-warning-w3cpdk8",

package/dist/shapes/Circle.d.ts

@@ -13,7 +13,7 @@ export declare enum CircleSize {
     /** 12px, beside `body_lg` (20px line). */
     X_LARGE = "X_LARGE"
 }
-/** Fill color role (Constitution V-A color set). Resolves to `color.text.*`. */
+/** Fill color role (Constitution V-A color set). Neutral steps resolve to `color.text.*`, statuses to `color.mark.*`. */
 export declare enum CircleVariant {
     /** `text.primary`. */
     PRIMARY = "PRIMARY",
@@ -25,11 +25,11 @@ export declare enum CircleVariant {
     DISABLED = "DISABLED",
     /** The parent's color (`currentColor`). */
     INHERIT = "INHERIT",
-    /** Status: success, `text.success`. */
+    /** Status: success, `mark.success`. */
     SUCCESS = "SUCCESS",
-    /** Status: warning, `text.warning`. */
+    /** Status: warning, `mark.warning`. */
     WARNING = "WARNING",
-    /** Status: error, `text.error`. */
+    /** Status: error, `mark.error`. */
     ERROR = "ERROR"
 }
 interface CircleBaseProps extends AriaAttributes {
@@ -60,7 +60,12 @@ interface CircleVariantProps {
      * @default CircleVariant.TERTIARY
      */
     variant?: CircleVariant;
-    /** Categorical palette family. Not with `variant`. */
+    /**
+     * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
+     * (`"success"`, `"error"`): fills with `mark.<name>`, the way a status variant renders. For
+     * categories and data-driven marks (a series, a source type, a run status map); a status that is
+     * meaning takes `variant`. Not with `variant`.
+     */
     color?: undefined;
 }
 /** A dot colored by category (`color`). */
@@ -73,7 +78,7 @@ interface CircleColorProps {
     variant?: undefined;
     /**
      * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
-     * (`"success"`, `"error"`): fills with `text.<name>`, the way a status variant renders. For
+     * (`"success"`, `"error"`): fills with `mark.<name>`, the way a status variant renders. For
      * categories and data-driven marks (a series, a source type, a run status map); a status that is
      * meaning takes `variant`. Not with `variant`.
      */

package/dist/shapes/Circle.js

@@ -10,10 +10,10 @@ import { cx } from "@linaria/core";
 * the meaning; the dot carries the color.
 *
 * Color is CSS, not JS: `CIRCLE_VARIANT_TO_CSS_MAP` (or `CIRCLE_COLOR_TO_CSS_MAP` for a categorical
-* `color`) sets `color` from `color.text.*` and the fill
-* reads `currentColor` (the Icon pattern), so `INHERIT` and `hex` share one path and a theme
-* switch needs no re-render. `hex` is set as the `--gx-circle-hex` custom property in
-* `style` and read by a block switched on only when the prop is set.
+* `color`) sets `color` from `color.text.*` (the neutral steps) or `color.mark.*` (statuses and
+* families), and the fill reads `currentColor` (the Icon pattern), so `INHERIT` and `hex` share one
+* path and a theme switch needs no re-render. `hex` is set as the `--gx-circle-hex` custom property
+* in `style` and read by a block switched on only when the prop is set.
 *
 * `size` names the rung of the text the dot sits beside. Every diameter leaves an even gap to its
 * paired line height, so a dot centered beside its `Text` lands on whole pixels. Not live status
@@ -34,7 +34,7 @@ var CircleSize = /* @__PURE__ */ function(CircleSize) {
 	CircleSize["X_LARGE"] = "X_LARGE";
 	return CircleSize;
 }({});
-/** Fill color role (Constitution V-A color set). Resolves to `color.text.*`. */
+/** Fill color role (Constitution V-A color set). Neutral steps resolve to `color.text.*`, statuses to `color.mark.*`. */
 var CircleVariant = /* @__PURE__ */ function(CircleVariant) {
 	/** `text.primary`. */
 	CircleVariant["PRIMARY"] = "PRIMARY";
@@ -46,11 +46,11 @@ var CircleVariant = /* @__PURE__ */ function(CircleVariant) {
 	CircleVariant["DISABLED"] = "DISABLED";
 	/** The parent's color (`currentColor`). */
 	CircleVariant["INHERIT"] = "INHERIT";
-	/** Status: success, `text.success`. */
+	/** Status: success, `mark.success`. */
 	CircleVariant["SUCCESS"] = "SUCCESS";
-	/** Status: warning, `text.warning`. */
+	/** Status: warning, `mark.warning`. */
 	CircleVariant["WARNING"] = "WARNING";
-	/** Status: error, `text.error`. */
+	/** Status: error, `mark.error`. */
 	CircleVariant["ERROR"] = "ERROR";
 	return CircleVariant;
 }({});
@@ -82,7 +82,7 @@ var CIRCLE_VARIANT_TO_CSS_MAP = {
 	["WARNING"]: "gx-Circle-WARNING-w1wd9i5w",
 	["ERROR"]: "gx-Circle-ERROR-e4bqin2"
 };
-/** Categorical `color`: `text.<family>`, the way a status variant renders. */
+/** Categorical `color`: `mark.<family>`, the way a status variant renders. */
 var CIRCLE_COLOR_TO_CSS_MAP = {
 	success: "gx-Circle-success-sisghat",
 	warning: "gx-Circle-warning-wrnyxi5",

package/dist/shapes/Square.d.ts

@@ -13,7 +13,7 @@ export declare enum SquareSize {
     /** 12px, beside `body_lg` (20px line). */
     X_LARGE = "X_LARGE"
 }
-/** Fill color role (Constitution V-A color set). Resolves to `color.text.*`. */
+/** Fill color role (Constitution V-A color set). Neutral steps resolve to `color.text.*`, statuses to `color.mark.*`. */
 export declare enum SquareVariant {
     /** `text.primary`. */
     PRIMARY = "PRIMARY",
@@ -25,11 +25,11 @@ export declare enum SquareVariant {
     DISABLED = "DISABLED",
     /** The parent's color (`currentColor`). */
     INHERIT = "INHERIT",
-    /** Status: success, `text.success`. */
+    /** Status: success, `mark.success`. */
     SUCCESS = "SUCCESS",
-    /** Status: warning, `text.warning`. */
+    /** Status: warning, `mark.warning`. */
     WARNING = "WARNING",
-    /** Status: error, `text.error`. */
+    /** Status: error, `mark.error`. */
     ERROR = "ERROR"
 }
 interface SquareBaseProps extends AriaAttributes {
@@ -60,7 +60,12 @@ interface SquareVariantProps {
      * @default SquareVariant.TERTIARY
      */
     variant?: SquareVariant;
-    /** Categorical palette family. Not with `variant`. */
+    /**
+     * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
+     * (`"success"`, `"error"`): fills with `mark.<name>`, the way a status variant renders. For
+     * categories and data-driven marks (a series, a source type, a run status map); a status that is
+     * meaning takes `variant`. Not with `variant`.
+     */
     color?: undefined;
 }
 /** A mark colored by category (`color`). */
@@ -73,7 +78,7 @@ interface SquareColorProps {
     variant?: undefined;
     /**
      * Categorical palette family (`"blue"`, `"violet"`, …) or a status role as a string
-     * (`"success"`, `"error"`): fills with `text.<name>`, the way a status variant renders. For
+     * (`"success"`, `"error"`): fills with `mark.<name>`, the way a status variant renders. For
      * categories and data-driven marks (a series, a source type, a run status map); a status that is
      * meaning takes `variant`. Not with `variant`.
      */

package/dist/shapes/Square.js

@@ -11,10 +11,10 @@ import { cx } from "@linaria/core";
 * circle keys a line or point series, a square keys a filled area or bar.
 *
 * Color is CSS, not JS: `SQUARE_VARIANT_TO_CSS_MAP` (or `SQUARE_COLOR_TO_CSS_MAP` for a categorical
-* `color`) sets `color` from `color.text.*` and the fill
-* reads `currentColor` (the Icon pattern), so `INHERIT` and `hex` share one path and a theme
-* switch needs no re-render. `hex` is set as the `--gx-square-hex` custom property in
-* `style` and read by a block switched on only when the prop is set.
+* `color`) sets `color` from `color.text.*` (the neutral steps) or `color.mark.*` (statuses and
+* families), and the fill reads `currentColor` (the Icon pattern), so `INHERIT` and `hex` share one
+* path and a theme switch needs no re-render. `hex` is set as the `--gx-square-hex` custom property
+* in `style` and read by a block switched on only when the prop is set.
 *
 * `size` names the rung of the text the mark sits beside. Every side leaves an even gap to its
 * paired line height, so a mark centered beside its `Text` lands on whole pixels with crisp edges.
@@ -34,7 +34,7 @@ var SquareSize = /* @__PURE__ */ function(SquareSize) {
 	SquareSize["X_LARGE"] = "X_LARGE";
 	return SquareSize;
 }({});
-/** Fill color role (Constitution V-A color set). Resolves to `color.text.*`. */
+/** Fill color role (Constitution V-A color set). Neutral steps resolve to `color.text.*`, statuses to `color.mark.*`. */
 var SquareVariant = /* @__PURE__ */ function(SquareVariant) {
 	/** `text.primary`. */
 	SquareVariant["PRIMARY"] = "PRIMARY";
@@ -46,11 +46,11 @@ var SquareVariant = /* @__PURE__ */ function(SquareVariant) {
 	SquareVariant["DISABLED"] = "DISABLED";
 	/** The parent's color (`currentColor`). */
 	SquareVariant["INHERIT"] = "INHERIT";
-	/** Status: success, `text.success`. */
+	/** Status: success, `mark.success`. */
 	SquareVariant["SUCCESS"] = "SUCCESS";
-	/** Status: warning, `text.warning`. */
+	/** Status: warning, `mark.warning`. */
 	SquareVariant["WARNING"] = "WARNING";
-	/** Status: error, `text.error`. */
+	/** Status: error, `mark.error`. */
 	SquareVariant["ERROR"] = "ERROR";
 	return SquareVariant;
 }({});
@@ -83,7 +83,7 @@ var SQUARE_VARIANT_TO_CSS_MAP = {
 	["WARNING"]: "gx-Square-WARNING-w1jcu9g9",
 	["ERROR"]: "gx-Square-ERROR-e1a9qgv5"
 };
-/** Categorical `color`: `text.<family>`, the way a status variant renders. */
+/** Categorical `color`: `mark.<family>`, the way a status variant renders. */
 var SQUARE_COLOR_TO_CSS_MAP = {
 	success: "gx-Square-success-s44keg",
 	warning: "gx-Square-warning-w1czb11g",