feat: add copyWithStyle property to StacText.

[Abdalqader27]

Description

• A new copyWithStyle property of type StacTextStyle? has been introduced to both StacText and StacTextSpan. This allows for selectively overriding properties of a predefined base text style.

Enhanced style merging behavior:

• The copyWithStyle property enables developers to build on top of existing styles (e.g., "labelMedium") by overriding specific attributes such as color, font weight, or letter spacing, without redefining the entire style.

Updated StacTextParser:

• Introduced a _resolveStyle method to merge style and copyWithStyle values into a single TextStyle, giving priority to the override values from copyWithStyle.

• The _buildTextSpan method now applies _resolveStyle to each child span, ensuring consistent style resolution.

Example:

{
  "type": "text",
  "data": "Hello, ",
  "style": "bodyLarge",
  "copyWithStyle": {
    "color": "#000000"
  },
  "children": [
    {
      "data": "John",
      "style": "bodyLarge",
      "copyWithStyle": {
        "color": "#2196F3",
        "fontWeight": "bold"
      }
    },
    {
      "data": "! Welcome to ",
      "style": "bodyLarge"
    },
    {
      "data": "Flutter",
      "style": "bodyLarge",
      "copyWithStyle": {
        "color": "#4CAF50",
        "fontStyle": "italic",
        "decoration": "underline"
      }
    },
    {
      "data": " world.",
      "style": "bodyLarge"
    }
  ]
}

Related Issues

Closes #249

Type of Change

• New feature (non-breaking change which adds functionality)
• Bug fix (non-breaking change which fixes an issue)
• Breaking change (fix or feature that would cause existing functionality to change)
• Code refactor
• Build configuration change
• Documentation
• Chore

[divyanshub024]

Hey @Abdalqader27!! Thank you for this amazing PR. There are some formatting issues. Can you please check them?

https://github.com/StacDev/stac/actions/runs/15293316177/job/43023165207?pr=262

[Abdalqader27]

Hey @Abdalqader27!! Thank you for this amazing PR. There are some formatting issues. Can you please check them?

https://github.com/StacDev/stac/actions/runs/15293316177/job/43023165207?pr=262

You 're welcome @divyanshub024 , SOLVED

[Abdalqader27]

@divyanshub024 now we 're good

[divyanshub024]

Thank you for your contribution @Abdalqader27 🎉