@marioschmidt/design-system-tokens 1.1.0 → 1.2.0

package/dist/json/brands/sportbild/semantic/color/colormode-light.json

@@ -20,7 +20,7 @@
             "variableId": "VariableID:16107:27"
           },
           "$type": "color",
-          "comment": "Applies to text elements requiring fixed brand color usage (e.g., permanent links, brand slogans on constant backgrounds). Behavior: Constant — maintains identical red tone across Light and Dark mode.",
+          "comment": "Brand-colored text for emphasis and highlights (e.g., highlighted keywords, brand callouts, promotional text). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -41,7 +41,7 @@
               "variableId": "VariableID:16107:27"
             },
             "$type": "color",
-            "comment": "Applies to text elements requiring fixed brand color usage (e.g., permanent links, brand slogans on constant backgrounds). Behavior: Constant — maintains identical red tone across Light and Dark mode."
+            "comment": "Brand-colored text for emphasis and highlights (e.g., highlighted keywords, brand callouts, promotional text). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "textColorBrand",
           "attributes": {},
@@ -70,7 +70,7 @@
             "variableId": "VariableID:16107:27"
           },
           "$type": "color",
-          "comment": "Accent text color used for links, interactive text, or highlighted key words. Changes from a red in light mode to a white in dark mode.",
+          "comment": "Brand text color in light mode, neutral white in dark mode (e.g., subtle brand accents that shouldn't be vibrant in dark). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -91,7 +91,7 @@
               "variableId": "VariableID:16107:27"
             },
             "$type": "color",
-            "comment": "Accent text color used for links, interactive text, or highlighted key words. Changes from a red in light mode to a white in dark mode."
+            "comment": "Brand text color in light mode, neutral white in dark mode (e.g., subtle brand accents that shouldn't be vibrant in dark). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "textColorBrandLightOnly",
           "attributes": {},
@@ -122,7 +122,7 @@
             "variableId": "VariableID:588:1977"
           },
           "$type": "color",
-          "comment": "Main text color used for body copy and all primary textual content. Ensures optimal readability and contrast on standard surfaces. Behavior: Dynamic — switches between dark text on light backgrounds and light text on dark backgrounds.",
+          "comment": "Primary text color for static content like body copy and labels (e.g., article text, titles, form labels). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -143,7 +143,7 @@
               "variableId": "VariableID:588:1977"
             },
             "$type": "color",
-            "comment": "Main text color used for body copy and all primary textual content. Ensures optimal readability and contrast on standard surfaces. Behavior: Dynamic — switches between dark text on light backgrounds and light text on dark backgrounds."
+            "comment": "Primary text color for static content like body copy and labels (e.g., article text, titles, form labels). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "textColorPrimary",
           "attributes": {},
@@ -172,7 +172,7 @@
             "variableId": "VariableID:3912:4271"
           },
           "$type": "color",
-          "comment": "Muted text tone for subtle information, timestamps, or inactive text elements. Behavior: Dynamic — adjusts between mid-gray in Light mode and lighter gray in Dark mode.",
+          "comment": "Secondary text color for static supporting content (e.g., captions, timestamps, meta information, descriptions). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -193,7 +193,7 @@
               "variableId": "VariableID:3912:4271"
             },
             "$type": "color",
-            "comment": "Muted text tone for subtle information, timestamps, or inactive text elements. Behavior: Dynamic — adjusts between mid-gray in Light mode and lighter gray in Dark mode."
+            "comment": "Secondary text color for static supporting content (e.g., captions, timestamps, meta information, descriptions). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "textColorSecondary",
           "attributes": {},
@@ -222,7 +222,7 @@
             "variableId": "VariableID:21692:48910"
           },
           "$type": "color",
-          "comment": "Secondary text color used for supportive information, subtitles, and less prominent text. Behavior: Dynamic — adapts between neutral tones to maintain proper contrast per theme. In 2025 css it is called figure meta.",
+          "comment": "Tertiary text color for static de-emphasized content (e.g., placeholder text, helper text, footnotes). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -243,7 +243,7 @@
               "variableId": "VariableID:21692:48910"
             },
             "$type": "color",
-            "comment": "Secondary text color used for supportive information, subtitles, and less prominent text. Behavior: Dynamic — adapts between neutral tones to maintain proper contrast per theme. In 2025 css it is called figure meta."
+            "comment": "Tertiary text color for static de-emphasized content (e.g., placeholder text, helper text, footnotes). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "textColorTertiary",
           "attributes": {},
@@ -274,7 +274,7 @@
             "variableId": "VariableID:21692:48286"
           },
           "$type": "color",
-          "comment": "Used for kicker text and category labels placed directly on standard surface backgrounds. Behavior: Dynamic — adjusts between red for Light and a neutral tone in Dark modes.",
+          "comment": "Kicker text color for category labels above headlines on standard surface backgrounds. Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -295,7 +295,7 @@
               "variableId": "VariableID:21692:48286"
             },
             "$type": "color",
-            "comment": "Used for kicker text and category labels placed directly on standard surface backgrounds. Behavior: Dynamic — adjusts between red for Light and a neutral tone in Dark modes."
+            "comment": "Kicker text color for category labels above headlines on standard surface backgrounds. Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "kickerTextColor",
           "attributes": {},
@@ -324,7 +324,7 @@
             "variableId": "VariableID:16107:28"
           },
           "$type": "color",
-          "comment": "Primary color for headings and display typography. Ensures clear hierarchy and optimal readability on main surfaces. Adapds it´s color based on the brand mode for brand recognition. Behavior: Dynamic — dark text in Light mode, light text in Dark mode.",
+          "comment": "Headline text color for article titles and major headings. Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -345,7 +345,7 @@
               "variableId": "VariableID:16107:28"
             },
             "$type": "color",
-            "comment": "Primary color for headings and display typography. Ensures clear hierarchy and optimal readability on main surfaces. Adapds it´s color based on the brand mode for brand recognition. Behavior: Dynamic — dark text in Light mode, light text in Dark mode."
+            "comment": "Headline text color for article titles and major headings. Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "headlineTextColor",
           "attributes": {},
@@ -376,7 +376,7 @@
             "variableId": "VariableID:588:1978"
           },
           "$type": "color",
-          "comment": "Fixed white heading color used on dark or colored backgrounds (e.g., hero sections, banners) that remain constant across modes. Behavior: Constant — remains white in both Light and Dark mode.",
+          "comment": "Text color for content overlaid on images, mode-independent (e.g., image captions, teaser headlines on photos). Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -397,7 +397,7 @@
               "variableId": "VariableID:588:1978"
             },
             "$type": "color",
-            "comment": "Fixed white heading color used on dark or colored backgrounds (e.g., hero sections, banners) that remain constant across modes. Behavior: Constant — remains white in both Light and Dark mode."
+            "comment": "Text color for content overlaid on images, mode-independent (e.g., image captions, teaser headlines on photos). Behavior: Static — same value in light and dark mode."
           },
           "name": "textColorOnImage",
           "attributes": {},
@@ -426,7 +426,7 @@
             "variableId": "VariableID:2881:1765"
           },
           "$type": "color",
-          "comment": "Fixed inverse label tone applied where white or bright text must always appear, regardless of theme. Behavior: Constant — remains bright neutral in both Light and Dark mode. L&D:093",
+          "comment": "Secondary text on dark solid surfaces, mode-independent. Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -447,7 +447,7 @@
               "variableId": "VariableID:2881:1765"
             },
             "$type": "color",
-            "comment": "Fixed inverse label tone applied where white or bright text must always appear, regardless of theme. Behavior: Constant — remains bright neutral in both Light and Dark mode. L&D:093"
+            "comment": "Secondary text on dark solid surfaces, mode-independent. Behavior: Static — same value in light and dark mode."
           },
           "name": "textColorSecondaryOnDark",
           "attributes": {},
@@ -476,7 +476,7 @@
             "variableId": "VariableID:588:1977"
           },
           "$type": "color",
-          "comment": "Used when primary text color must remain fixed regardless of mode (e.g., on light constant backgrounds). Behavior: Constant — same tone across Light and Dark mode.",
+          "comment": "Primary text on light solid surfaces, mode-independent (e.g., text on light colored backgrounds). Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -497,7 +497,7 @@
               "variableId": "VariableID:588:1977"
             },
             "$type": "color",
-            "comment": "Used when primary text color must remain fixed regardless of mode (e.g., on light constant backgrounds). Behavior: Constant — same tone across Light and Dark mode."
+            "comment": "Primary text on light solid surfaces, mode-independent (e.g., text on light colored backgrounds). Behavior: Static — same value in light and dark mode."
           },
           "name": "textColorPrimaryOnLight",
           "attributes": {},
@@ -626,7 +626,7 @@
             "variableId": "VariableID:588:1978"
           },
           "$type": "color",
