@vectoriox/iox-ui 5.30.0 → 5.31.0

package/design-core/index.d.ts

@@ -148,6 +148,16 @@ declare const SPEC_TIERS: {
         readonly type: "color";
         readonly group: "colour";
         readonly desc: "Error fill";
+    }, {
+        readonly name: "warning";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly desc: "Warning text (Card v2 badge tone) — AA on warning-bg";
+    }, {
+        readonly name: "warning-bg";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly desc: "Warning fill";
     }, {
         readonly name: "scrim";
         readonly type: "color";
@@ -739,6 +749,62 @@ declare const SPEC_TIERS: {
         readonly name: "divider-color";
         readonly type: "color";
         readonly default: "var(--iox-line)";
+    }, {
+        readonly name: "badge-radius";
+        readonly type: "radius";
+        readonly default: "var(--iox-radius-pill)";
+    }, {
+        readonly name: "badge-pad";
+        readonly type: "spacing";
+        readonly default: "3px 10px";
+    }, {
+        readonly name: "badge-size";
+        readonly type: "size";
+        readonly default: "var(--iox-size-label)";
+    }, {
+        readonly name: "badge-neutral-bg";
+        readonly type: "color";
+        readonly default: "var(--iox-surface-2)";
+    }, {
+        readonly name: "badge-neutral-ink";
+        readonly type: "color";
+        readonly default: "var(--iox-text)";
+    }, {
+        readonly name: "badge-success-bg";
+        readonly type: "color";
+        readonly default: "var(--iox-success-bg)";
+    }, {
+        readonly name: "badge-success-ink";
+        readonly type: "color";
+        readonly default: "var(--iox-success)";
+    }, {
+        readonly name: "badge-warning-bg";
+        readonly type: "color";
+        readonly default: "var(--iox-warning-bg)";
+    }, {
+        readonly name: "badge-warning-ink";
+        readonly type: "color";
+        readonly default: "var(--iox-warning)";
+    }, {
+        readonly name: "badge-accent-bg";
+        readonly type: "color";
+        readonly default: "var(--iox-accent)";
+    }, {
+        readonly name: "badge-accent-ink";
+        readonly type: "color";
+        readonly default: "var(--iox-accent-ink)";
+    }, {
+        readonly name: "chip-border";
+        readonly type: "color";
+        readonly default: "var(--iox-line-strong)";
+    }, {
+        readonly name: "media-scrim";
+        readonly type: "color";
+        readonly default: "rgba(0, 0, 0, 0.62)";
+    }, {
+        readonly name: "media-scrim-ink";
+        readonly type: "color";
+        readonly default: "#FFFFFF";
     }];
 };
 declare const SPEC_TOKEN_TYPES: readonly ["color", "paint", "font", "number", "size", "spacing", "radius", "shadow", "effect", "duration", "easing", "keyword", "other"];
@@ -991,6 +1057,8 @@ declare const SPEC_SCHEMES: {
             readonly "danger-bg": "{{~danger-bg}}";
             readonly success: "{{~success}}";
             readonly "success-bg": "{{~success-bg}}";
+            readonly warning: "{{~warning}}";
+            readonly "warning-bg": "{{~warning-bg}}";
         };
     };
     readonly accent: {
@@ -1015,6 +1083,8 @@ declare const SPEC_SCHEMES: {
             readonly "danger-bg": "{{accent-hover}}";
             readonly success: "{{accent-ink}}";
             readonly "success-bg": "{{accent-hover}}";
+            readonly warning: "{{accent-ink}}";
+            readonly "warning-bg": "{{accent-hover}}";
         };
     };
 };
