jekyll-theme-centos 2.52.0.beta.4 → 2.52.0.beta.5

data/_data/base/color_schema.yml

@@ -0,0 +1,1036 @@
+---
+title: Color Component Configuration
+description: >-
+  Schema for configuring the 'Color' component palette system. This component defines
+  the complete CentOS color palette including branding colors, semantic status colors,
+  neutral colors, and 44 shade variants (11 each for purple, orange, blue, green).
+  All colors are validated for WCAG 2.2 accessibility compliance with documented
+  contrast ratios and compliance flags.
+type: object
+
+$defs:
+  # Reusable format patterns
+  hexColor:
+    type: string
+    pattern: "^#[0-9A-Fa-f]{6}$"
+    description: Hexadecimal color code (#RRGGBB format)
+
+  rgbValue:
+    type: string
+    pattern: "^\\d{1,3}, \\d{1,3}, \\d{1,3}$"
+    description: RGB representation as comma-separated values (0-255 per component)
+
+  contrastRatio:
+    type: string
+    pattern: "^\\d+\\.\\d{2}:1$"
+    description: WCAG 2.2 contrast ratio (X.XX:1 format)
+
+  contrastMargin:
+    type: string
+    pattern: "^[+-]\\d+\\.\\d{2}:1$"
+    description: Margin from accessibility threshold (±X.XX:1 format)
+
+  textColorEnum:
+    type: string
+    enum:
+      - White
+      - Black
+    description: Recommended text color for optimal contrast
+
+  shadeNumberEnum:
+    type: string
+    enum:
+      - "50"
+      - "100"
+      - "200"
+      - "300"
+      - "400"
+      - "500"
+      - "600"
+      - "700"
+      - "800"
+      - "900"
+      - "950"
+    description: Shade identifier (50=lightest, 950=darkest)
+
+properties:
+  with_color:
+    type: boolean
+    default: true
+    description: >-
+      Controls the visibility of the Color component documentation and palette system.
+      Set to `true` (default) to display the complete color palette documentation
+      including branding, semantic, neutral, and shade color tables with WCAG 2.2
+      accessibility compliance information. Set to `false` to hide the color component
+      documentation entirely.
+
+  with_color_data:
+    type: object
+    default: {}
+    description: >-
+      The color palette data object containing all 52 CentOS colors organized into
+      11 collections: branding colors, semantic colors, neutral colors, and shade
+      variants for purple, orange, blue, and green. Each color includes WCAG 2.2
+      contrast ratios, accessibility compliance flags, and text color recommendations.
+    properties:
+      branding_colors:
+        type: array
+        description: >-
+          Array of brand-identity colors (primary purple and secondary orange) that
+          establish visual foundation and hierarchy while maintaining professional coherence.
+        items:
+          type: object
+          properties:
+            name:
+              type: string
+              description: >-
+                The descriptive name of the branding color (e.g., "Primary", "Secondary").
+                Used for documentation and human-readable references in both code and design systems.
+            hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal representation of the branding color used in CSS, HTML, and design tools.
+                Example: #A54C93 for CentOS primary purple.
+            rgb:
+              $ref: "#/$defs/rgbValue"
+              description: >-
+                RGB representation as comma-separated values (e.g., "165, 76, 147").
+                Each component ranges from 0-255. Useful for cross-platform color specifications.
+            hue:
+              type: string
+              description: >-
+                Hue component of the color in degrees (0-360°). Represents the color family
+                on the color wheel (e.g., 315° for purple). Useful for understanding color
+                relationships and creating color variations.
+            saturation:
+              type: string
+              description: >-
+                Saturation component as a percentage (0-100%). Represents color intensity
+                and vibrancy. Higher values are more saturated/vivid; lower values appear
+                more muted or grayish.
+            lightness:
+              type: string
+              description: >-
+                Lightness component as a percentage (0-100%). Represents brightness level.
+                Used in HSL color space for understanding perceptual brightness independent
+                of hue and saturation.
+            hsv:
+              type: string
+              description: >-
+                Hue, Saturation, Value representation (e.g., "312° / 54% / 65%").
+                Useful for understanding color psychology and visual perception. HSV helps designers
+                understand the perceptual qualities of the color (hue=color family, saturation=intensity, value=brightness).
+            text_color:
+              $ref: "#/$defs/textColorEnum"
+              description: >-
+                Recommended text color (White or Black) for optimal readability and accessibility.
+                "White" for dark backgrounds, "Black" for light backgrounds.
+            text_color_hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the recommended text color. Used to calculate contrast ratio
+                and verify WCAG compliance for accessibility requirements.
+            text_badge:
+              type: string
+              description: >-
+                Bootstrap utility class for automatic text/background pairing that ensures
+                proper contrast and accessibility. Example: "text-bg-centos-purple-500" or "text-bg-primary".
+            contrast_ratio:
+              $ref: "#/$defs/contrastRatio"
+              description: >-
+                WCAG 2.2 contrast ratio between the background color and recommended text color.
+                Formatted as X.XX:1. Example: 5.18:1 indicates the lighter color is 5.18 times brighter
+                than the darker color, meeting AA accessibility standards (4.5:1 minimum).
+            wcag_2_2_aa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AA compliance (4.5:1 minimum contrast).
+                AA is the standard accessibility level required for legal compliance in many jurisdictions.
+                True means this color pair meets the AA threshold; False means it does not.
+            wcag_2_2_aa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AA threshold (4.5:1). Positive values exceed the standard by that amount;
+                negative values indicate failure to meet AA. Example: +0.68:1 means 0.68 points above the minimum.
+            wcag_2_2_aaa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AAA compliance (7.0:1 minimum contrast).
+                AAA is enhanced accessibility for users with low vision or color deficiency.
+                True means this color pair exceeds AAA standards; False means it meets AA but not AAA.
+            wcag_2_2_aaa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AAA threshold (7.0:1). Positive values exceed the enhanced standard;
+                negative values indicate it does not meet AAA (though may still meet AA).
+                Example: -1.82:1 means 1.82 points below the AAA minimum.
+          required:
+            - name
+            - hex
+            - text_color_hex
+            - contrast_ratio
+            - wcag_2_2_aa
+            - wcag_2_2_aaa
+          additionalProperties: false
+
+      semantic_colors:
+        type: array
+        description: >-
+          Array of semantic status colors (Success, Warning, Danger, Info) that communicate
+          system state following ISO 3864 safety standards. Never use color alone—always
+          combine with icons or text.
+        items:
+          type: object
+          properties:
+            name:
+              type: string
+              enum:
+                - Success
+                - Warning
+                - Danger
+                - Info
+              description: >-
+                The semantic meaning of the color. Success indicates positive outcomes,
+                Warning captures attention for caution, Danger signals urgency, and Info
+                conveys trust and assistance.
+            hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the semantic status color. Each semantic meaning
+                (Success, Warning, Danger, Info) has a distinct hex value that provides
+                visual clarity and accessibility when combined with appropriate text colors.
+            rgb:
+              $ref: "#/$defs/rgbValue"
+              description: >-
+                RGB representation of the semantic color. Useful for frameworks and tools
+                that work with RGB color space (e.g., design tools, digital mockups).
+            hsv:
+              type: string
+              description: >-
+                Hue, Saturation, Value representation for understanding the perceptual
+                qualities and psychological associations of the semantic color
+                (e.g., warm for Warning/Danger, cool for Info/Success).
+            text_color:
+              $ref: "#/$defs/textColorEnum"
+              description: >-
+                Recommended text color (White or Black) to ensure the semantic color
+                maintains sufficient contrast for accessibility and visual clarity.
+            text_color_hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the recommended text color. Used to calculate the
+                contrast ratio and verify WCAG 2.2 compliance for the semantic pairing.
+            text_badge:
+              type: string
+              description: >-
+                Bootstrap utility class for semantic color styling
+                (e.g., "text-bg-success", "text-bg-warning").
+            contrast_ratio:
+              $ref: "#/$defs/contrastRatio"
+              description: >-
+                WCAG 2.2 contrast ratio between the semantic color and its recommended
+                text color. Higher ratios indicate better accessibility and visual separation.
+            wcag_2_2_aa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AA compliance (4.5:1 minimum).
+                Semantic colors must meet AA standards to ensure status information is
+                conveyed clearly to users with vision impairments.
+            wcag_2_2_aa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AA threshold (4.5:1). Shows how safely above or below
+                the minimum accessibility standard this semantic color pairing sits.
+                Positive values provide accessibility buffer; negative values indicate non-compliance.
+            wcag_2_2_aaa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AAA compliance (7.0:1 minimum).
+                AAA compliance provides enhanced accessibility for users with low vision.
+            wcag_2_2_aaa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AAA threshold (7.0:1). Shows how far above or below
+                the enhanced accessibility standard this semantic color pairing extends.
+          required:
+            - name
+            - hex
+            - text_color_hex
+            - contrast_ratio
+            - wcag_2_2_aa
+            - wcag_2_2_aaa
+          additionalProperties: false
+
+      neutral_colors:
+        type: array
+        description: >-
+          Array of neutral colors (Light, Dark) that establish visual hierarchy,
+          improve readability, and create depth without drawing attention.
+        items:
+          type: object
+          properties:
+            name:
+              type: string
+              enum:
+                - Light
+                - Dark
+              description: >-
+                "Light" for primary content backgrounds and visual lightness.
+                "Dark" for navigation, footers, and visual weight.
+            hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the neutral color. Light neutral (#F5F5F5 / white-based)
+                establishes primary content backgrounds; Dark neutral (#222222 / black-based)
+                provides visual weight for navigation and footers.
+            rgb:
+              $ref: "#/$defs/rgbValue"
+              description: >-
+                RGB representation of the neutral color. Useful for cross-platform
+                implementations and tools that require RGB color space specifications.
+            hsv:
+              type: string
+              description: >-
+                Hue, Saturation, Value representation for analyzing the neutral color's
+                visual perception. Neutral colors have low saturation and variable value
+                (brightness) to maintain visual hierarchy without competing for attention.
+            text_color:
+              $ref: "#/$defs/textColorEnum"
+              description: >-
+                Recommended text color (White or Black) for sufficient contrast against
+                this neutral background. Light neutrals typically use Black; Dark neutrals use White.
+            text_color_hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the recommended text color. Used to calculate contrast ratio
+                and verify WCAG 2.2 accessibility compliance for text on this neutral background.
+            text_badge:
+              type: string
+              description: >-
+                Bootstrap utility class for neutral color styling
+                (e.g., "text-bg-light", "text-bg-dark").
+            contrast_ratio:
+              $ref: "#/$defs/contrastRatio"
+              description: >-
+                WCAG 2.2 contrast ratio between the neutral background and recommended text color.
+                Neutral colors must maintain sufficient contrast for readability of all content.
+            wcag_2_2_aa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AA compliance (4.5:1 minimum).
+                AA compliance ensures neutral backgrounds support readable text for most users.
+            wcag_2_2_aa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AA threshold (4.5:1). Shows how safely above or below the
+                minimum accessibility standard this neutral color pairing sits. Positive values
+                indicate safe margins; negative values indicate accessibility failure.
+            wcag_2_2_aaa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AAA compliance (7.0:1 minimum).
+                AAA provides enhanced accessibility for users with low vision reading on neutral backgrounds.
+            wcag_2_2_aaa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AAA threshold (7.0:1). Shows how far above or below the
+                enhanced accessibility standard this neutral color pairing extends. Important
+                for high-accessibility use cases (e.g., legal documents, critical information).
+          required:
+            - name
+            - hex
+            - text_color_hex
+            - contrast_ratio
+            - wcag_2_2_aa
+            - wcag_2_2_aaa
+          additionalProperties: false
+
+      purple_shades:
+        type: array
+        description: >-
+          Array of 11 purple color shades (50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950)
+          derived from the CentOS primary brand color. Shades 50-400 work on dark backgrounds;
+          shades 500-950 work on light backgrounds. The shade 500 represents the main primary color.
+        items:
+          type: object
+          properties:
+            shade:
+              $ref: "#/$defs/shadeNumberEnum"
+              description: >-
+                Shade identifier from 50 (lightest) to 950 (darkest). Purple shades 50-400
+                are light and typically used with dark text; shades 500-950 are dark and
+                typically used with white text. Shade 500 is the base CentOS primary purple.
+            full_name:
+              type: string
+              pattern: "^\\$centos-purple-\\d+$"
+              description: >-
+                Full SASS variable name for use in stylesheets
+                (e.g., "$centos-purple-500").
+            hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the purple shade. Used in CSS, HTML, and design systems.
+                Example: #A54C93 (shade 500, the primary purple).
+            rgb:
+              $ref: "#/$defs/rgbValue"
+              description: >-
+                RGB representation of the purple shade. Useful for frameworks and tools
+                requiring RGB color specifications (e.g., web design tools, digital prototypes).
+            hsv:
+              type: string
+              description: >-
+                Hue, Saturation, Value representation. HSV helps understand how the shade
+                progresses from light to dark, showing saturation changes that affect
+                perceptual intensity and vibrancy.
+            hue:
+              type: string
+              description: >-
+                Hue component in degrees for this purple shade.
+            saturation:
+              type: string
+              description: >-
+                Saturation percentage for this purple shade.
+            lightness:
+              type: string
+              description: >-
+                Lightness percentage for this purple shade.
+            text_badge:
+              type: string
+              description: >-
+                Bootstrap utility class for this purple shade
+                (e.g., "text-bg-centos-purple-500").
+            text_color:
+              $ref: "#/$defs/textColorEnum"
+              description: >-
+                Recommended text color (White or Black) for optimal readability on this
+                purple shade. Light shades (50-400) use Black; dark shades (500-950) use White.
+            text_color_hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the recommended text color. Used to calculate the
+                contrast ratio and verify WCAG 2.2 accessibility compliance for this purple shade.
+            contrast_ratio:
+              $ref: "#/$defs/contrastRatio"
+              description: >-
+                WCAG 2.2 contrast ratio between this purple shade and its recommended text color.
+                Determines the accessibility level (AA at 4.5:1, AAA at 7.0:1).
+            wcag_2_2_aa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AA compliance (4.5:1 minimum).
+                True means this purple shade meets standard accessibility requirements.
+            wcag_2_2_aa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AA threshold (4.5:1). Positive values show the safety margin
+                above the minimum; negative values indicate non-compliance. Example: +0.68:1
+                means this shade exceeds AA by 0.68 points.
+            wcag_2_2_aaa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AAA compliance (7.0:1 minimum).
+                True means this purple shade meets enhanced accessibility for users with low vision.
+            wcag_2_2_aaa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AAA threshold (7.0:1). Positive values exceed the enhanced
+                standard; negative values indicate it meets AA but not AAA.
+          required:
+            - shade
+            - hex
+            - text_color_hex
+            - contrast_ratio
+            - wcag_2_2_aa
+            - wcag_2_2_aaa
+          additionalProperties: false
+
+      orange_shades:
+        type: array
+        description: >-
+          Array of 11 orange color shades (50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950)
+          derived from the CentOS secondary brand color. Shades provide warmth and approachability
+          across the design system. Shade 500 is the base secondary color.
+        items:
+          type: object
+          properties:
+            shade:
+              $ref: "#/$defs/shadeNumberEnum"
+              description: >-
+                Shade identifier from 50 (lightest) to 950 (darkest). Orange shades 50-400
+                are light and typically used with dark text; shades 500-950 are dark and
+                typically used with white text. Shade 500 is the base CentOS secondary orange.
+            full_name:
+              type: string
+              pattern: "^\\$centos-orange-\\d+$"
+              description: >-
+                Full SASS variable name for use in stylesheets
+                (e.g., "$centos-orange-500").
+            hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the orange shade. Used in CSS, HTML, and design systems.
+                Example: #B27800 (shade 500, the secondary orange).
+            rgb:
+              $ref: "#/$defs/rgbValue"
+              description: >-
+                RGB representation of the orange shade. Useful for frameworks and tools
+                requiring RGB color specifications in design tools and digital mockups.
+            hsv:
+              type: string
+              description: >-
+                Hue, Saturation, Value representation. HSV helps understand the warm,
+                approachable nature of orange across its shade progression, showing how
+                saturation and brightness change.
+            hue:
+              type: string
+              description: >-
+                Hue component in degrees for this orange shade.
+            saturation:
+              type: string
+              description: >-
+                Saturation percentage for this orange shade.
+            lightness:
+              type: string
+              description: >-
+                Lightness percentage for this orange shade.
+            text_badge:
+              type: string
+              description: >-
+                Bootstrap utility class for this orange shade
+                (e.g., "text-bg-centos-orange-500").
+            text_color:
+              $ref: "#/$defs/textColorEnum"
+              description: >-
+                Recommended text color (White or Black) for optimal readability on this
+                orange shade. Light shades (50-400) use Black; dark shades (500-950) use White.
+            text_color_hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the recommended text color. Used to calculate the
+                contrast ratio and verify WCAG 2.2 accessibility compliance for this orange shade.
+            contrast_ratio:
+              $ref: "#/$defs/contrastRatio"
+              description: >-
+                WCAG 2.2 contrast ratio between this orange shade and its recommended text color.
+                Determines accessibility level (AA at 4.5:1, AAA at 7.0:1).
+            wcag_2_2_aa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AA compliance (4.5:1 minimum).
+                True means this orange shade meets standard accessibility requirements.
+            wcag_2_2_aa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AA threshold (4.5:1). Positive values show the safety margin
+                above the minimum; negative values indicate non-compliance.
+            wcag_2_2_aaa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AAA compliance (7.0:1 minimum).
+                True means this orange shade meets enhanced accessibility for users with low vision.
+            wcag_2_2_aaa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AAA threshold (7.0:1). Positive values exceed the enhanced
+                standard; negative values indicate it meets AA but not AAA.
+          required:
+            - shade
+            - hex
+            - text_color_hex
+            - contrast_ratio
+            - wcag_2_2_aa
+            - wcag_2_2_aaa
+          additionalProperties: false
+
+      blue_shades:
+        type: array
+        description: >-
+          Array of 11 blue color shades (50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950)
+          for extended design flexibility. Blue conveys trust, information, and assistance.
+          Useful for informational alerts, links, and complementary accents.
+        items:
+          type: object
+          properties:
+            shade:
+              $ref: "#/$defs/shadeNumberEnum"
+              description: >-
+                Shade identifier from 50 (lightest) to 950 (darkest). Blue shades 50-400
+                are light and typically used with dark text; shades 500-950 are dark and
+                typically used with white text. Blue conveys trust and information, useful
+                for links, info alerts, and complementary accents.
+            full_name:
+              type: string
+              pattern: "^\\$centos-blue-\\d+$"
+              description: >-
+                Full SASS variable name for use in stylesheets
+                (e.g., "$centos-blue-500").
+            hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the blue shade. Used in CSS, HTML, and design systems.
+                Example: #2C2A80 (shade 500, the base blue for links and information).
+            rgb:
+              $ref: "#/$defs/rgbValue"
+              description: >-
+                RGB representation of the blue shade. Useful for frameworks and tools
+                requiring RGB color specifications, particularly for digital interfaces
+                and informational components.
+            hsv:
+              type: string
+              description: >-
+                Hue, Saturation, Value representation. HSV helps understand blue's cool,
+                trustworthy nature across its shade progression, showing saturation and
+                brightness changes that affect perception of trust and information density.
+            hue:
+              type: string
+              description: >-
+                Hue component in degrees for this blue shade.
+            saturation:
+              type: string
+              description: >-
+                Saturation percentage for this blue shade.
+            lightness:
+              type: string
+              description: >-
+                Lightness percentage for this blue shade.
+            text_badge:
+              type: string
+              description: >-
+                Bootstrap utility class for this blue shade
+                (e.g., "text-bg-centos-blue-500").
+            text_color:
+              $ref: "#/$defs/textColorEnum"
+              description: >-
+                Recommended text color (White or Black) for optimal readability on this
+                blue shade. Light shades (50-400) use Black; dark shades (500-950) use White.
+            text_color_hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the recommended text color. Used to calculate the
+                contrast ratio and verify WCAG 2.2 accessibility compliance for this blue shade.
+            contrast_ratio:
+              $ref: "#/$defs/contrastRatio"
+              description: >-
+                WCAG 2.2 contrast ratio between this blue shade and its recommended text color.
+                Important for ensuring links and information alerts are accessible.
+            wcag_2_2_aa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AA compliance (4.5:1 minimum).
+                True means this blue shade meets standard accessibility requirements.
+            wcag_2_2_aa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AA threshold (4.5:1). Positive values show the safety margin
+                above the minimum; negative values indicate non-compliance.
+            wcag_2_2_aaa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AAA compliance (7.0:1 minimum).
+                True means this blue shade meets enhanced accessibility for users with low vision.
+            wcag_2_2_aaa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AAA threshold (7.0:1). Positive values exceed the enhanced
+                standard; negative values indicate it meets AA but not AAA.
+          required:
+            - shade
+            - hex
+            - text_color_hex
+            - contrast_ratio
+            - wcag_2_2_aa
+            - wcag_2_2_aaa
+          additionalProperties: false
+
+      green_shades:
+        type: array
+        description: >-
+          Array of 11 green color shades (50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950)
+          for extended design flexibility. Green communicates success, growth, and positive outcomes.
+          Useful for success states, positive indicators, and completion messaging.
+        items:
+          type: object
+          properties:
+            shade:
+              $ref: "#/$defs/shadeNumberEnum"
+              description: >-
+                Shade identifier from 50 (lightest) to 950 (darkest). Green shades 50-400
+                are light and typically used with dark text; shades 500-950 are dark and
+                typically used with white text. Green communicates success, growth, and
+                positive outcomes across the design system.
+            full_name:
+              type: string
+              pattern: "^\\$centos-green-\\d+$"
+              description: >-
+                Full SASS variable name for use in stylesheets
+                (e.g., "$centos-green-500").
+            hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the green shade. Used in CSS, HTML, and design systems.
+                Example: #00A651 (shade 500, the base green for success states).
+            rgb:
+              $ref: "#/$defs/rgbValue"
+              description: >-
+                RGB representation of the green shade. Useful for frameworks and tools
+                requiring RGB color specifications, especially for success messages and
+                positive feedback indicators.
+            hsv:
+              type: string
+              description: >-
+                Hue, Saturation, Value representation. HSV helps understand green's positive,
+                growth-oriented nature across its shade progression, showing saturation and
+                brightness changes that affect perception of success and completion.
+            hue:
+              type: string
+              description: >-
+                Hue component in degrees for this green shade.
+            saturation:
+              type: string
+              description: >-
+                Saturation percentage for this green shade.
+            lightness:
+              type: string
+              description: >-
+                Lightness percentage for this green shade.
+            text_badge:
+              type: string
+              description: >-
+                Bootstrap utility class for this green shade
+                (e.g., "text-bg-centos-green-500").
+            text_color:
+              $ref: "#/$defs/textColorEnum"
+              description: >-
+                Recommended text color (White or Black) for optimal readability on this
+                green shade. Light shades (50-400) use Black; dark shades (500-950) use White.
+            text_color_hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the recommended text color. Used to calculate the
+                contrast ratio and verify WCAG 2.2 accessibility compliance for this green shade.
+            contrast_ratio:
+              $ref: "#/$defs/contrastRatio"
+              description: >-
+                WCAG 2.2 contrast ratio between this green shade and its recommended text color.
+                Important for ensuring success messages and completion indicators are accessible.
+            wcag_2_2_aa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AA compliance (4.5:1 minimum).
+                True means this green shade meets standard accessibility requirements.
+            wcag_2_2_aa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AA threshold (4.5:1). Positive values show the safety margin
+                above the minimum; negative values indicate non-compliance.
+            wcag_2_2_aaa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AAA compliance (7.0:1 minimum).
+                True means this green shade meets enhanced accessibility for users with low vision.
+            wcag_2_2_aaa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from the AAA threshold (7.0:1). Positive values exceed the enhanced
+                standard; negative values indicate it meets AA but not AAA.
+          required:
+            - shade
+            - hex
+            - text_color_hex
+            - contrast_ratio
+            - wcag_2_2_aa
+            - wcag_2_2_aaa
+          additionalProperties: false
+
+      color_pairings:
+        type: array
+        description: >-
+          Array of recommended color pairing combinations for background/accent layering.
+          Defines primary and secondary accent shades that work well together on specific
+          background shades, useful for creating visual hierarchy and multi-color compositions.
+        items:
+          type: object
+          properties:
+            background:
+              type: string
+              description: >-
+                The background shade being used as a base
+                (e.g., "Purple 50", "Orange 500").
+            primary_accent:
+              type: string
+              description: >-
+                The primary accent shade recommended for this background
+                (e.g., "Purple 600").
+            secondary_accent:
+              type: string
+              description: >-
+                The secondary accent shade for layering effects
+                (e.g., "Orange 400").
+            compatibility_icon:
+              type: string
+              description: >-
+                Font Awesome icon class indicating compatibility level
+                (e.g., "fa-solid fa-check" for excellent).
+            compatibility_rating:
+              type: string
+              enum:
+                - Excellent
+                - Good
+                - Fair
+                - Use with caution
+              description: >-
+                Qualitative rating of how well these colors work together.
+                Excellent pairings maintain high contrast and visual hierarchy.
+            notes:
+              type: string
+              description: >-
+                Additional guidance on using this pairing, such as recommended use cases
+                or visual effects achieved.
+          required:
+            - background
+            - primary_accent
+            - secondary_accent
+            - compatibility_rating
+          additionalProperties: false
+
+      shade_selections:
+        type: array
+        description: >-
+          Array defining recommended shade selections for visual hierarchy within each color
+          family. Provides guidance on which shades to use for light, medium, and dark
+          components to maintain consistent design language.
+        items:
+          type: object
+          properties:
+            color_family:
+              type: string
+              enum:
+                - Purple
+                - Orange
+                - Blue
+                - Green
+              description: The color family this selection applies to.
+            light_50_100:
+              type: string
+              description: >-
+                Recommended usage for shades 50-100 (very light variants).
+                Typically used for subtle backgrounds, disabled states, or secondary information.
+            light_300_400:
+              type: string
+              description: >-
+                Recommended usage for shades 300-400 (light-medium variants).
+                Useful for lighter backgrounds or secondary content areas.
+            main_500:
+              type: string
+              description: >-
+                Recommended usage for shade 500 (the main/base color).
+                Primary buttons, key navigation, brand reinforcement.
+            dark_600_700:
+              type: string
+              description: >-
+                Recommended usage for shades 600-700 (dark variants).
+                Hover states, emphasis, higher visual weight.
+          required:
+            - color_family
+            - light_50_100
+            - light_300_400
+            - main_500
+            - dark_600_700
+          additionalProperties: false
+
+      palette:
+        type: array
+        description: >-
+          Array of high-level color palette metadata for each primary color family
+          (Purple, Orange, Blue, Green). Each entry includes full color properties, contrast ratios
+          for white and black text, plus available shade numbers. Useful for template rendering
+          and color system documentation.
+        items:
+          type: object
+          properties:
+            name:
+              type: string
+              description: >-
+                Descriptive name of the color family palette
+                (e.g., "centos-purple", "centos-orange").
+            hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the base/shade 500 color for this palette family.
+                Represents the main color when no specific shade is specified.
+            rgb:
+              $ref: "#/$defs/rgbValue"
+              description: >-
+                RGB representation of the base color for this palette family.
+            hsv:
+              type: string
+              description: >-
+                HSV representation of the base color (Hue, Saturation, Value).
+            hue:
+              type: string
+              description: >-
+                Hue component in degrees for this palette family's base color.
+            saturation:
+              type: string
+              description: >-
+                Saturation percentage for this palette family's base color.
+            lightness:
+              type: string
+              description: >-
+                Lightness percentage for this palette family's base color.
+            text_color:
+              $ref: "#/$defs/textColorEnum"
+              description: >-
+                Recommended text color (White or Black) for this palette's base color.
+            text_color_hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the recommended text color.
+            text_badge:
+              type: string
+              description: >-
+                Bootstrap utility class for this palette family.
+            full_name:
+              type: string
+              description: >-
+                Full SASS variable name for this palette's base color.
+            contrast_ratio:
+              $ref: "#/$defs/contrastRatio"
+              description: >-
+                WCAG 2.2 contrast ratio for this palette's base color.
+            contrast_white:
+              $ref: "#/$defs/contrastRatio"
+              description: >-
+                WCAG 2.2 contrast ratio between this color family's base shade and white text (#FFFFFF).
+                Used to determine if this shade supports white text rendering.
+            contrast_black:
+              $ref: "#/$defs/contrastRatio"
+              description: >-
+                WCAG 2.2 contrast ratio between this color family's base shade and black text (#000000).
+                Used to determine if this shade supports black text rendering.
+            wcag_2_2_aa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AA compliance.
+            wcag_2_2_aa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from AA threshold (4.5:1).
+            wcag_2_2_aaa:
+              type: boolean
+              description: >-
+                Boolean flag indicating WCAG 2.2 Level AAA compliance.
+            wcag_2_2_aaa_margin:
+              $ref: "#/$defs/contrastMargin"
+              description: >-
+                Distance from AAA threshold (7.0:1).
+            shades:
+              type: array
+              items:
+                type: integer
+              description: >-
+                Array of available shade numbers for this color family
+                (e.g., [50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950]).
+          required:
+            - name
+            - hex
+            - shades
+          additionalProperties: false
+
+      base_colors:
+        type: array
+        description: >-
+          Array of base color metadata for the four primary color families (Purple, Orange, Blue, Green).
+          Each entry provides contrast information for both light and dark backgrounds, useful for
+          determining which shades to use in different contexts.
+        items:
+          type: object
+          properties:
+            name:
+              type: string
+              enum:
+                - Purple
+                - Orange
+                - Blue
+                - Green
+              description: The color family name.
+            hex:
+              $ref: "#/$defs/hexColor"
+              description: >-
+                Hexadecimal code of the base color (typically shade 500).
+            color_name:
+              type: string
+              description: >-
+                Human-readable color name for documentation.
+            shade_name:
+              type: string
+              description: >-
+                Full shade identifier (e.g., "centos-purple-500").
+            light_bg_contrast:
+              $ref: "#/$defs/contrastRatio"
+              description: >-
+                WCAG 2.2 contrast ratio when this color is used on a light background.
+            light_bg_status:
+              type: boolean
+              description: >-
+                Boolean flag indicating if this color passes accessibility standards
+                (AA 4.5:1) on light backgrounds.
+            dark_bg_contrast:
+              $ref: "#/$defs/contrastRatio"
+              description: >-
+                WCAG 2.2 contrast ratio when this color is used on a dark background.
+            dark_bg_status:
+              type: boolean
+              description: >-
+                Boolean flag indicating if this color passes accessibility standards
+                (AA 4.5:1) on dark backgrounds.
+          required:
+            - name
+            - hex
+            - color_name
+            - shade_name
+            - light_bg_contrast
+            - light_bg_status
+            - dark_bg_contrast
+            - dark_bg_status
+          additionalProperties: false
+
+      all_shades:
+        type: array
+        description: >-
+          Array of references to all shade collections, mapping each color family
+          to its corresponding shades collection property name. Useful for iterating
+          over all shade groups programmatically.
+        items:
+          type: object
+          properties:
+            collection:
+              type: string
+              enum:
+                - purple_shades
+                - orange_shades
+                - blue_shades
+                - green_shades
+              description: >-
+                Property name of the shade collection in the root object
+                (e.g., "purple_shades").
+          required:
+            - collection
+          additionalProperties: false
+
+    required:
+      - branding_colors
+      - semantic_colors
+      - neutral_colors
+      - purple_shades
+      - orange_shades
+      - blue_shades
+      - green_shades
+      - palette
+      - color_pairings
+      - shade_selections
+      - base_colors
+      - all_shades
+    additionalProperties: false
+
+additionalProperties: false