-          "comment": "Used for text displayed on dark surfaces to ensure maximum legibility and contrast. Behavior: Constant — always light neutral to guarantee accessibility on dark backgrounds.",
+          "comment": "Primary text on dark solid surfaces, mode-independent (e.g., button labels on dark buttons). Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -647,7 +647,7 @@
               "variableId": "VariableID:588:1978"
             },
             "$type": "color",
-            "comment": "Used for text displayed on dark surfaces to ensure maximum legibility and contrast. Behavior: Constant — always light neutral to guarantee accessibility on dark backgrounds."
+            "comment": "Primary text on dark solid surfaces, mode-independent (e.g., button labels on dark buttons). Behavior: Static — same value in light and dark mode."
           },
           "name": "textColorPrimaryOnDark",
           "attributes": {},
@@ -678,7 +678,7 @@
             "variableId": "VariableID:18489:25069"
           },
           "$type": "color",
-          "comment": "Primary label color used for labels, badges, or tag text on light backgrounds. Ensures strong readability and visual hierarchy. Behavior: Dynamic — dark neutral in Light mode, light neutral in Dark mode. L: 015 D:093",
+          "comment": "Default text color for interactive/clickable elements in idle state (e.g., text links, navigation items, clickable labels). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -699,7 +699,7 @@
               "variableId": "VariableID:18489:25069"
             },
             "$type": "color",
-            "comment": "Primary label color used for labels, badges, or tag text on light backgrounds. Ensures strong readability and visual hierarchy. Behavior: Dynamic — dark neutral in Light mode, light neutral in Dark mode. L: 015 D:093"
+            "comment": "Default text color for interactive/clickable elements in idle state (e.g., text links, navigation items, clickable labels). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "textColorIdle",
           "attributes": {},
@@ -728,7 +728,7 @@
             "variableId": "VariableID:21692:48285"
           },
           "$type": "color",
-          "comment": "Disabled label tone indicating inactive or unavailable states in UI elements. Behavior: Dynamic — lighter gray in Light mode, darker neutral in Dark mode. L:085 D:035",
+          "comment": "Text color for disabled elements (e.g., inactive button labels, disabled input text/links). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -749,7 +749,7 @@
               "variableId": "VariableID:21692:48285"
             },
             "$type": "color",
-            "comment": "Disabled label tone indicating inactive or unavailable states in UI elements. Behavior: Dynamic — lighter gray in Light mode, darker neutral in Dark mode. L:085 D:035"
+            "comment": "Text color for disabled elements (e.g., inactive button labels, disabled input text/links). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "textColorDisabled",
           "attributes": {},
@@ -778,6 +778,7 @@
             "variableId": "VariableID:21764:1044"
           },
           "$type": "color",
+          "comment": "Text color for interactive/clickable elements on hover (e.g., link hover, navigation item hover). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -797,7 +798,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21764:1044"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Text color for interactive/clickable elements on hover (e.g., link hover, navigation item hover). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "textColorHover",
           "attributes": {},
@@ -826,6 +828,7 @@
             "variableId": "VariableID:21764:1044"
           },
           "$type": "color",
+          "comment": "Text color for interactive/clickable elements in active or visited state (e.g., visited links, active navigation item, current page). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -845,7 +848,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21764:1044"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Text color for interactive/clickable elements in active or visited state (e.g., visited links, active navigation item, current page). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "textColorActive",
           "attributes": {},
@@ -876,7 +880,7 @@
             "variableId": "VariableID:21692:48287"
           },
           "$type": "color",
-          "comment": "Inverse text color used on opposing surfaces (e.g., white text on red or dark backgrounds). Behavior: Dynamic — alternates between light and dark mode.",
+          "comment": "Primary static text on inverted/contrast backgrounds (e.g., body text in dark sections, footer copy). Not for interactive elements. Behavior: Inverted — swaps light and dark values. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -897,7 +901,7 @@
               "variableId": "VariableID:21692:48287"
             },
             "$type": "color",
-            "comment": "Inverse text color used on opposing surfaces (e.g., white text on red or dark backgrounds). Behavior: Dynamic — alternates between light and dark mode."
+            "comment": "Primary static text on inverted/contrast backgrounds (e.g., body text in dark sections, footer copy). Not for interactive elements. Behavior: Inverted — swaps light and dark values. Brand-specific."
           },
           "name": "textColorPrimaryInverse",
           "attributes": {},
@@ -926,6 +930,7 @@
             "variableId": "VariableID:21692:48285"
           },
           "$type": "color",
+          "comment": "Secondary static text on inverted/contrast backgrounds (e.g., meta info in dark sections). Not for interactive elements. Behavior: Inverted — swaps light and dark values. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -945,7 +950,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21692:48285"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Secondary static text on inverted/contrast backgrounds (e.g., meta info in dark sections). Not for interactive elements. Behavior: Inverted — swaps light and dark values. Brand-specific."
           },
           "name": "textColorSecondaryInverse",
           "attributes": {},
@@ -974,6 +980,7 @@
             "variableId": "VariableID:588:1978"
           },
           "$type": "color",
+          "comment": "High contrast inverse text for maximum readability on inverted surfaces (e.g., white text on dark buttons). Behavior: Inverted — swaps light and dark values.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -993,7 +1000,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:588:1978"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "High contrast inverse text for maximum readability on inverted surfaces (e.g., white text on dark buttons). Behavior: Inverted — swaps light and dark values."
           },
           "name": "textColorInverseHighContrast",
           "attributes": {},
@@ -1024,7 +1032,7 @@
             "variableId": "VariableID:9697:16953"
           },
           "$type": "color",
-          "comment": "Used for positive or success-related messages (e.g., “Saved”, “Success”, or confirmation text) on success surface colors. Behavior: Constant — green tone remains consistent across both modes.",
+          "comment": "Success text color for confirmation messages and positive feedback. Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1045,7 +1053,7 @@
               "variableId": "VariableID:9697:16953"
             },
             "$type": "color",
-            "comment": "Used for positive or success-related messages (e.g., “Saved”, “Success”, or confirmation text) on success surface colors. Behavior: Constant — green tone remains consistent across both modes."
+            "comment": "Success text color for confirmation messages and positive feedback. Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "textColorSuccess",
           "attributes": {},
@@ -1074,7 +1082,7 @@
             "variableId": "VariableID:2580:18750"
           },
           "$type": "color",
-          "comment": "Used for strong warnings, errors, or destructive action labels. Behavior: Constant — red color remains unchanged between Light and Dark mode for visibility and recognition.",
+          "comment": "Error text color for error messages and validation feedback. Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1095,7 +1103,7 @@
               "variableId": "VariableID:2580:18750"
             },
             "$type": "color",
-            "comment": "Used for strong warnings, errors, or destructive action labels. Behavior: Constant — red color remains unchanged between Light and Dark mode for visibility and recognition."
+            "comment": "Error text color for error messages and validation feedback. Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "textColorError",
           "attributes": {},
@@ -1124,7 +1132,7 @@
             "variableId": "VariableID:21678:1561"
           },
           "$type": "color",
-          "comment": "Represents medium attention states, often used in warnings or pending states. Behavior: Constant — same orange tone across Light and Dark mode.",
+          "comment": "Warning text color for caution messages and alerts. Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1145,7 +1153,7 @@
               "variableId": "VariableID:21678:1561"
             },
             "$type": "color",
-            "comment": "Represents medium attention states, often used in warnings or pending states. Behavior: Constant — same orange tone across Light and Dark mode."
+            "comment": "Warning text color for caution messages and alerts. Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "textColorWarning",
           "attributes": {},
@@ -1178,7 +1186,7 @@
             "variableId": "VariableID:588:1978"
           },
           "$type": "color",
-          "comment": "Primary surface color used for main backgrounds and large layout areas (e.g., page background, primary containers). Behavior: Dynamic — adapts between light and dark surface tokens to maintain legibility and hierarchy.",
+          "comment": "Primary background color for main surfaces and page backgrounds (e.g., page background, primary containers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific in dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1199,7 +1207,7 @@
               "variableId": "VariableID:588:1978"
             },
             "$type": "color",
-            "comment": "Primary surface color used for main backgrounds and large layout areas (e.g., page background, primary containers). Behavior: Dynamic — adapts between light and dark surface tokens to maintain legibility and hierarchy."
+            "comment": "Primary background color for main surfaces and page backgrounds (e.g., page background, primary containers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific in dark mode."
           },
           "name": "bgColorPrimary",
           "attributes": {},
@@ -1228,7 +1236,7 @@
             "variableId": "VariableID:16104:163546"
           },
           "$type": "color",
-          "comment": "Defines the disabled color for primary components (e.g., disabled primary buttons, inputs). Reduces emphasis and contrast to signal inactivity. Behavior: Dynamic - slightly lighter in Light mode and darker in Dark mode to remain visually accessible.",
+          "comment": "Background color for disabled interactive elements (e.g., inactive buttons, disabled inputs). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1249,7 +1257,7 @@
               "variableId": "VariableID:16104:163546"
             },
             "$type": "color",