@@ -1423,6 +1493,96 @@ declare const SPEC_ELEMENT_STYLES: readonly [{
     readonly group: "Forms";
     readonly appliesTo: readonly ["Field"];
     readonly base: {};
+}, {
+    readonly id: "badge-neutral";
+    readonly label: "Badge · Neutral";
+    readonly group: "Content blocks";
+    readonly appliesTo: readonly ["Container"];
+    readonly base: {
+        readonly backgroundColor: "var(--iox-badge-neutral-bg)";
+        readonly color: "var(--iox-badge-neutral-ink)";
+        readonly borderRadius: "var(--iox-badge-radius)";
+        readonly padding: "var(--iox-badge-pad)";
+        readonly fontFamily: "var(--iox-font-label)";
+        readonly fontSize: "var(--iox-badge-size)";
+        readonly fontWeight: "var(--iox-weight-label)";
+        readonly letterSpacing: "var(--iox-tracking-label)";
+        readonly textTransform: "var(--iox-case-label)";
+    };
+}, {
+    readonly id: "badge-success";
+    readonly label: "Badge · Success";
+    readonly group: "Content blocks";
+    readonly appliesTo: readonly ["Container"];
+    readonly base: {
+        readonly backgroundColor: "var(--iox-badge-success-bg)";
+        readonly color: "var(--iox-badge-success-ink)";
+        readonly borderRadius: "var(--iox-badge-radius)";
+        readonly padding: "var(--iox-badge-pad)";
+        readonly fontFamily: "var(--iox-font-label)";
+        readonly fontSize: "var(--iox-badge-size)";
+        readonly fontWeight: "var(--iox-weight-label)";
+        readonly letterSpacing: "var(--iox-tracking-label)";
+        readonly textTransform: "var(--iox-case-label)";
+    };
+}, {
+    readonly id: "badge-warning";
+    readonly label: "Badge · Warning";
+    readonly group: "Content blocks";
+    readonly appliesTo: readonly ["Container"];
+    readonly base: {
+        readonly backgroundColor: "var(--iox-badge-warning-bg)";
+        readonly color: "var(--iox-badge-warning-ink)";
+        readonly borderRadius: "var(--iox-badge-radius)";
+        readonly padding: "var(--iox-badge-pad)";
+        readonly fontFamily: "var(--iox-font-label)";
+        readonly fontSize: "var(--iox-badge-size)";
+        readonly fontWeight: "var(--iox-weight-label)";
+        readonly letterSpacing: "var(--iox-tracking-label)";
+        readonly textTransform: "var(--iox-case-label)";
+    };
+}, {
+    readonly id: "badge-accent";
+    readonly label: "Badge · Accent";
+    readonly group: "Content blocks";
+    readonly appliesTo: readonly ["Container"];
+    readonly base: {
+        readonly backgroundColor: "var(--iox-badge-accent-bg)";
+        readonly color: "var(--iox-badge-accent-ink)";
+        readonly borderRadius: "var(--iox-badge-radius)";
+        readonly padding: "var(--iox-badge-pad)";
+        readonly fontFamily: "var(--iox-font-label)";
+        readonly fontSize: "var(--iox-badge-size)";
+        readonly fontWeight: "var(--iox-weight-label)";
+        readonly letterSpacing: "var(--iox-tracking-label)";
+        readonly textTransform: "var(--iox-case-label)";
+    };
+}, {
+    readonly id: "chip";
+    readonly label: "Chip";
+    readonly group: "Content blocks";
+    readonly appliesTo: readonly ["Container"];
+    readonly base: {
+        readonly backgroundColor: "transparent";
+        readonly color: "var(--iox-text)";
+        readonly borderStyle: "solid";
+        readonly borderWidth: "var(--iox-border-width)";
+        readonly borderColor: "var(--iox-chip-border)";
+        readonly borderRadius: "var(--iox-badge-radius)";
+        readonly padding: "var(--iox-badge-pad)";
+        readonly fontFamily: "var(--iox-font-label)";
+        readonly fontSize: "var(--iox-badge-size)";
+        readonly fontWeight: "var(--iox-weight-label)";
+    };
+}, {
+    readonly id: "media-scrim";
+    readonly label: "Text over image";
+    readonly group: "Content blocks";
+    readonly appliesTo: readonly ["Container"];
+    readonly base: {
+        readonly backgroundColor: "linear-gradient(180deg, transparent 0%, var(--iox-media-scrim) 45%)";
+        readonly color: "var(--iox-media-scrim-ink)";
+    };
 }, {
     readonly id: "notice-success";
     readonly label: "Success message";
@@ -1478,15 +1638,6 @@ declare const SPEC_BUTTON_VARIANT_TO_STYLE: {
     readonly text: "button-ghost";
 };
 declare const SPEC_PALETTE_PRESETS: readonly [{
-    readonly label: "Card";
-    readonly type: "Container";
-    readonly elementStyle: "card";
-    readonly styleProps: {
-        readonly display: "flex";
-        readonly flexDirection: "column";
-        readonly gap: "var(--iox-space-gap)";
-    };
-}, {
     readonly label: "Panel";
     readonly type: "Container";
     readonly elementStyle: "panel";
@@ -1693,6 +1844,23 @@ declare const SPEC_INK_SCOPES: readonly [{
         readonly "link-hover-color": "currentColor";
         readonly "text-muted": "currentColor";
     };
+}, {
+    readonly styles: readonly ["badge-neutral", "badge-success", "badge-warning", "badge-accent", "chip"];
+    readonly set: {
+        readonly "icon-color": "currentColor";
+    };
+}, {
+    readonly styles: readonly ["media-scrim"];
+    readonly children: true;
+    readonly set: {
+        readonly "heading-color": "currentColor";
+        readonly "eyebrow-color": "currentColor";
+        readonly "text-muted": "currentColor";
+        readonly "link-color": "currentColor";
+        readonly "link-hover-color": "currentColor";
+        readonly "icon-color": "currentColor";
+        readonly "button-ghost-ink": "currentColor";
+    };
 }];
 declare const SPEC_CONTRAST_AUDIT: {
     readonly pairs: readonly [{
@@ -1743,6 +1911,10 @@ declare const SPEC_CONTRAST_AUDIT: {
         readonly fg: "danger";
         readonly bg: "danger-bg";
         readonly min: 4.5;
+    }, {
+        readonly fg: "warning";
+        readonly bg: "warning-bg";
+        readonly min: 4.5;
     }, {
         readonly fg: "accent-ink";
         readonly bg: "accent-hover";
@@ -1857,6 +2029,12 @@ declare const SPEC_CONTRAST_AUDIT: {
         readonly fg: "var(--iox-line-strong)";
         readonly min: 3;
     }];
+    readonly scrims: readonly [{
+        readonly style: "media-scrim";
+        readonly token: "media-scrim";
+        readonly scheme: "inverse";
+        readonly image: "#FFFFFF";
+    }];
 };
 declare const SPEC_LEGACY_ALIASES: {
     readonly "radius-control": "var(--iox-button-radius)";
@@ -1953,6 +2131,8 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
             readonly "success-bg": "#E7F4EC";
             readonly danger: "#B3261E";
             readonly "danger-bg": "#FBE9E7";
+            readonly warning: "#7A4A00";
+            readonly "warning-bg": "#FBF0D9";
             readonly scrim: "rgba(15, 17, 21, 0.45)";
         };
         readonly dark: {
@@ -1978,6 +2158,8 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
             readonly "success-bg": "#13291C";
             readonly danger: "#FF8A80";
             readonly "danger-bg": "#3A1715";
+            readonly warning: "#F2C46D";
+            readonly "warning-bg": "#2E2210";
             readonly scrim: "rgba(0, 0, 0, 0.6)";
         };
     };
@@ -2178,6 +2360,20 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
         readonly group: "colour";
         readonly value: "#FBE9E7";
         readonly dark: "#3A1715";
+    }, {
+        readonly name: "warning";
+        readonly tier: "semantic";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly value: "#7A4A00";
+        readonly dark: "#F2C46D";
+    }, {
+        readonly name: "warning-bg";
+        readonly tier: "semantic";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly value: "#FBF0D9";
+        readonly dark: "#2E2210";
     }, {
         readonly name: "scrim";
         readonly tier: "semantic";
@@ -2986,6 +3182,90 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
         readonly type: "color";
         readonly group: "components";
         readonly value: "var(--iox-line)";
+    }, {
+        readonly name: "badge-radius";
+        readonly tier: "component";
+        readonly type: "radius";
+        readonly group: "components";
+        readonly value: "var(--iox-radius-pill)";
+    }, {
+        readonly name: "badge-pad";
+        readonly tier: "component";
+        readonly type: "spacing";
+        readonly group: "components";
+        readonly value: "3px 10px";
+    }, {
+        readonly name: "badge-size";
+        readonly tier: "component";
+        readonly type: "size";
+        readonly group: "components";
+        readonly value: "var(--iox-size-label)";
+    }, {
+        readonly name: "badge-neutral-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-surface-2)";
+    }, {
+        readonly name: "badge-neutral-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-text)";
+    }, {
+        readonly name: "badge-success-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-success-bg)";
+    }, {
+        readonly name: "badge-success-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-success)";
+    }, {
+        readonly name: "badge-warning-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-warning-bg)";
+    }, {
+        readonly name: "badge-warning-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-warning)";
+    }, {
+        readonly name: "badge-accent-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent)";
+    }, {
+        readonly name: "badge-accent-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent-ink)";
+    }, {
+        readonly name: "chip-border";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-line-strong)";
+    }, {
+        readonly name: "media-scrim";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "rgba(0, 0, 0, 0.62)";
+    }, {
+        readonly name: "media-scrim-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "#FFFFFF";
     }];
 }, {
     readonly id: "linen";
@@ -3076,6 +3356,8 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
             readonly "success-bg": "#E9EEDF";
             readonly danger: "#9A3324";
             readonly "danger-bg": "#F5E3DC";
+            readonly warning: "#7A4A00";
+            readonly "warning-bg": "#FBF0D9";
             readonly scrim: "rgba(31, 27, 22, 0.5)";
         };
         readonly dark: {
@@ -3101,6 +3383,8 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
             readonly "success-bg": "#1E2619";
             readonly danger: "#E8A08F";
             readonly "danger-bg": "#2E1A15";
+            readonly warning: "#F2C46D";
+            readonly "warning-bg": "#2E2210";
             readonly scrim: "rgba(0, 0, 0, 0.6)";
         };
     };