-            "comment": "Defines the disabled color for primary components (e.g., disabled primary buttons, inputs). Reduces emphasis and contrast to signal inactivity. Behavior: Dynamic - slightly lighter in Light mode and darker in Dark mode to remain visually accessible."
+            "comment": "Background color for disabled interactive elements (e.g., inactive buttons, disabled inputs). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "bgColorDisabled",
           "attributes": {},
@@ -1278,7 +1286,7 @@
             "variableId": "VariableID:16104:163546"
           },
           "$type": "color",
-          "comment": "Used for secondary surface layers such as cards, panels, or nested containers that need to differentiate themselves from the primary surface.  Behavior: Dynamic — adapts brightness level based on mode for appropriate depth contrast.",
+          "comment": "Secondary background for elevated containers (e.g., cards on primary background, sidebar panels). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1299,7 +1307,7 @@
               "variableId": "VariableID:16104:163546"
             },
             "$type": "color",
-            "comment": "Used for secondary surface layers such as cards, panels, or nested containers that need to differentiate themselves from the primary surface.  Behavior: Dynamic — adapts brightness level based on mode for appropriate depth contrast."
+            "comment": "Secondary background for elevated containers (e.g., cards on primary background, sidebar panels). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "bgColorSecondary",
           "attributes": {},
@@ -1328,7 +1336,7 @@
             "variableId": "VariableID:21764:1044"
           },
           "$type": "color",
-          "comment": "A fixed dark surface tone used for dark overlays or nested dark sections inside light layouts. Behavior: Constant — identical across Light and Dark mode.",
+          "comment": "Dark background that remains constant regardless of color mode (e.g. media containers). Behavior: Static — same value in light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1349,7 +1357,7 @@
               "variableId": "VariableID:21764:1044"
             },
             "$type": "color",
-            "comment": "A fixed dark surface tone used for dark overlays or nested dark sections inside light layouts. Behavior: Constant — identical across Light and Dark mode."
+            "comment": "Dark background that remains constant regardless of color mode (e.g. media containers). Behavior: Static — same value in light and dark mode. Brand-specific."
           },
           "name": "bgColorPrimaryConstDark",
           "attributes": {},
@@ -1378,7 +1386,7 @@
             "variableId": "VariableID:16104:163547"
           },
           "$type": "color",
-          "comment": "HIghtest elevation surface color, typically used for grouping or background accents to differentiate themselves from all previous surface color options. Uses corresponding light/dark tones for consistent layering.",
+          "comment": "Quaternary background for fourth-level elements (e.g., pressed states, nested backgrounds). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1399,7 +1407,7 @@
               "variableId": "VariableID:16104:163547"
             },
             "$type": "color",
-            "comment": "HIghtest elevation surface color, typically used for grouping or background accents to differentiate themselves from all previous surface color options. Uses corresponding light/dark tones for consistent layering."
+            "comment": "Quaternary background for fourth-level elements (e.g., pressed states, nested backgrounds). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "bgColorQuaternary",
           "attributes": {},
@@ -1428,7 +1436,7 @@
             "variableId": "VariableID:21692:48287"
           },
           "$type": "color",
-          "comment": "Tertiary background layer for inner containers, grouped content, or subtle elevation steps  that need to differentiate themselves from the primary and secondary surfaces. Behavior: Dynamic — switches between light and dark tertiary tones.",
+          "comment": "Tertiary background for third-level containers (e.g., input fields, nested cards, hover states). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1449,7 +1457,7 @@
               "variableId": "VariableID:21692:48287"
             },
             "$type": "color",
-            "comment": "Tertiary background layer for inner containers, grouped content, or subtle elevation steps  that need to differentiate themselves from the primary and secondary surfaces. Behavior: Dynamic — switches between light and dark tertiary tones."
+            "comment": "Tertiary background for third-level containers (e.g., input fields, nested cards, hover states). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "bgColorTertiary",
           "attributes": {},
@@ -1478,7 +1486,7 @@
             "variableId": "VariableID:588:1978"
           },
           "$type": "color",
-          "comment": "Use this on elements that must maintain the white color even in dark mode.",
+          "comment": "Light background that remains constant regardless of color mode (e.g., fixed white elements). Behavior: Static — same value in light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1499,7 +1507,7 @@
               "variableId": "VariableID:588:1978"
             },
             "$type": "color",
-            "comment": "Use this on elements that must maintain the white color even in dark mode."
+            "comment": "Light background that remains constant regardless of color mode (e.g., fixed white elements). Behavior: Static — same value in light and dark mode. Brand-specific."
           },
           "name": "bgColorPrimaryConstLight",
           "attributes": {},
@@ -1528,6 +1536,7 @@
             "variableId": "VariableID:21692:48286"
           },
           "$type": "color",
+          "comment": "Quintenary background for fifth-level elements and high-contrast utility surfaces. Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1547,7 +1556,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21692:48286"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Quintenary background for fifth-level elements and high-contrast utility surfaces. Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "bgColorQuintenary",
           "attributes": {},
@@ -1578,7 +1588,7 @@
             "variableId": "VariableID:16107:27"
           },
           "$type": "color",
-          "comment": "Primary accent color used to emphasize interactive or highlight elements such as links, selection states, or focus indicators. Adapts in Darkmode to a fully white tone.",
+          "comment": "Brand background in light mode, neutral white in dark mode (e.g., accent elements that shouldn't be vibrant in dark). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1599,7 +1609,7 @@
               "variableId": "VariableID:16107:27"
             },
             "$type": "color",
-            "comment": "Primary accent color used to emphasize interactive or highlight elements such as links, selection states, or focus indicators. Adapts in Darkmode to a fully white tone."
+            "comment": "Brand background in light mode, neutral white in dark mode (e.g., accent elements that shouldn't be vibrant in dark). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "bgColorBrandLightOnly",
           "attributes": {},
@@ -1628,7 +1638,7 @@
             "variableId": "VariableID:16107:27"
           },
           "$type": "color",
-          "comment": "Used for accent highlights that must remain visually consistent across themes (e.g., brand identifiers, logos, or fixed emphasis areas). Color value does not change between Light and Dark mode.",
+          "comment": "Solid brand background for primary CTAs and brand-emphasized elements (e.g., primary buttons, badges). Behavior: Static — same value in light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1649,7 +1659,7 @@
               "variableId": "VariableID:16107:27"
             },
             "$type": "color",
-            "comment": "Used for accent highlights that must remain visually consistent across themes (e.g., brand identifiers, logos, or fixed emphasis areas). Color value does not change between Light and Dark mode."
+            "comment": "Solid brand background for primary CTAs and brand-emphasized elements (e.g., primary buttons, badges). Behavior: Static — same value in light and dark mode. Brand-specific."
           },
           "name": "bgColorBrandSolid",
           "attributes": {},
@@ -1678,6 +1688,7 @@
             "variableId": "VariableID:16107:28"
           },
           "$type": "color",
+          "comment": "Solid brand background for hover interactions (e.g., CTA button hover). Behavior: Static — same value in light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1697,7 +1708,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:16107:28"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Solid brand background for hover interactions (e.g., CTA button hover). Behavior: Static — same value in light and dark mode. Brand-specific."
           },
           "name": "bgColorBrandSolidHover",
           "attributes": {},
@@ -1726,6 +1738,7 @@
             "variableId": "VariableID:16107:29"
           },
           "$type": "color",
+          "comment": "Solid brand background for active/pressed state (e.g., CTA button pressed). Behavior: Static — same value in light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1745,7 +1758,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:16107:29"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Solid brand background for active/pressed state (e.g., CTA button pressed). Behavior: Static — same value in light and dark mode. Brand-specific."
           },
           "name": "bgColorBrandSolidActive",
           "attributes": {},
@@ -1774,6 +1788,7 @@
             "variableId": "VariableID:21692:48287"
           },
           "$type": "color",
+          "comment": "Subtle brand tint background for soft brand presence (e.g., notification backgrounds, selected list items). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1793,7 +1808,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21692:48287"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Subtle brand tint background for soft brand presence (e.g., notification backgrounds, selected list items). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "bgColorBrandTint",
           "attributes": {},
@@ -1822,6 +1838,7 @@
             "variableId": "VariableID:16104:163547"
           },
           "$type": "color",
+          "comment": "Subtle brand tint background for hover state (e.g., secondary button hover). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1841,7 +1858,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:16104:163547"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Subtle brand tint background for hover state (e.g., secondary button hover). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "bgColorBrandTintHover",
           "attributes": {},
@@ -1872,7 +1890,7 @@
             "variableId": "VariableID:21764:1044"
           },
           "$type": "color",
-          "comment": "Inverse of the primary surface, used when Light and Dark surfaces are swapped (e.g., inverse cards or elevated sections). Behavior: Dynamic — switches between dark and light values depending on mode.",
+          "comment": "nverted primary background for contrast sections (e.g., dark header on light page, footer). Behavior: Inverted — swaps light and dark values. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1893,7 +1911,7 @@
               "variableId": "VariableID:21764:1044"
             },
             "$type": "color",
-            "comment": "Inverse of the primary surface, used when Light and Dark surfaces are swapped (e.g., inverse cards or elevated sections). Behavior: Dynamic — switches between dark and light values depending on mode."
+            "comment": "nverted primary background for contrast sections (e.g., dark header on light page, footer). Behavior: Inverted — swaps light and dark values. Brand-specific."
           },
           "name": "bgColorPrimaryInverse",
           "attributes": {},
@@ -1922,7 +1940,7 @@
             "variableId": "VariableID:21764:1045"
           },
           "$type": "color",
-          "comment": "Inverse tertiary background, applied when Light and Dark surfaces are reversed (e.g., dark-on-light cards). Behavior: Dynamic — swaps values between modes for contrast preservation.",
+          "comment": "Inverted tertiary background for nested contrast elements (e.g., code blocks, nested menus). Behavior: Inverted — swaps light and dark values. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1943,7 +1961,7 @@
               "variableId": "VariableID:21764:1045"
             },
             "$type": "color",
-            "comment": "Inverse tertiary background, applied when Light and Dark surfaces are reversed (e.g., dark-on-light cards). Behavior: Dynamic — swaps values between modes for contrast preservation."
+            "comment": "Inverted tertiary background for nested contrast elements (e.g., code blocks, nested menus). Behavior: Inverted — swaps light and dark values. Brand-specific."
           },
           "name": "bgColorTertiaryInverse",
           "attributes": {},
@@ -1972,7 +1990,7 @@
             "variableId": "VariableID:16107:27"
           },
           "$type": "color",
-          "comment": "Inverse of the quartenary surface, used for background reversals in mixed-layout areas. Behavior: Dynamic — inverts between dark and light tones depending on mode.",
+          "comment": "Inverted quaternary background for subtle contrast distinctions. Behavior: Inverted — swaps light and dark values. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -1993,7 +2011,7 @@
               "variableId": "VariableID:16107:27"
             },
             "$type": "color",
-            "comment": "Inverse of the quartenary surface, used for background reversals in mixed-layout areas. Behavior: Dynamic — inverts between dark and light tones depending on mode."
+            "comment": "Inverted quaternary background for subtle contrast distinctions. Behavior: Inverted — swaps light and dark values. Brand-specific."
           },
           "name": "bgColorQuaternaryInverse",
           "attributes": {},
@@ -2022,7 +2040,7 @@
             "variableId": "VariableID:16107:28"
           },
           "$type": "color",
-          "comment": "Inverse of the primary surface, used when Light and Dark surfaces are swapped (e.g., inverse cards or elevated sections). Behavior: Dynamic — switches between dark and light values depending on mode.",
+          "comment": "Inverted secondary background for elevated contrast elements (e.g., tooltips, popovers). Behavior: Inverted — swaps light and dark values. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2043,7 +2061,7 @@
               "variableId": "VariableID:16107:28"
             },
             "$type": "color",
-            "comment": "Inverse of the primary surface, used when Light and Dark surfaces are swapped (e.g., inverse cards or elevated sections). Behavior: Dynamic — switches between dark and light values depending on mode."
+            "comment": "Inverted secondary background for elevated contrast elements (e.g., tooltips, popovers). Behavior: Inverted — swaps light and dark values. Brand-specific."
           },
           "name": "bgColorSecondaryInverse",
           "attributes": {},
@@ -2072,7 +2090,7 @@
             "variableId": "VariableID:21692:48286"
           },
           "$type": "color",
-          "comment": "Inverse of the quartenary surface, used for background reversals in mixed-layout areas. Behavior: Dynamic — inverts between dark and light tones depending on mode.",
+          "comment": "Inverted quintenary background for high-contrast inverse elements. Behavior: Inverted — swaps light and dark values. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2093,7 +2111,7 @@
               "variableId": "VariableID:21692:48286"
             },
             "$type": "color",
-            "comment": "Inverse of the quartenary surface, used for background reversals in mixed-layout areas. Behavior: Dynamic — inverts between dark and light tones depending on mode."
+            "comment": "Inverted quintenary background for high-contrast inverse elements. Behavior: Inverted — swaps light and dark values. Brand-specific."
           },
           "name": "bgColorQuintenaryInverse",
           "attributes": {},
@@ -2124,7 +2142,7 @@
             "variableId": "VariableID:21692:44618"
           },
           "$type": "color",
-          "comment": "Success-related background used for positive notifications, confirmation surfaces, or success banners. Behavior: Constant — remains the same across Light and Dark mode to ensure brand alignment.",
+          "comment": "Success feedback background for positive states (e.g., success message background, validated field). Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2145,7 +2163,7 @@
               "variableId": "VariableID:21692:44618"
             },
             "$type": "color",
-            "comment": "Success-related background used for positive notifications, confirmation surfaces, or success banners. Behavior: Constant — remains the same across Light and Dark mode to ensure brand alignment."
+            "comment": "Success feedback background for positive states (e.g., success message background, validated field). Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "bgColorSuccessTint",
           "attributes": {},
@@ -2174,7 +2192,7 @@
             "variableId": "VariableID:21692:44617"
           },
           "$type": "color",
-          "comment": "Primary success color used to indicate positive states, confirmations, or completed actions (e.g., success banners, icons, or badges). Remains the same across modes to ensure recognizability and consistency. L&D:070",
+          "comment": "Solid success background for positive actions (e.g., confirm button, success badge). Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2195,7 +2213,7 @@
               "variableId": "VariableID:21692:44617"
             },
             "$type": "color",
-            "comment": "Primary success color used to indicate positive states, confirmations, or completed actions (e.g., success banners, icons, or badges). Remains the same across modes to ensure recognizability and consistency. L&D:070"
+            "comment": "Solid success background for positive actions (e.g., confirm button, success badge). Behavior: Static — same value in light and dark mode."
           },
           "name": "bgColorSuccessSolid",
           "attributes": {},
@@ -2224,7 +2242,7 @@
             "variableId": "VariableID:9697:16953"
           },
           "$type": "color",
-          "comment": "Secondary success tone used for secondary states. Maintains the same color in both Light and Dark mode for clarity. L&D: green40",
+          "comment": "Solid success background for hover state (e.g., confirm button hover). Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2245,7 +2263,7 @@
               "variableId": "VariableID:9697:16953"
             },
             "$type": "color",
-            "comment": "Secondary success tone used for secondary states. Maintains the same color in both Light and Dark mode for clarity. L&D: green40"
+            "comment": "Solid success background for hover state (e.g., confirm button hover). Behavior: Static — same value in light and dark mode."
           },
           "name": "bgColorSuccessSolidHover",
           "attributes": {},
@@ -2274,7 +2292,7 @@
             "variableId": "VariableID:2812:809"
           },
           "$type": "color",
-          "comment": "Success-related background used for positive notifications, confirmation surfaces, or success banners. Behavior: Constant — remains the same across Light and Dark mode to ensure brand alignment.",
+          "comment": "Success feedback background for hover state (e.g., success notification hover). Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2295,7 +2313,7 @@
               "variableId": "VariableID:2812:809"
             },
             "$type": "color",
-            "comment": "Success-related background used for positive notifications, confirmation surfaces, or success banners. Behavior: Constant — remains the same across Light and Dark mode to ensure brand alignment."
+            "comment": "Success feedback background for hover state (e.g., success notification hover). Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "bgColorSuccessTintHover",
           "attributes": {},
@@ -2324,7 +2342,7 @@
             "variableId": "VariableID:21692:7217"
           },
           "$type": "color",
-          "comment": "Secondary success tone used for secondary states. Maintains the same color in both Light and Dark mode for clarity. L&D: green40",
+          "comment": "Solid success background for active/pressed state (e.g., confirm button pressed). Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2345,7 +2363,7 @@
               "variableId": "VariableID:21692:7217"
             },
             "$type": "color",
-            "comment": "Secondary success tone used for secondary states. Maintains the same color in both Light and Dark mode for clarity. L&D: green40"
+            "comment": "Solid success background for active/pressed state (e.g., confirm button pressed). Behavior: Static — same value in light and dark mode."
           },
           "name": "bgColorSuccessSolidActive",
           "attributes": {},
@@ -2376,7 +2394,7 @@
             "variableId": "VariableID:21936:345692"
           },
           "$type": "color",
-          "comment": "Represents tertiary-level gradient background. Currently used on skeletons.",
+          "comment": "Gradient stop color for tertiary background transitions. Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2397,7 +2415,7 @@
               "variableId": "VariableID:21936:345692"
             },
             "$type": "color",
-            "comment": "Represents tertiary-level gradient background. Currently used on skeletons."
+            "comment": "Gradient stop color for tertiary background transitions. Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "bgColorTertiaryGradientStop",
           "attributes": {},
@@ -2426,7 +2444,7 @@
             "variableId": "VariableID:21160:123382"
           },
           "$type": "color",