@@ -3301,6 +3585,20 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
         readonly group: "colour";
         readonly value: "#F5E3DC";
         readonly dark: "#2E1A15";
+    }, {
+        readonly name: "warning";
+        readonly tier: "semantic";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly value: "#7A4A00";
+        readonly dark: "#F2C46D";
+    }, {
+        readonly name: "warning-bg";
+        readonly tier: "semantic";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly value: "#FBF0D9";
+        readonly dark: "#2E2210";
     }, {
         readonly name: "scrim";
         readonly tier: "semantic";
@@ -4129,6 +4427,90 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
         readonly type: "color";
         readonly group: "components";
         readonly value: "var(--iox-line)";
+    }, {
+        readonly name: "badge-radius";
+        readonly tier: "component";
+        readonly type: "radius";
+        readonly group: "components";
+        readonly value: "var(--iox-radius-pill)";
+    }, {
+        readonly name: "badge-pad";
+        readonly tier: "component";
+        readonly type: "spacing";
+        readonly group: "components";
+        readonly value: "3px 10px";
+    }, {
+        readonly name: "badge-size";
+        readonly tier: "component";
+        readonly type: "size";
+        readonly group: "components";
+        readonly value: "var(--iox-size-label)";
+    }, {
+        readonly name: "badge-neutral-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-surface-2)";
+    }, {
+        readonly name: "badge-neutral-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-text)";
+    }, {
+        readonly name: "badge-success-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-success-bg)";
+    }, {
+        readonly name: "badge-success-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-success)";
+    }, {
+        readonly name: "badge-warning-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-warning-bg)";
+    }, {
+        readonly name: "badge-warning-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-warning)";
+    }, {
+        readonly name: "badge-accent-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent)";
+    }, {
+        readonly name: "badge-accent-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent-ink)";
+    }, {
+        readonly name: "chip-border";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-line-strong)";
+    }, {
+        readonly name: "media-scrim";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "rgba(0, 0, 0, 0.62)";
+    }, {
+        readonly name: "media-scrim-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "#FFFFFF";
     }];
 }, {
     readonly id: "midnight";
@@ -4219,6 +4601,8 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
             readonly "success-bg": "#E7F4EC";
             readonly danger: "#B3261E";
             readonly "danger-bg": "#FBE9E7";
+            readonly warning: "#7A4A00";
+            readonly "warning-bg": "#FBF0D9";
             readonly scrim: "rgba(8, 9, 10, 0.55)";
         };
         readonly dark: {
@@ -4244,6 +4628,8 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
             readonly "success-bg": "#0F2418";
             readonly danger: "#FF7B72";
             readonly "danger-bg": "#2D1213";
+            readonly warning: "#F2C46D";
+            readonly "warning-bg": "#2E2210";
             readonly scrim: "rgba(0, 0, 0, 0.7)";
         };
     };
@@ -4444,6 +4830,20 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
         readonly group: "colour";
         readonly value: "#FBE9E7";
         readonly dark: "#2D1213";
+    }, {
+        readonly name: "warning";
+        readonly tier: "semantic";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly value: "#7A4A00";
+        readonly dark: "#F2C46D";
+    }, {
+        readonly name: "warning-bg";
+        readonly tier: "semantic";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly value: "#FBF0D9";
+        readonly dark: "#2E2210";
     }, {
         readonly name: "scrim";
         readonly tier: "semantic";
@@ -5194,73 +5594,157 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
         readonly tier: "component";
         readonly type: "spacing";
         readonly group: "components";
-        readonly value: "var(--iox-space-pad)";
+        readonly value: "var(--iox-space-pad)";
+    }, {
+        readonly name: "dialog-border";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "transparent";
+    }, {
+        readonly name: "dialog-border-width";
+        readonly tier: "component";
+        readonly type: "size";
+        readonly group: "components";
+        readonly value: "0px";
+    }, {
+        readonly name: "image-radius";
+        readonly tier: "component";
+        readonly type: "radius";
+        readonly group: "components";
+        readonly value: "var(--iox-radius-md)";
+    }, {
+        readonly name: "image-hover-scale";
+        readonly tier: "component";
+        readonly type: "number";
+        readonly group: "components";
+        readonly value: "1";
+    }, {
+        readonly name: "link-color";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent-text)";
+    }, {
+        readonly name: "link-hover-color";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-text)";
+    }, {
+        readonly name: "link-decoration";
+        readonly tier: "component";
+        readonly type: "keyword";
+        readonly group: "components";
+        readonly value: "underline";
+    }, {
+        readonly name: "heading-color";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-text)";
+    }, {
+        readonly name: "eyebrow-color";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent-text)";
+    }, {
+        readonly name: "icon-color";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent-text)";
+    }, {
+        readonly name: "divider-color";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-line)";
+    }, {
+        readonly name: "badge-radius";
+        readonly tier: "component";
+        readonly type: "radius";
+        readonly group: "components";
+        readonly value: "var(--iox-radius-pill)";
+    }, {
+        readonly name: "badge-pad";
+        readonly tier: "component";
+        readonly type: "spacing";
+        readonly group: "components";
+        readonly value: "3px 10px";
+    }, {
+        readonly name: "badge-size";
+        readonly tier: "component";
+        readonly type: "size";
+        readonly group: "components";
+        readonly value: "var(--iox-size-label)";
     }, {
-        readonly name: "dialog-border";
+        readonly name: "badge-neutral-bg";
         readonly tier: "component";
         readonly type: "color";
         readonly group: "components";
-        readonly value: "transparent";
+        readonly value: "var(--iox-surface-2)";
     }, {
-        readonly name: "dialog-border-width";
+        readonly name: "badge-neutral-ink";
         readonly tier: "component";
-        readonly type: "size";
+        readonly type: "color";
         readonly group: "components";
-        readonly value: "0px";
+        readonly value: "var(--iox-text)";
     }, {
-        readonly name: "image-radius";
+        readonly name: "badge-success-bg";
         readonly tier: "component";
-        readonly type: "radius";
+        readonly type: "color";
         readonly group: "components";
-        readonly value: "var(--iox-radius-md)";
+        readonly value: "var(--iox-success-bg)";
     }, {
-        readonly name: "image-hover-scale";
+        readonly name: "badge-success-ink";
         readonly tier: "component";
-        readonly type: "number";
+        readonly type: "color";
         readonly group: "components";
-        readonly value: "1";
+        readonly value: "var(--iox-success)";
     }, {
-        readonly name: "link-color";
+        readonly name: "badge-warning-bg";
         readonly tier: "component";
         readonly type: "color";
         readonly group: "components";
-        readonly value: "var(--iox-accent-text)";
+        readonly value: "var(--iox-warning-bg)";
     }, {
-        readonly name: "link-hover-color";
+        readonly name: "badge-warning-ink";
         readonly tier: "component";
         readonly type: "color";
         readonly group: "components";
-        readonly value: "var(--iox-text)";
+        readonly value: "var(--iox-warning)";
     }, {
-        readonly name: "link-decoration";
+        readonly name: "badge-accent-bg";
         readonly tier: "component";
-        readonly type: "keyword";
+        readonly type: "color";
         readonly group: "components";
-        readonly value: "underline";
+        readonly value: "var(--iox-accent)";
     }, {
-        readonly name: "heading-color";
+        readonly name: "badge-accent-ink";
         readonly tier: "component";
         readonly type: "color";
         readonly group: "components";
-        readonly value: "var(--iox-text)";
+        readonly value: "var(--iox-accent-ink)";
     }, {
-        readonly name: "eyebrow-color";
+        readonly name: "chip-border";
         readonly tier: "component";
         readonly type: "color";
         readonly group: "components";
-        readonly value: "var(--iox-accent-text)";
+        readonly value: "var(--iox-line-strong)";
     }, {
-        readonly name: "icon-color";
+        readonly name: "media-scrim";
         readonly tier: "component";
         readonly type: "color";
         readonly group: "components";
-        readonly value: "var(--iox-accent-text)";
+        readonly value: "rgba(0, 0, 0, 0.62)";
     }, {
-        readonly name: "divider-color";
+        readonly name: "media-scrim-ink";
         readonly tier: "component";
         readonly type: "color";
         readonly group: "components";
-        readonly value: "var(--iox-line)";
+        readonly value: "#FFFFFF";
     }];
 }, {
     readonly id: "glass";
@@ -5351,6 +5835,8 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
             readonly "success-bg": "#E3F5EA";
             readonly danger: "#B3261E";
             readonly "danger-bg": "#FCE8E6";
+            readonly warning: "#7A4A00";
+            readonly "warning-bg": "#FBF0D9";
             readonly scrim: "rgba(15, 23, 42, 0.30)";
         };
         readonly dark: {
@@ -5380,6 +5866,8 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
             readonly "success-bg": "#12291C";
             readonly danger: "#FF8A80";
             readonly "danger-bg": "#3A1715";
+            readonly warning: "#F2C46D";
+            readonly "warning-bg": "#2E2210";
             readonly scrim: "rgba(0, 0, 0, 0.5)";
         };
     };