-          "comment": "Defines the end stops for primary surface gradients, creating visual depth or elevation. Used next to sliders buttons and slider container edges for fading out content. Behavior: Dynamic — light gradients in Light mode, dark gradients in Dark mode.",
+          "comment": "Gradient stop color for primary background fade effects (e.g., scroll shadows, content fade-outs). Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2447,7 +2465,7 @@
               "variableId": "VariableID:21160:123382"
             },
             "$type": "color",
-            "comment": "Defines the end stops for primary surface gradients, creating visual depth or elevation. Used next to sliders buttons and slider container edges for fading out content. Behavior: Dynamic — light gradients in Light mode, dark gradients in Dark mode."
+            "comment": "Gradient stop color for primary background fade effects (e.g., scroll shadows, content fade-outs). Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "bgColorPrimaryGradientStop",
           "attributes": {},
@@ -2476,7 +2494,7 @@
             "variableId": "VariableID:21936:345683"
           },
           "$type": "color",
-          "comment": "Used for secondary surface gradients or subtle depth layers across backgrounds. Behavior: Dynamic — adapts to mode brightness for smooth gradient transitions.",
+          "comment": "Gradient stop color for secondary background transitions. Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2497,7 +2515,7 @@
               "variableId": "VariableID:21936:345683"
             },
             "$type": "color",
-            "comment": "Used for secondary surface gradients or subtle depth layers across backgrounds. Behavior: Dynamic — adapts to mode brightness for smooth gradient transitions."
+            "comment": "Gradient stop color for secondary background transitions. Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "bgColorSecondaryGradientStop",
           "attributes": {},
@@ -2630,6 +2648,7 @@
             "variableId": "VariableID:21692:48826"
           },
           "$type": "color",
+          "comment": "Error feedback background for error states (e.g., error message background, invalid field highlight). Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2649,7 +2668,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21692:48826"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Error feedback background for error states (e.g., error message background, invalid field highlight). Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "bgColorErrorTint",
           "attributes": {},
@@ -2678,6 +2698,7 @@
             "variableId": "VariableID:21678:1559"
           },
           "$type": "color",
+          "comment": "Error feedback background for hover state (e.g., error notification hover). Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2697,7 +2718,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21678:1559"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Error feedback background for hover state (e.g., error notification hover). Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "bgColorErrorTintHover",
           "attributes": {},
@@ -2726,6 +2748,7 @@
             "variableId": "VariableID:2580:18750"
           },
           "$type": "color",
+          "comment": "Solid error background for critical actions (e.g., delete button, error badge). Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2745,7 +2768,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:2580:18750"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Solid error background for critical actions (e.g., delete button, error badge). Behavior: Static — same value in light and dark mode."
           },
           "name": "bgColorErrorSolid",
           "attributes": {},
@@ -2774,6 +2798,7 @@
             "variableId": "VariableID:21692:48824"
           },
           "$type": "color",
+          "comment": "Solid error background for hover state (e.g., destructive button hover). Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2793,7 +2818,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21692:48824"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Solid error background for hover state (e.g., destructive button hover). Behavior: Static — same value in light and dark mode."
           },
           "name": "bgColorErrorSolidHover",
           "attributes": {},
@@ -2824,6 +2850,7 @@
             "variableId": "VariableID:21692:7207"
           },
           "$type": "color",
+          "comment": "Warning feedback background for caution states (e.g., warning banner, attention indicators). Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2843,7 +2870,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21692:7207"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Warning feedback background for caution states (e.g., warning banner, attention indicators). Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "bgColorWarningTint",
           "attributes": {},
@@ -2872,6 +2900,7 @@
             "variableId": "VariableID:21678:1564"
           },
           "$type": "color",
+          "comment": "Warning feedback background for hover state. Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2891,7 +2920,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21678:1564"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Warning feedback background for hover state. Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "bgColorWarningTintHover",
           "attributes": {},
@@ -2920,6 +2950,7 @@
             "variableId": "VariableID:2496:18724"
           },
           "$type": "color",
+          "comment": "Solid warning background for caution indicators (e.g., warning badge, alert background). Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2939,7 +2970,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:2496:18724"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Solid warning background for caution indicators (e.g., warning badge, alert background). Behavior: Static — same value in light and dark mode."
           },
           "name": "bgColorWarningSolid",
           "attributes": {},
@@ -2968,6 +3000,7 @@
             "variableId": "VariableID:21692:7208"
           },
           "$type": "color",
+          "comment": "Solid warning background for hover state. Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -2987,7 +3020,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21692:7208"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Solid warning background for hover state. Behavior: Static — same value in light and dark mode."
           },
           "name": "bgColorWarningSolidHover",
           "attributes": {},
@@ -3020,7 +3054,7 @@
             "variableId": "VariableID:16104:163547"
           },
           "$type": "color",
-          "comment": "Medium-emphasis border color for standard outlines, input fields, or separators that require visible yet non-dominant contrast. Behavior: Dynamic - adjusts to maintain legibility in Light and Dark themes. L:085 D:045",
+          "comment": "Default border color for static containers and separators (e.g., card borders, section dividers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3041,7 +3075,7 @@
               "variableId": "VariableID:16104:163547"
             },
             "$type": "color",
-            "comment": "Medium-emphasis border color for standard outlines, input fields, or separators that require visible yet non-dominant contrast. Behavior: Dynamic - adjusts to maintain legibility in Light and Dark themes. L:085 D:045"
+            "comment": "Default border color for static containers and separators (e.g., card borders, section dividers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "borderColorDefault",
           "attributes": {},
@@ -3070,7 +3104,7 @@
             "variableId": "VariableID:21692:48287"
           },
           "$type": "color",
-          "comment": "Used for subtle dividers and low-emphasis borders in neutral areas (e.g., card outlines, input containers). Dynamic - light gray 093 in Light mode, dark gray 035 in Dark mode.",
+          "comment": "Subtle low-contrast border for soft static separations (e.g., list separators, subtle dividers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3091,7 +3125,7 @@
               "variableId": "VariableID:21692:48287"
             },
             "$type": "color",
-            "comment": "Used for subtle dividers and low-emphasis borders in neutral areas (e.g., card outlines, input containers). Dynamic - light gray 093 in Light mode, dark gray 035 in Dark mode."
+            "comment": "Subtle low-contrast border for soft static separations (e.g., list separators, subtle dividers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "borderColorSubtle",
           "attributes": {},
@@ -3120,7 +3154,7 @@
             "variableId": "VariableID:21764:1044"
           },
           "$type": "color",
-          "comment": "High-emphasis border color for clear delineation between surfaces (e.g., focus rings, high-contrast UI zones). Behavior: Dynamic — light surfaces use a darker neutral, dark surfaces a light neutral tone. L:015 D:100",
+          "comment": "Extra strong border for maximum static contrast (e.g., critical sections, strong separations). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3141,7 +3175,7 @@
               "variableId": "VariableID:21764:1044"
             },
             "$type": "color",
-            "comment": "High-emphasis border color for clear delineation between surfaces (e.g., focus rings, high-contrast UI zones). Behavior: Dynamic — light surfaces use a darker neutral, dark surfaces a light neutral tone. L:015 D:100"
+            "comment": "Extra strong border for maximum static contrast (e.g., critical sections, strong separations). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "borderColorExtraStrong",
           "attributes": {},
@@ -3170,7 +3204,7 @@
             "variableId": "VariableID:21692:48284"
           },
           "$type": "color",
-          "comment": "High-emphasis border color for clear delineation between surfaces (e.g., focus rings, high-contrast UI zones). Behavior: Dynamic — light surfaces use a darker neutral, dark surfaces a light neutral tone. L:015 D:100",
+          "comment": "Strong border for static emphasis (e.g., highlighted sections, important containers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3191,7 +3225,7 @@
               "variableId": "VariableID:21692:48284"
             },
             "$type": "color",
-            "comment": "High-emphasis border color for clear delineation between surfaces (e.g., focus rings, high-contrast UI zones). Behavior: Dynamic — light surfaces use a darker neutral, dark surfaces a light neutral tone. L:015 D:100"
+            "comment": "Strong border for static emphasis (e.g., highlighted sections, important containers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "borderColorStrong",
           "attributes": {},
@@ -3222,7 +3256,7 @@
             "variableId": "VariableID:21764:1045"
           },
           "$type": "color",
-          "comment": "Applies to UI elements that must visually remain the same regardless of theme (e.g., brand containers, static illustrations). Identical tone across Light and Dark mode. L&D: 093",
+          "comment": "Subtle border on dark solid backgrounds (e.g., subtle dividers on dark UI). Behavior: Static — same value in light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3243,7 +3277,7 @@
               "variableId": "VariableID:21764:1045"
             },
             "$type": "color",
-            "comment": "Applies to UI elements that must visually remain the same regardless of theme (e.g., brand containers, static illustrations). Identical tone across Light and Dark mode. L&D: 093"
+            "comment": "Subtle border on dark solid backgrounds (e.g., subtle dividers on dark UI). Behavior: Static — same value in light and dark mode. Brand-specific."
           },
           "name": "borderColorSubtleOnDark",
           "attributes": {},
@@ -3272,7 +3306,7 @@
             "variableId": "VariableID:18489:25069"
           },
           "$type": "color",
-          "comment": "Medium-emphasis border color for standard outlines, input fields, or separators that require visible yet non-dominant contrast. Behavior: Dynamic - adjusts to maintain legibility in Light and Dark themes. L:085 D:045",
+          "comment": "Default border on dark solid backgrounds. Behavior: Static — same value in light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3293,7 +3327,7 @@
               "variableId": "VariableID:18489:25069"
             },
             "$type": "color",
-            "comment": "Medium-emphasis border color for standard outlines, input fields, or separators that require visible yet non-dominant contrast. Behavior: Dynamic - adjusts to maintain legibility in Light and Dark themes. L:085 D:045"
+            "comment": "Default border on dark solid backgrounds. Behavior: Static — same value in light and dark mode. Brand-specific."
           },
           "name": "borderColorDefaultOnDark",
           "attributes": {},
@@ -3322,7 +3356,7 @@
             "variableId": "VariableID:21692:48287"
           },
           "$type": "color",
-          "comment": "Applies to UI elements that must visually remain the same regardless of theme (e.g., brand containers, static illustrations). Identical tone across Light and Dark mode. L&D: 093",
+          "comment": "Subtle border on light solid backgrounds. Behavior: Static — same value in light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3343,7 +3377,7 @@
               "variableId": "VariableID:21692:48287"
             },
             "$type": "color",
-            "comment": "Applies to UI elements that must visually remain the same regardless of theme (e.g., brand containers, static illustrations). Identical tone across Light and Dark mode. L&D: 093"
+            "comment": "Subtle border on light solid backgrounds. Behavior: Static — same value in light and dark mode. Brand-specific."
           },
           "name": "borderColorSubtleOnLight",
           "attributes": {},
@@ -3372,7 +3406,7 @@
             "variableId": "VariableID:16104:163547"
           },
           "$type": "color",
-          "comment": "Medium-emphasis border color for standard outlines, input fields, or separators that require visible yet non-dominant contrast. Behavior: Dynamic - adjusts to maintain legibility in Light and Dark themes. L:085 D:045",
+          "comment": "Default border on light solid backgrounds. Behavior: Static — same value in light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3393,7 +3427,7 @@
               "variableId": "VariableID:16104:163547"
             },
             "$type": "color",
-            "comment": "Medium-emphasis border color for standard outlines, input fields, or separators that require visible yet non-dominant contrast. Behavior: Dynamic - adjusts to maintain legibility in Light and Dark themes. L:085 D:045"
+            "comment": "Default border on light solid backgrounds. Behavior: Static — same value in light and dark mode. Brand-specific."
           },
           "name": "borderColorDefaultOnLight",
           "attributes": {},
@@ -3424,7 +3458,7 @@
             "variableId": "VariableID:9697:16953"
           },
           "$type": "color",
-          "comment": "Used for success states and validation borders (e.g., input success outlines or confirmation frames). Behavior: Constant — same success tone across modes for consistent feedback semantics.",
+          "comment": "Success border for valid states (e.g., validated input, successful upload). Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3445,7 +3479,7 @@
               "variableId": "VariableID:9697:16953"
             },
             "$type": "color",
-            "comment": "Used for success states and validation borders (e.g., input success outlines or confirmation frames). Behavior: Constant — same success tone across modes for consistent feedback semantics."
+            "comment": "Success border for valid states (e.g., validated input, successful upload). Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "borderColorSuccess",
           "attributes": {},
@@ -3474,7 +3508,7 @@
             "variableId": "VariableID:539:2239"
           },
           "$type": "color",
-          "comment": "Defines border color for warning and error-related components, typically used for input validation or caution zones. Behavior: Constant — retains the same red warning tone in both Light and Dark modes.",
+          "comment": "Error border for invalid states (e.g., form validation error, required field indicator). Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3495,7 +3529,7 @@
               "variableId": "VariableID:539:2239"
             },
             "$type": "color",
-            "comment": "Defines border color for warning and error-related components, typically used for input validation or caution zones. Behavior: Constant — retains the same red warning tone in both Light and Dark modes."
+            "comment": "Error border for invalid states (e.g., form validation error, required field indicator). Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "borderColorError",
           "attributes": {},
@@ -3524,6 +3558,7 @@
             "variableId": "VariableID:21678:1562"
           },
           "$type": "color",
+          "comment": "Warning border for caution states (e.g., field warning, attention required). Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3543,7 +3578,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21678:1562"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Warning border for caution states (e.g., field warning, attention required). Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "borderColorWarning",
           "attributes": {},
@@ -3553,54 +3589,6 @@
             "Feedback",
             "borderColorWarning"
           ]
-        },
-        "borderColorInfo": {
-          "$value": "#8C9196",
-          "value": "#8C9196",
-          "type": "color",
-          "$extensions": {
-            "com.figma": {
-              "collectionId": "VariableCollectionId:588:1979",
-              "collectionName": "ColorMode",
-              "variableId": "VariableID:21748:708"
-            }
-          },
-          "$alias": {
-            "token": "colorNeutral60",
-            "collection": "_colorprimitive",
-            "collectionType": "primitive",
-            "variableId": "VariableID:2552:18733"
-          },
-          "$type": "color",
-          "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
-          "isSource": true,
-          "original": {
-            "$value": "#8C9196",
-            "value": "#8C9196",
-            "type": "color",
-            "$extensions": {
-              "com.figma": {
-                "collectionId": "VariableCollectionId:588:1979",
-                "collectionName": "ColorMode",
-                "variableId": "VariableID:21748:708"
-              }
-            },
-            "$alias": {
-              "token": "colorNeutral60",
-              "collection": "_colorprimitive",
-              "collectionType": "primitive",
-              "variableId": "VariableID:2552:18733"
-            },
-            "$type": "color"
-          },
-          "name": "borderColorInfo",
-          "attributes": {},
-          "path": [
-            "Semantic",
-            "Border",
-            "Feedback",
-            "borderColorInfo"
-          ]
         }
       },
       "Interactive": {
@@ -3622,7 +3610,7 @@
             "variableId": "VariableID:21692:48287"
           },
           "$type": "color",
-          "comment": "Applied to disabled states of primary elements (e.g., buttons, inputs) to visually reduce emphasis and indicate inactivity.",
+          "comment": "Border color for disabled elements (e.g., disabled input borders, inactive containers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3643,7 +3631,7 @@
               "variableId": "VariableID:21692:48287"
             },
             "$type": "color",
-            "comment": "Applied to disabled states of primary elements (e.g., buttons, inputs) to visually reduce emphasis and indicate inactivity."
+            "comment": "Border color for disabled elements (e.g., disabled input borders, inactive containers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "borderColorDisabled",
           "attributes": {},
@@ -3654,7 +3642,7 @@
             "borderColorDisabled"
           ]
         },
-        "borderColorFocus": {
+        "borderColorSelected": {
           "$value": "#174482",
           "value": "#174482",
           "type": "color",
@@ -3672,6 +3660,7 @@
             "variableId": "VariableID:16107:27"
           },
           "$type": "color",
+          "comment": "Border for selected elements (e.g., selected checkbox, active tab indicator). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3691,15 +3680,16 @@
               "collectionType": "primitive",
               "variableId": "VariableID:16107:27"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Border for selected elements (e.g., selected checkbox, active tab indicator). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
-          "name": "borderColorFocus",
+          "name": "borderColorSelected",
           "attributes": {},
           "path": [
             "Semantic",
             "Border",
             "Interactive",
-            "borderColorFocus"
+            "borderColorSelected"
           ]
         },
         "borderColorActive": {
@@ -3720,6 +3710,7 @@
             "variableId": "VariableID:16107:27"
           },
           "$type": "color",
+          "comment": "Border for active elements (e.g., active tab indicator). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3739,7 +3730,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:16107:27"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Border for active elements (e.g., active tab indicator). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "borderColorActive",
           "attributes": {},
@@ -3768,7 +3760,7 @@
             "variableId": "VariableID:21692:48286"
           },
           "$type": "color",
-          "comment": "High-emphasis border color for clear delineation between surfaces (e.g., focus rings, high-contrast UI zones). Behavior: Dynamic — light surfaces use a darker neutral, dark surfaces a light neutral tone. L:015 D:100",
+          "comment": "Default border color for interactive elements in idle state (e.g., input fields, buttons, selectable items). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3789,7 +3781,7 @@
               "variableId": "VariableID:21692:48286"
             },
             "$type": "color",
-            "comment": "High-emphasis border color for clear delineation between surfaces (e.g., focus rings, high-contrast UI zones). Behavior: Dynamic — light surfaces use a darker neutral, dark surfaces a light neutral tone. L:015 D:100"
+            "comment": "Default border color for interactive elements in idle state (e.g., input fields, buttons, selectable items). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "borderColorIdle",
           "attributes": {},
@@ -3820,6 +3812,7 @@
             "variableId": "VariableID:18489:25069"
           },
           "$type": "color",