@@ -5589,6 +6077,20 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
         readonly group: "colour";
         readonly value: "#FCE8E6";
         readonly dark: "#3A1715";
+    }, {
+        readonly name: "warning";
+        readonly tier: "semantic";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly value: "#7A4A00";
+        readonly dark: "#F2C46D";
+    }, {
+        readonly name: "warning-bg";
+        readonly tier: "semantic";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly value: "#FBF0D9";
+        readonly dark: "#2E2210";
     }, {
         readonly name: "scrim";
         readonly tier: "semantic";
@@ -6425,6 +6927,90 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
         readonly type: "color";
         readonly group: "components";
         readonly value: "var(--iox-line)";
+    }, {
+        readonly name: "badge-radius";
+        readonly tier: "component";
+        readonly type: "radius";
+        readonly group: "components";
+        readonly value: "var(--iox-radius-pill)";
+    }, {
+        readonly name: "badge-pad";
+        readonly tier: "component";
+        readonly type: "spacing";
+        readonly group: "components";
+        readonly value: "3px 10px";
+    }, {
+        readonly name: "badge-size";
+        readonly tier: "component";
+        readonly type: "size";
+        readonly group: "components";
+        readonly value: "var(--iox-size-label)";
+    }, {
+        readonly name: "badge-neutral-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-surface-2)";
+    }, {
+        readonly name: "badge-neutral-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-text)";
+    }, {
+        readonly name: "badge-success-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-success-bg)";
+    }, {
+        readonly name: "badge-success-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-success)";
+    }, {
+        readonly name: "badge-warning-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-warning-bg)";
+    }, {
+        readonly name: "badge-warning-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-warning)";
+    }, {
+        readonly name: "badge-accent-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent)";
+    }, {
+        readonly name: "badge-accent-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent-ink)";
+    }, {
+        readonly name: "chip-border";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-line-strong)";
+    }, {
+        readonly name: "media-scrim";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "rgba(0, 0, 0, 0.62)";
+    }, {
+        readonly name: "media-scrim-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "#FFFFFF";
     }];
 }, {
     readonly id: "bloom";
@@ -6515,6 +7101,8 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
             readonly "success-bg": "#DDF3E3";
             readonly danger: "#B3261E";
             readonly "danger-bg": "#F9DEDC";
+            readonly warning: "#7A4A00";
+            readonly "warning-bg": "#FBF0D9";
             readonly scrim: "rgba(29, 27, 32, 0.4)";
         };
         readonly dark: {
@@ -6540,6 +7128,8 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
             readonly "success-bg": "#123620";
             readonly danger: "#F2B8B5";
             readonly "danger-bg": "#601410";
+            readonly warning: "#F2C46D";
+            readonly "warning-bg": "#2E2210";
             readonly scrim: "rgba(0, 0, 0, 0.55)";
         };
     };
@@ -6739,6 +7329,20 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
         readonly group: "colour";
         readonly value: "#F9DEDC";
         readonly dark: "#601410";
+    }, {
+        readonly name: "warning";
+        readonly tier: "semantic";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly value: "#7A4A00";
+        readonly dark: "#F2C46D";
+    }, {
+        readonly name: "warning-bg";
+        readonly tier: "semantic";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly value: "#FBF0D9";
+        readonly dark: "#2E2210";
     }, {
         readonly name: "scrim";
         readonly tier: "semantic";
@@ -7559,6 +8163,90 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
         readonly type: "color";
         readonly group: "components";
         readonly value: "var(--iox-line)";
+    }, {
+        readonly name: "badge-radius";
+        readonly tier: "component";
+        readonly type: "radius";
+        readonly group: "components";
+        readonly value: "var(--iox-radius-pill)";
+    }, {
+        readonly name: "badge-pad";
+        readonly tier: "component";
+        readonly type: "spacing";
+        readonly group: "components";
+        readonly value: "3px 10px";
+    }, {
+        readonly name: "badge-size";
+        readonly tier: "component";
+        readonly type: "size";
+        readonly group: "components";
+        readonly value: "var(--iox-size-label)";
+    }, {
+        readonly name: "badge-neutral-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-surface-2)";
+    }, {
+        readonly name: "badge-neutral-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-text)";
+    }, {
+        readonly name: "badge-success-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-success-bg)";
+    }, {
+        readonly name: "badge-success-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-success)";
+    }, {
+        readonly name: "badge-warning-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-warning-bg)";
+    }, {
+        readonly name: "badge-warning-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-warning)";
+    }, {
+        readonly name: "badge-accent-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent)";
+    }, {
+        readonly name: "badge-accent-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent-ink)";
+    }, {
+        readonly name: "chip-border";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-line-strong)";
+    }, {
+        readonly name: "media-scrim";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "rgba(0, 0, 0, 0.62)";
+    }, {
+        readonly name: "media-scrim-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "#FFFFFF";
     }];
 }, {
     readonly id: "pop";
@@ -7649,6 +8337,8 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
             readonly "success-bg": "#C9F2D9";
             readonly danger: "#B3261E";
             readonly "danger-bg": "#FFD9D2";
+            readonly warning: "#7A4A00";
+            readonly "warning-bg": "#FBF0D9";
             readonly scrim: "rgba(10, 10, 10, 0.5)";
         };
         readonly dark: {
@@ -7673,6 +8363,8 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
             readonly "success-bg": "#0F2A1A";
             readonly danger: "#FF8A80";
             readonly "danger-bg": "#3A1715";
+            readonly warning: "#F2C46D";
+            readonly "warning-bg": "#2E2210";
             readonly scrim: "rgba(0, 0, 0, 0.6)";
         };
     };