+          "comment": "Default border on inverted surfaces. Behavior: Inverted — swaps light and dark values. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3839,7 +3832,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:18489:25069"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Default border on inverted surfaces. Behavior: Inverted — swaps light and dark values. Brand-specific."
           },
           "name": "borderColorDefaultInverse",
           "attributes": {},
@@ -3868,6 +3862,7 @@
             "variableId": "VariableID:21764:1045"
           },
           "$type": "color",
+          "comment": "Subtle border on inverted surfaces (e.g., subtle separators in dark sections). Behavior: Inverted — swaps light and dark values. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3887,7 +3882,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21764:1045"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Subtle border on inverted surfaces (e.g., subtle separators in dark sections). Behavior: Inverted — swaps light and dark values. Brand-specific."
           },
           "name": "borderColorSubtleInverse",
           "attributes": {},
@@ -3918,6 +3914,7 @@
             "variableId": "VariableID:16107:27"
           },
           "$type": "color",
+          "comment": "Brand-colored border for emphasis (e.g., active tabs, selected items, brand highlights). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3937,7 +3934,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:16107:27"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Brand-colored border for emphasis (e.g., active tabs, selected items, brand highlights). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "borderColorBrand",
           "attributes": {},
@@ -3966,6 +3964,7 @@
             "variableId": "VariableID:16107:27"
           },
           "$type": "color",
+          "comment": "Brand border in light mode, neutral white in dark mode (e.g., accent borders that shouldn't be vibrant in dark). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -3985,7 +3984,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:16107:27"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Brand border in light mode, neutral white in dark mode (e.g., accent borders that shouldn't be vibrant in dark). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "borderColorBrandLightOnly",
           "attributes": {},
@@ -4014,6 +4014,7 @@
             "variableId": "VariableID:16107:27"
           },
           "$type": "color",
+          "comment": "Brand border that remains constant regardless of color mode. Behavior: Static — same value in light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4033,7 +4034,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:16107:27"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Brand border that remains constant regardless of color mode. Behavior: Static — same value in light and dark mode. Brand-specific."
           },
           "name": "borderColorBrandConst",
           "attributes": {},
@@ -4064,6 +4066,7 @@
             "variableId": "VariableID:588:1978"
           },
           "$type": "color",
+          "comment": "Zero-contrast border matching surface color (e.g., invisible borders for layout, spacing helpers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4083,7 +4086,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:588:1978"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Zero-contrast border matching surface color (e.g., invisible borders for layout, spacing helpers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "borderColorNoContrast",
           "attributes": {},
@@ -4116,7 +4120,7 @@
             "variableId": "VariableID:18489:25069"
           },
           "$type": "color",
-          "comment": "Primary icon color on primary surfaces.",
+          "comment": "Default icon color for interactive/clickable icons in idle state (e.g., icon buttons, navigation icons, action icons). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4137,7 +4141,7 @@
               "variableId": "VariableID:18489:25069"
             },
             "$type": "color",
-            "comment": "Primary icon color on primary surfaces."
+            "comment": "Default icon color for interactive/clickable icons in idle state (e.g., icon buttons, navigation icons, action icons). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "iconColorIdle",
           "attributes": {},
@@ -4166,7 +4170,7 @@
             "variableId": "VariableID:21692:48285"
           },
           "$type": "color",
-          "comment": "Disabled label tone indicating inactive or unavailable states in UI elements. Behavior: Dynamic — lighter gray in Light mode, darker neutral in Dark mode. L:085 D:035",
+          "comment": "Icon color for disabled elements (e.g., inactive button icons, disabled controls). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4187,7 +4191,7 @@
               "variableId": "VariableID:21692:48285"
             },
             "$type": "color",
-            "comment": "Disabled label tone indicating inactive or unavailable states in UI elements. Behavior: Dynamic — lighter gray in Light mode, darker neutral in Dark mode. L:085 D:035"
+            "comment": "Icon color for disabled elements (e.g., inactive button icons, disabled controls). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "iconColorDisabled",
           "attributes": {},
@@ -4216,6 +4220,7 @@
             "variableId": "VariableID:21764:1044"
           },
           "$type": "color",
+          "comment": "Icon color for interactive/clickable icons on hover (e.g., icon button hover, navigation icon hover). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4235,7 +4240,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21764:1044"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Icon color for interactive/clickable icons on hover (e.g., icon button hover, navigation icon hover). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "iconColorHover",
           "attributes": {},
@@ -4264,6 +4270,7 @@
             "variableId": "VariableID:21764:1044"
           },
           "$type": "color",
+          "comment": "Icon color for interactive/clickable icons in active or selected state (e.g., active navigation, selected action). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4283,7 +4290,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21764:1044"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Icon color for interactive/clickable icons in active or selected state (e.g., active navigation, selected action). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "iconColorActive",
           "attributes": {},
@@ -4314,7 +4322,7 @@
             "variableId": "VariableID:3912:4271"
           },
           "$type": "color",
-          "comment": "Used for icons that must remain visually consistent regardless of mode (e.g.,  icons that are on surfaces that don't change color). Identical tone in both Light and Dark mode.",
+          "comment": "Secondary icon on light solid surfaces. Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4335,7 +4343,7 @@
               "variableId": "VariableID:3912:4271"
             },
             "$type": "color",
-            "comment": "Used for icons that must remain visually consistent regardless of mode (e.g.,  icons that are on surfaces that don't change color). Identical tone in both Light and Dark mode."
+            "comment": "Secondary icon on light solid surfaces. Behavior: Static — same value in light and dark mode."
           },
           "name": "iconColorSecondaryOnLight",
           "attributes": {},
@@ -4364,7 +4372,7 @@
             "variableId": "VariableID:588:1978"
           },
           "$type": "color",
-          "comment": "Used for text displayed on dark surfaces to ensure maximum legibility and contrast. Behavior: Constant — always light neutral to guarantee accessibility on dark backgrounds.",
+          "comment": "Primary icon on dark solid surfaces (e.g., icons on dark buttons, player controls). Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4385,7 +4393,7 @@
               "variableId": "VariableID:588:1978"
             },
             "$type": "color",
-            "comment": "Used for text displayed on dark surfaces to ensure maximum legibility and contrast. Behavior: Constant — always light neutral to guarantee accessibility on dark backgrounds."
+            "comment": "Primary icon on dark solid surfaces (e.g., icons on dark buttons, player controls). Behavior: Static — same value in light and dark mode."
           },
           "name": "iconColorPrimaryOnDark",
           "attributes": {},
@@ -4414,7 +4422,7 @@
             "variableId": "VariableID:2881:1765"
           },
           "$type": "color",
-          "comment": "Fixed inverse label tone applied where white or bright text must always appear, regardless of theme. Behavior: Constant — remains bright neutral in both Light and Dark mode. L&D:093",
+          "comment": "Secondary icon on dark solid surfaces. Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4435,7 +4443,7 @@
               "variableId": "VariableID:2881:1765"
             },
             "$type": "color",
-            "comment": "Fixed inverse label tone applied where white or bright text must always appear, regardless of theme. Behavior: Constant — remains bright neutral in both Light and Dark mode. L&D:093"
+            "comment": "Secondary icon on dark solid surfaces. Behavior: Static — same value in light and dark mode."
           },
           "name": "iconColorSecondaryOnDark",
           "attributes": {},
@@ -4464,7 +4472,7 @@
             "variableId": "VariableID:588:1977"
           },
           "$type": "color",
-          "comment": "Used when primary text color must remain fixed regardless of mode (e.g., on light constant backgrounds). Behavior: Constant — same tone across Light and Dark mode.",
+          "comment": "Primary icon on light solid surfaces. Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4485,7 +4493,7 @@
               "variableId": "VariableID:588:1977"
             },
             "$type": "color",
-            "comment": "Used when primary text color must remain fixed regardless of mode (e.g., on light constant backgrounds). Behavior: Constant — same tone across Light and Dark mode."
+            "comment": "Primary icon on light solid surfaces. Behavior: Static — same value in light and dark mode."
           },
           "name": "iconColorPrimaryOnLight",
           "attributes": {},
@@ -4514,7 +4522,7 @@
             "variableId": "VariableID:588:1978"
           },
           "$type": "color",
-          "comment": "Fixed white heading color used on dark or colored backgrounds (e.g., hero sections, banners) that remain constant across modes. Behavior: Constant — remains white in both Light and Dark mode.",
+          "comment": "Icon color for elements overlaid on images (e.g., play button on video thumbnail). Mode-independent. Behavior: Static — same value in light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4535,7 +4543,7 @@
               "variableId": "VariableID:588:1978"
             },
             "$type": "color",
-            "comment": "Fixed white heading color used on dark or colored backgrounds (e.g., hero sections, banners) that remain constant across modes. Behavior: Constant — remains white in both Light and Dark mode."
+            "comment": "Icon color for elements overlaid on images (e.g., play button on video thumbnail). Mode-independent. Behavior: Static — same value in light and dark mode."
           },
           "name": "iconColorConstOnImage",
           "attributes": {},
@@ -4566,7 +4574,7 @@
             "variableId": "VariableID:9697:16953"
           },
           "$type": "color",
-          "comment": "Represents success or confirmation icons (e.g., checkmarks, completion indicators). Behavior: Constant - same success green tone across Light and Dark mode.",
+          "comment": "Success icon color for success indicators (e.g., checkmark icon, completion indicator). Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4587,7 +4595,7 @@
               "variableId": "VariableID:9697:16953"
             },
             "$type": "color",
-            "comment": "Represents success or confirmation icons (e.g., checkmarks, completion indicators). Behavior: Constant - same success green tone across Light and Dark mode."
+            "comment": "Success icon color for success indicators (e.g., checkmark icon, completion indicator). Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "iconColorSuccess",
           "attributes": {},
@@ -4616,7 +4624,7 @@
             "variableId": "VariableID:2580:18750"
           },
           "$type": "color",
-          "comment": "Used for strong warnings, errors, or destructive action labels. Behavior: Constant — red color remains unchanged between Light and Dark mode for visibility and recognition.",
+          "comment": "Error icon color for error indicators (e.g., error badge icon, validation error icon). Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4637,7 +4645,7 @@
               "variableId": "VariableID:2580:18750"
             },
             "$type": "color",
-            "comment": "Used for strong warnings, errors, or destructive action labels. Behavior: Constant — red color remains unchanged between Light and Dark mode for visibility and recognition."
+            "comment": "Error icon color for error indicators (e.g., error badge icon, validation error icon). Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "iconColorError",
           "attributes": {},
@@ -4666,7 +4674,7 @@
             "variableId": "VariableID:21678:1561"
           },
           "$type": "color",
-          "comment": "Represents medium attention states, often used in warnings or pending states. Behavior: Constant — same orange tone across Light and Dark mode.",
+          "comment": "Warning icon color for caution indicators (e.g., warning triangle, alert icon). Behavior: Dynamic — adapts between light and dark mode.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4687,7 +4695,7 @@
               "variableId": "VariableID:21678:1561"
             },
             "$type": "color",
-            "comment": "Represents medium attention states, often used in warnings or pending states. Behavior: Constant — same orange tone across Light and Dark mode."
+            "comment": "Warning icon color for caution indicators (e.g., warning triangle, alert icon). Behavior: Dynamic — adapts between light and dark mode."
           },
           "name": "iconColorWarning",
           "attributes": {},
@@ -4718,7 +4726,7 @@
             "variableId": "VariableID:16107:27"
           },
           "$type": "color",
-          "comment": "Applies to text elements requiring fixed brand color usage (e.g., permanent links, brand slogans on constant backgrounds). Behavior: Constant — maintains identical red tone across Light and Dark mode.",
+          "comment": "Brand-colored icon for emphasis (e.g., featured icons, brand indicators). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4739,7 +4747,7 @@
               "variableId": "VariableID:16107:27"
             },
             "$type": "color",
-            "comment": "Applies to text elements requiring fixed brand color usage (e.g., permanent links, brand slogans on constant backgrounds). Behavior: Constant — maintains identical red tone across Light and Dark mode."
+            "comment": "Brand-colored icon for emphasis (e.g., featured icons, brand indicators). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "iconColorBrand",
           "attributes": {},
@@ -4768,7 +4776,7 @@
             "variableId": "VariableID:16107:27"
           },
           "$type": "color",
-          "comment": "Accent text color used for links, interactive text, or highlighted key words. Changes from a red in light mode to a white in dark mode.",
+          "comment": "Brand icon color in light mode, neutral white in dark mode. Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4789,7 +4797,7 @@
               "variableId": "VariableID:16107:27"
             },
             "$type": "color",
-            "comment": "Accent text color used for links, interactive text, or highlighted key words. Changes from a red in light mode to a white in dark mode."
+            "comment": "Brand icon color in light mode, neutral white in dark mode. Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "iconColorBrandLightOnly",
           "attributes": {},
@@ -4820,7 +4828,7 @@
             "variableId": "VariableID:588:1977"
           },
           "$type": "color",
-          "comment": "Main text color used for body copy and all primary textual content. Ensures optimal readability and contrast on standard surfaces. Behavior: Dynamic — switches between dark text on light backgrounds and light text on dark backgrounds.",
+          "comment": "Primary icon color for static/decorative icons (e.g., section icons, illustrative icons, status indicators). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4841,7 +4849,7 @@
               "variableId": "VariableID:588:1977"
             },
             "$type": "color",
-            "comment": "Main text color used for body copy and all primary textual content. Ensures optimal readability and contrast on standard surfaces. Behavior: Dynamic — switches between dark text on light backgrounds and light text on dark backgrounds."
+            "comment": "Primary icon color for static/decorative icons (e.g., section icons, illustrative icons, status indicators). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "iconColorPrimary",
           "attributes": {},
@@ -4870,7 +4878,7 @@
             "variableId": "VariableID:3912:4271"
           },
           "$type": "color",
-          "comment": "Muted text tone for subtle information, timestamps, or inactive text elements. Behavior: Dynamic — adjusts between mid-gray in Light mode and lighter gray in Dark mode.",
+          "comment": "Secondary icon color for static supporting icons (e.g., metadata icons, decorative icons, list markers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4891,7 +4899,7 @@
               "variableId": "VariableID:3912:4271"
             },
             "$type": "color",
-            "comment": "Muted text tone for subtle information, timestamps, or inactive text elements. Behavior: Dynamic — adjusts between mid-gray in Light mode and lighter gray in Dark mode."
+            "comment": "Secondary icon color for static supporting icons (e.g., metadata icons, decorative icons, list markers). Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "iconColorSecondary",
           "attributes": {},
@@ -4920,7 +4928,7 @@
             "variableId": "VariableID:21692:48910"
           },
           "$type": "color",
-          "comment": "Secondary text color used for supportive information, subtitles, and less prominent text. Behavior: Dynamic — adapts between neutral tones to maintain proper contrast per theme. In 2025 css it is called figure meta.",
+          "comment": "Tertiary icon color for static de-emphasized icons (e.g., subtle indicators, background icons).  Behavior: Dynamic — adapts between light and dark mode. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4941,7 +4949,7 @@
               "variableId": "VariableID:21692:48910"
             },
             "$type": "color",
-            "comment": "Secondary text color used for supportive information, subtitles, and less prominent text. Behavior: Dynamic — adapts between neutral tones to maintain proper contrast per theme. In 2025 css it is called figure meta."
+            "comment": "Tertiary icon color for static de-emphasized icons (e.g., subtle indicators, background icons).  Behavior: Dynamic — adapts between light and dark mode. Brand-specific."
           },
           "name": "iconColorTertiary",
           "attributes": {},
@@ -4972,7 +4980,7 @@
             "variableId": "VariableID:21692:48287"
           },
           "$type": "color",
-          "comment": "Inverse text color used on opposing surfaces (e.g., white text on red or dark backgrounds). Behavior: Dynamic — alternates between light and dark mode.",
+          "comment": "Primary icon on inverted/contrast backgrounds. Behavior: Inverted — swaps light and dark values. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -4993,7 +5001,7 @@
               "variableId": "VariableID:21692:48287"
             },
             "$type": "color",
-            "comment": "Inverse text color used on opposing surfaces (e.g., white text on red or dark backgrounds). Behavior: Dynamic — alternates between light and dark mode."
+            "comment": "Primary icon on inverted/contrast backgrounds. Behavior: Inverted — swaps light and dark values. Brand-specific."
           },
           "name": "iconColorPrimaryInverse",
           "attributes": {},
@@ -5022,6 +5030,7 @@
             "variableId": "VariableID:21692:48285"
           },
           "$type": "color",
+          "comment": "Secondary icon on inverted/contrast backgrounds. Behavior: Inverted — swaps light and dark values. Brand-specific.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -5041,7 +5050,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:21692:48285"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "Secondary icon on inverted/contrast backgrounds. Behavior: Inverted — swaps light and dark values. Brand-specific."
           },
           "name": "iconColorSecondaryInverse",
           "attributes": {},
@@ -5070,6 +5080,7 @@
             "variableId": "VariableID:588:1978"
           },
           "$type": "color",
+          "comment": "High contrast inverse icon for maximum visibility on inverted surfaces. Behavior: Inverted — swaps light and dark values.",
           "filePath": "/home/runner/work/vv-token-test-v3/vv-token-test-v3/packages/tokens/.tokens/brands/sportbild/color/colormode-light.json",
           "isSource": true,
           "original": {
@@ -5089,7 +5100,8 @@
               "collectionType": "primitive",
               "variableId": "VariableID:588:1978"
             },
-            "$type": "color"
+            "$type": "color",
+            "comment": "High contrast inverse icon for maximum visibility on inverted surfaces. Behavior: Inverted — swaps light and dark values."
           },
           "name": "iconColorInverseHighContrast",
           "attributes": {},