@@ -7869,6 +8561,20 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
         readonly group: "colour";
         readonly value: "#FFD9D2";
         readonly dark: "#3A1715";
+    }, {
+        readonly name: "warning";
+        readonly tier: "semantic";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly value: "#7A4A00";
+        readonly dark: "#F2C46D";
+    }, {
+        readonly name: "warning-bg";
+        readonly tier: "semantic";
+        readonly type: "color";
+        readonly group: "colour";
+        readonly value: "#FBF0D9";
+        readonly dark: "#2E2210";
     }, {
         readonly name: "scrim";
         readonly tier: "semantic";
@@ -8702,6 +9408,90 @@ declare const SPEC_FLAVOR_PACKS: readonly [{
         readonly type: "color";
         readonly group: "components";
         readonly value: "var(--iox-line)";
+    }, {
+        readonly name: "badge-radius";
+        readonly tier: "component";
+        readonly type: "radius";
+        readonly group: "components";
+        readonly value: "var(--iox-radius-pill)";
+    }, {
+        readonly name: "badge-pad";
+        readonly tier: "component";
+        readonly type: "spacing";
+        readonly group: "components";
+        readonly value: "3px 10px";
+    }, {
+        readonly name: "badge-size";
+        readonly tier: "component";
+        readonly type: "size";
+        readonly group: "components";
+        readonly value: "var(--iox-size-label)";
+    }, {
+        readonly name: "badge-neutral-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-surface-2)";
+    }, {
+        readonly name: "badge-neutral-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-text)";
+    }, {
+        readonly name: "badge-success-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-success-bg)";
+    }, {
+        readonly name: "badge-success-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-success)";
+    }, {
+        readonly name: "badge-warning-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-warning-bg)";
+    }, {
+        readonly name: "badge-warning-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-warning)";
+    }, {
+        readonly name: "badge-accent-bg";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent)";
+    }, {
+        readonly name: "badge-accent-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-accent-ink)";
+    }, {
+        readonly name: "chip-border";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "var(--iox-line-strong)";
+    }, {
+        readonly name: "media-scrim";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "rgba(0, 0, 0, 0.62)";
+    }, {
+        readonly name: "media-scrim-ink";
+        readonly tier: "component";
+        readonly type: "color";
+        readonly group: "components";
+        readonly value: "#FFFFFF";
     }];
 }];
 declare const SPEC_CONTRAST: {
@@ -8718,6 +9508,7 @@ declare const SPEC_CONTRAST: {
         readonly "light:inverse-accent/inverse-bg": 8.34;
         readonly "light:success/success-bg": 5.77;
         readonly "light:danger/danger-bg": 5.58;
+        readonly "light:warning/warning-bg": 6.61;
         readonly "light:accent-ink/accent-hover": 7.43;
         readonly "light:text-muted/surface-2": 5.79;
         readonly "light:text/surface-2": 17.6;
@@ -8741,6 +9532,7 @@ declare const SPEC_CONTRAST: {
         readonly "dark:inverse-accent/inverse-bg": 5.14;
         readonly "dark:success/success-bg": 8;
         readonly "dark:danger/danger-bg": 7;
+        readonly "dark:warning/warning-bg": 9.53;
         readonly "dark:accent-ink/accent-hover": 9.37;
         readonly "dark:text-muted/surface-2": 6.28;
         readonly "dark:text/surface-2": 14.84;
@@ -8766,6 +9558,7 @@ declare const SPEC_CONTRAST: {
         readonly "light:inverse-accent/inverse-bg": 7.61;
         readonly "light:success/success-bg": 5.26;
         readonly "light:danger/danger-bg": 5.88;
+        readonly "light:warning/warning-bg": 6.61;
         readonly "light:accent-ink/accent-hover": 8.41;
         readonly "light:text-muted/surface-2": 5.33;
         readonly "light:text/surface-2": 14.21;
@@ -8789,6 +9582,7 @@ declare const SPEC_CONTRAST: {
         readonly "dark:inverse-accent/inverse-bg": 5.15;
         readonly "dark:success/success-bg": 8.41;
         readonly "dark:danger/danger-bg": 7.73;
+        readonly "dark:warning/warning-bg": 9.53;
         readonly "dark:accent-ink/accent-hover": 10.41;
         readonly "dark:text-muted/surface-2": 6.74;
         readonly "dark:text/surface-2": 14.32;
@@ -8814,6 +9608,7 @@ declare const SPEC_CONTRAST: {
         readonly "light:inverse-accent/inverse-bg": 8.32;
         readonly "light:success/success-bg": 5.77;
         readonly "light:danger/danger-bg": 5.58;
+        readonly "light:warning/warning-bg": 6.61;
         readonly "light:accent-ink/accent-hover": 7.31;
         readonly "light:text-muted/surface-2": 5.5;
         readonly "light:text/surface-2": 17.79;
@@ -8837,6 +9632,7 @@ declare const SPEC_CONTRAST: {
         readonly "dark:inverse-accent/inverse-bg": 5.46;
         readonly "dark:success/success-bg": 9.37;
         readonly "dark:danger/danger-bg": 6.9;
+        readonly "dark:warning/warning-bg": 9.53;
         readonly "dark:accent-ink/accent-hover": 5.83;
         readonly "dark:text-muted/surface-2": 5.79;
         readonly "dark:text/surface-2": 16.53;
@@ -8859,6 +9655,7 @@ declare const SPEC_CONTRAST: {
         readonly "light:inverse-accent/inverse-bg": 6.88;
         readonly "light:success/success-bg": 5.76;
         readonly "light:danger/danger-bg": 5.55;
+        readonly "light:warning/warning-bg": 6.61;
         readonly "light:accent-ink/accent-hover": 6.76;
         readonly "light:text-muted/surface-2": 6.51;
         readonly "light:text/surface-2": 18.2;
@@ -8879,6 +9676,7 @@ declare const SPEC_CONTRAST: {
         readonly "dark:inverse-accent/inverse-bg": 4.79;
         readonly "dark:success/success-bg": 8.02;
         readonly "dark:danger/danger-bg": 7;
+        readonly "dark:warning/warning-bg": 9.53;
         readonly "dark:accent-ink/accent-hover": 8.44;
         readonly "dark:text-muted/surface-2": 6.54;
         readonly "dark:text/surface-2": 14.41;
@@ -8901,6 +9699,7 @@ declare const SPEC_CONTRAST: {
         readonly "light:inverse-accent/inverse-bg": 7.74;
         readonly "light:success/success-bg": 5.59;
         readonly "light:danger/danger-bg": 5.14;
+        readonly "light:warning/warning-bg": 6.61;
         readonly "light:accent-ink/accent-hover": 7.86;
         readonly "light:text-muted/surface-2": 8.15;
         readonly "light:text/surface-2": 14.84;
@@ -8924,6 +9723,7 @@ declare const SPEC_CONTRAST: {
         readonly "dark:inverse-accent/inverse-bg": 4.97;
         readonly "dark:success/success-bg": 8.02;
         readonly "dark:danger/danger-bg": 7.66;
+        readonly "dark:warning/warning-bg": 9.53;
         readonly "dark:accent-ink/accent-hover": 8.79;
         readonly "dark:text-muted/surface-2": 8.43;
         readonly "dark:text/surface-2": 11.1;
@@ -8949,6 +9749,7 @@ declare const SPEC_CONTRAST: {
         readonly "light:inverse-accent/inverse-bg": 13.71;
         readonly "light:success/success-bg": 5.41;
         readonly "light:danger/danger-bg": 5.01;
+        readonly "light:warning/warning-bg": 6.61;
         readonly "light:accent-ink/accent-hover": 7.72;
         readonly "light:text-muted/surface-2": 7.52;
         readonly "light:text/surface-2": 13.71;
@@ -8972,6 +9773,7 @@ declare const SPEC_CONTRAST: {
         readonly "dark:inverse-accent/inverse-bg": 5.59;
         readonly "dark:success/success-bg": 7.98;
         readonly "dark:danger/danger-bg": 7;
+        readonly "dark:warning/warning-bg": 9.53;
         readonly "dark:accent-ink/accent-hover": 9.2;
         readonly "dark:text-muted/surface-2": 7.59;
         readonly "dark:text/surface-2": 13.12;
@@ -9505,9 +10307,12 @@ declare function previewElementStyleAdoption(tree: AdoptableNode[] | null | unde
  * - the element-style MARKER `iox-es iox-es-<id>` (design-system §3b-bis) — component CSS carrying
  *   the system look is scoped to it, so a node saved before DS2 keeps its pre-DS2 look;
  * - the section colour scheme `iox-scheme-<id>` (§3c) for a non-default `colorScheme` — the class
- *   `compileSchemeCss` re-declares tokens on, so everything inside re-resolves.
+ *   `compileSchemeCss` re-declares tokens on, so everything inside re-resolves;
+ * - the composite ROLE `iox-role-<role>` (`card.media` → `iox-role-card-media`; composite-components
+ *   plan §3, Card v2) — what the shared CSS keys a part's structural rules on (the badge's corner, the
+ *   card's stretched link), so a role is never a renderer's private knowledge.
  *
- * Renderers read `elementStyle` and `colorScheme` for exactly this and nothing else.
+ * Renderers read `elementStyle`, `colorScheme` and `role` for exactly this and nothing else.
  */
 /** The section colour schemes — the contract's `schemes` keys. */
 declare enum ColorScheme {
@@ -9527,9 +10332,12 @@ declare const COLOR_SCHEMES: ReadonlyArray<{
 }>;
 /** `iox-scheme-<id>` for a known NON-default scheme, else null — an unknown id never reaches a class attribute. */
 declare function colorSchemeClass(id: unknown): string | null;
+/** `iox-role-<role>` for a well-formed composite role, else null. */
+declare function roleClass(role: unknown): string | null;
 /** The node shapes this module reads: a serialized node (`props`) or a builder node (`traits[]`). */
 interface DesignClassSource {
     elementStyle?: string | null;
+    role?: string | null;
     props?: Readonly<Record<string, unknown>> | null;
     traits?: ReadonlyArray<{
         name?: string;
@@ -9597,6 +10405,8 @@ declare function emptyImageSrc(node: {
  * (generation-core) writes it, the builder canvas and both engine render paths read it.
  */
 declare enum LinkType {
+    /** Links nowhere — a Heading's default; "Link the whole card" (Card v2) turns its title's link on. */
+    None = "none",
     External = "external",
     Page = "page"
 }
@@ -9613,6 +10423,23 @@ interface ButtonBlockLinkProps {
  * as its Link does.
  */
 declare function buttonBlockHref(props: ButtonBlockLinkProps, pageHref?: (route: string) => string): string | null;
+interface NodeLinkProps {
+    linkType?: unknown;
+    url?: unknown;
+    pageRoute?: unknown;
+}
+/** The class of the `<a>` a linked Heading renders — the Card v2 stretched link keys on it (iox-design.css:
+ *  the card is the click target, its buttons sit above, the focus ring is drawn on the card). */
+declare const CARD_LINK_CLASS = "iox-card-link";
+/** On the editing canvas the anchor carries this, so the stretched `::after` is off and every part of the
+ *  card stays clickable (board 8). */
+declare const CANVAS_LINK_ATTRIBUTE = "data-iox-canvas";
+/**
+ * The href a linked Heading renders (Card v2: the card's title IS its link), or `null` when it links
+ * nowhere — `none`, or a link with no target yet (the title then renders as plain words). A page link goes
+ * through `pageHref` exactly as a ButtonBlock's does.
+ */
+declare function headingHref(props: NodeLinkProps, pageHref?: (route: string) => string): string | null;
 
 /**
  * BRAND DERIVATION (flavors plan §6, F2): one colour in, an asserted accessible ramp out.
@@ -9808,7 +10635,9 @@ declare function preTintAccentGrounds(palette: FlavorPalette): {
  *   a gradient ground (Glass's mesh, Midnight's glow) checked at its worst stop;
  * - base and hover; a button's icon read through the contract's `inkScopes` (it takes the button's ink),
  *   its focus ring; the form parts the field baseline paints (`contrastAudit.formParts`); the form's
- *   Success / Error notices, in every scheme and container.
+ *   Success / Error notices, in every scheme and container;
+ * - a Badge's or Chip's icon through the same `inkScopes`, and text over an image (Card v2's "Image behind
+ *   text"): the block's ink over its scrim composited on the WORST-CASE image (`contrastAudit.scrims`).
  *
  * WCAG 2: 4.5:1 for text, 3:1 for glyphs, UI boundaries and focus indicators (1.4.11), judged on 8-bit
  * colours. The same audit gates the contract (`colour.mjs auditContrast`, every flavor × tint × a seed
@@ -10372,5 +11201,5 @@ interface FontFamilyRemoval {
  */
 declare function planFontFamilyRemoval(existing: ReadonlyArray<StoredDesignTokenRow>, previous: StoredDesign, family: string): FontFamilyRemoval;
 
-export { ACCENT_TOKEN_NAMES, AdoptOutcome, AdoptSkipReason, BUTTON_VARIANT_TO_STYLE, COLOR_SCHEMES, COLOR_SCHEME_TRAIT, COLOR_SCHEME_TYPES, ColorScheme, ColourCheckId, DEFAULT_FLAVOR_ID, DESIGN_TOKEN_GROUPS, DESIGN_TOKEN_TIERS, DESIGN_TOKEN_TYPES, DesignConfigKey, ELEMENT_STYLES, ELEMENT_STYLE_MARKER_CLASS, ELEMENT_STYLE_STATES, EMPTY_IMAGE_ATTRIBUTE, EMPTY_IMAGE_SRC, ElementStyleState, FLAVOR_SPEC_VERSION, FONT_CATALOG, FONT_FAMILY_TOKENS, FONT_FILE_ACCEPT, FONT_FILE_EXTENSIONS, FONT_FILE_FORMATS, FONT_STYLES, FONT_WEIGHTS, FontUploadError, GOOGLE_FONTS_CSS_ORIGIN, GOOGLE_FONTS_FILE_ORIGIN, HELD_CONTRAST, LinkType, MAX_FONT_FILE_BYTES, NEW_NODE_STYLE_DEFAULTS, OwnedTraitLink, PALETTE_PRESETS, PRE_DS2_FLAVOR_DEFAULTS, PRE_TINT_DEFAULT, REDUCED_MOTION_OVERRIDES, REDUCED_TRANSPARENCY_OVERRIDES, REVERT_WINDOW_MS, SPEC_A11Y, SPEC_AXES, SPEC_BUTTON_VARIANT_TO_STYLE, SPEC_CONTRAST, SPEC_CONTRAST_AUDIT, SPEC_DEFAULT_ELEMENT_STYLE, SPEC_ELEMENT_STYLES, SPEC_FIELD_CLASS_BASELINE, SPEC_FLAVORS, SPEC_FLAVOR_PACKS, SPEC_FONTS, SPEC_FONT_ROLES, SPEC_INK_SCOPES, SPEC_LEGACY_ALIASES, SPEC_PALETTE_PRESETS, SPEC_SCHEMES, SPEC_SPRINGS, SPEC_TIERS, SPEC_TIER_IDS, SPEC_TOKEN_TYPES, SUPERSEDED_STYLE_VALUES, SWISS_FLAVOR, TINT_FULL_CHROMA, TINT_IDS, TINT_LEVELS, TINT_OWN_HUE_CHROMA, TINT_TURN_CHROMA, USER_TOKEN_SOURCE, WCAG_AA_TEXT, WCAG_AA_UI, adoptElementStyles, adoptionStyleFor, apcaLc, applyElementStyle, applyHeadingLevelRule, atLightness, atLightnessMaxChroma, auditDesignContrast, buildFlavorTokens, buildFontFaceCss, buttonBlockHref, catalogFontId, checkFontWeight, choicesForPack, colorSchemeClass, colorSchemeOf, colourTabChecks, compareFontWeights, compileSchemeCss, compileTokenCss, compileTokenCssBlocks, compositeOver, cssString, defaultDesignChoices, defaultElementStyleFor, deriveAccentTokens, deriveBrandTokens, designBaseline, designConfigEntries, designModeOf, designTokenRepairs, designTokenRows, elementStyleById, elementStyleClass, elementStylesFor, emptyImageLabelSrc, emptyImagePlaceholder, emptyImageSrc, ensureAlpha, ensureContrast, flavorColours, flavorPackById, flavorSeedWrites, flavorSourceStamp, fontFamilyKey, fontFileName, fontFileStem, fontFormatOf, fontPreloads, fontRoleReferences, fontStackWithout, fontWeightCovers, fontWeightRange, fontWeightValue, fontsForTokens, formatFontFamilies, formatFontFamily, formatFontWeight, googleFontHref, groupFontFamilies, hasElementStyleMarker, inSrgbGamut, isDesignTokenGroup, isDesignTokenTier, isDesignTokenType, isFontWeightRange, isRetiredFlavorId, legacyDesignTokenRows, legacyFlavorTokens, legacyRuleTokenReferences, matchFontWeight, missingDesignRows, missingFontRoles, nodeDesignClasses, normalizeFontStyle, normalizeFontWeight, normalizeFontWeightValue, oklabToRgb, ownedTraitStatus, ownedTraitsOf, packDesignChoices, paintColours, parseCssColour, parseFontFamilies, parseFontWeight, parseHexColor, planDesignApply, planDesignRevert, planFlavorRevert, planFlavorSeed, planFontFamilyRemoval, planSwissMigration, preTintAccentGrounds, previewElementStyleAdoption, previewFontWeight, quantizeRgb, readDesignConfig, readOwnedTrait, relativeLuminance, resolveDesignChoices, resolveSchemeTokenValues, resolveTokenReferences, resolveTokenValues, revertAvailable, rgbToOklab, ringColour, sameDesignChoices, specTokenNames, splitTopLevel, springToLinear, stackNamesFamily, styleKeyToKebab, switchElementStyle, syncNodeDesignClasses, toHexColor, tokenReferences, tokensToDarkVarMap, tokensToVarMap, unknownTokenReferences, untouchedSeedRow, userFontStack, validateFlavorPack, wcagContrastRatio, writeOwnedTrait };
-export type { AccentBackgrounds, AccentGround, AccentTokenName, AdoptContext, AdoptReport, AdoptableNode, AdoptedNode, ApplyElementStyleResult, ButtonBlockLinkProps, ColourCheck, ColourFlavor, ContrastFinding, DensityId, DesignApplyOptions, DesignChoices, DesignClassSource, DesignConfigEntry, DesignMode, DesignTokenGroup, DesignTokenLike, DesignTokenRow, DesignTokenTier, DesignTokenType, ElementStyle, ElementStyleTarget, ElementStyleTraitLike, FlavorColours, FlavorPack, FlavorPackV2, FlavorPalette, FlavorRevertPlan, FlavorRevertSnapshot, FlavorRevertWrite, FlavorSeedOptions, FlavorSeedPlan, FlavorSpecToken, FlavorTintConfig, FlavorTokenDef, FontDescriptor, FontFamilyGroup, FontFamilyRemoval, FontFamilyToken, FontFormat, FontPair, FontRoleToken, FontStyle, FontWeight, FontWeightRange, FontsForTokensOptions, KeptEdit, LinearSpring, MissingFontRole, MotionId, OkLab, OwnedTrait, OwnedTraitStatus, PalettePreset, ResolvedMode, Rgb, Rgba, SchemeId, SeedBaseline, SeedExpectation, ShapeId, SkippedNode, StoredDesign, StoredDesignTokenRow, SupersededStyleValue, SwissMigration, SwitchElementStyleResult, TintId, TintLevel, TokenCssBlocks, TokenCssOptions };
+export { ACCENT_TOKEN_NAMES, AdoptOutcome, AdoptSkipReason, BUTTON_VARIANT_TO_STYLE, CANVAS_LINK_ATTRIBUTE, CARD_LINK_CLASS, COLOR_SCHEMES, COLOR_SCHEME_TRAIT, COLOR_SCHEME_TYPES, ColorScheme, ColourCheckId, DEFAULT_FLAVOR_ID, DESIGN_TOKEN_GROUPS, DESIGN_TOKEN_TIERS, DESIGN_TOKEN_TYPES, DesignConfigKey, ELEMENT_STYLES, ELEMENT_STYLE_MARKER_CLASS, ELEMENT_STYLE_STATES, EMPTY_IMAGE_ATTRIBUTE, EMPTY_IMAGE_SRC, ElementStyleState, FLAVOR_SPEC_VERSION, FONT_CATALOG, FONT_FAMILY_TOKENS, FONT_FILE_ACCEPT, FONT_FILE_EXTENSIONS, FONT_FILE_FORMATS, FONT_STYLES, FONT_WEIGHTS, FontUploadError, GOOGLE_FONTS_CSS_ORIGIN, GOOGLE_FONTS_FILE_ORIGIN, HELD_CONTRAST, LinkType, MAX_FONT_FILE_BYTES, NEW_NODE_STYLE_DEFAULTS, OwnedTraitLink, PALETTE_PRESETS, PRE_DS2_FLAVOR_DEFAULTS, PRE_TINT_DEFAULT, REDUCED_MOTION_OVERRIDES, REDUCED_TRANSPARENCY_OVERRIDES, REVERT_WINDOW_MS, SPEC_A11Y, SPEC_AXES, SPEC_BUTTON_VARIANT_TO_STYLE, SPEC_CONTRAST, SPEC_CONTRAST_AUDIT, SPEC_DEFAULT_ELEMENT_STYLE, SPEC_ELEMENT_STYLES, SPEC_FIELD_CLASS_BASELINE, SPEC_FLAVORS, SPEC_FLAVOR_PACKS, SPEC_FONTS, SPEC_FONT_ROLES, SPEC_INK_SCOPES, SPEC_LEGACY_ALIASES, SPEC_PALETTE_PRESETS, SPEC_SCHEMES, SPEC_SPRINGS, SPEC_TIERS, SPEC_TIER_IDS, SPEC_TOKEN_TYPES, SUPERSEDED_STYLE_VALUES, SWISS_FLAVOR, TINT_FULL_CHROMA, TINT_IDS, TINT_LEVELS, TINT_OWN_HUE_CHROMA, TINT_TURN_CHROMA, USER_TOKEN_SOURCE, WCAG_AA_TEXT, WCAG_AA_UI, adoptElementStyles, adoptionStyleFor, apcaLc, applyElementStyle, applyHeadingLevelRule, atLightness, atLightnessMaxChroma, auditDesignContrast, buildFlavorTokens, buildFontFaceCss, buttonBlockHref, catalogFontId, checkFontWeight, choicesForPack, colorSchemeClass, colorSchemeOf, colourTabChecks, compareFontWeights, compileSchemeCss, compileTokenCss, compileTokenCssBlocks, compositeOver, cssString, defaultDesignChoices, defaultElementStyleFor, deriveAccentTokens, deriveBrandTokens, designBaseline, designConfigEntries, designModeOf, designTokenRepairs, designTokenRows, elementStyleById, elementStyleClass, elementStylesFor, emptyImageLabelSrc, emptyImagePlaceholder, emptyImageSrc, ensureAlpha, ensureContrast, flavorColours, flavorPackById, flavorSeedWrites, flavorSourceStamp, fontFamilyKey, fontFileName, fontFileStem, fontFormatOf, fontPreloads, fontRoleReferences, fontStackWithout, fontWeightCovers, fontWeightRange, fontWeightValue, fontsForTokens, formatFontFamilies, formatFontFamily, formatFontWeight, googleFontHref, groupFontFamilies, hasElementStyleMarker, headingHref, inSrgbGamut, isDesignTokenGroup, isDesignTokenTier, isDesignTokenType, isFontWeightRange, isRetiredFlavorId, legacyDesignTokenRows, legacyFlavorTokens, legacyRuleTokenReferences, matchFontWeight, missingDesignRows, missingFontRoles, nodeDesignClasses, normalizeFontStyle, normalizeFontWeight, normalizeFontWeightValue, oklabToRgb, ownedTraitStatus, ownedTraitsOf, packDesignChoices, paintColours, parseCssColour, parseFontFamilies, parseFontWeight, parseHexColor, planDesignApply, planDesignRevert, planFlavorRevert, planFlavorSeed, planFontFamilyRemoval, planSwissMigration, preTintAccentGrounds, previewElementStyleAdoption, previewFontWeight, quantizeRgb, readDesignConfig, readOwnedTrait, relativeLuminance, resolveDesignChoices, resolveSchemeTokenValues, resolveTokenReferences, resolveTokenValues, revertAvailable, rgbToOklab, ringColour, roleClass, sameDesignChoices, specTokenNames, splitTopLevel, springToLinear, stackNamesFamily, styleKeyToKebab, switchElementStyle, syncNodeDesignClasses, toHexColor, tokenReferences, tokensToDarkVarMap, tokensToVarMap, unknownTokenReferences, untouchedSeedRow, userFontStack, validateFlavorPack, wcagContrastRatio, writeOwnedTrait };
+export type { AccentBackgrounds, AccentGround, AccentTokenName, AdoptContext, AdoptReport, AdoptableNode, AdoptedNode, ApplyElementStyleResult, ButtonBlockLinkProps, ColourCheck, ColourFlavor, ContrastFinding, DensityId, DesignApplyOptions, DesignChoices, DesignClassSource, DesignConfigEntry, DesignMode, DesignTokenGroup, DesignTokenLike, DesignTokenRow, DesignTokenTier, DesignTokenType, ElementStyle, ElementStyleTarget, ElementStyleTraitLike, FlavorColours, FlavorPack, FlavorPackV2, FlavorPalette, FlavorRevertPlan, FlavorRevertSnapshot, FlavorRevertWrite, FlavorSeedOptions, FlavorSeedPlan, FlavorSpecToken, FlavorTintConfig, FlavorTokenDef, FontDescriptor, FontFamilyGroup, FontFamilyRemoval, FontFamilyToken, FontFormat, FontPair, FontRoleToken, FontStyle, FontWeight, FontWeightRange, FontsForTokensOptions, KeptEdit, LinearSpring, MissingFontRole, MotionId, NodeLinkProps, OkLab, OwnedTrait, OwnedTraitStatus, PalettePreset, ResolvedMode, Rgb, Rgba, SchemeId, SeedBaseline, SeedExpectation, ShapeId, SkippedNode, StoredDesign, StoredDesignTokenRow, SupersededStyleValue, SwissMigration, SwitchElementStyleResult, TintId, TintLevel, TokenCssBlocks, TokenCssOptions };