Fix Matugen Color Extraction from Mode-Based Objects

[ZODIAC3K]

Issue: #1128

Matugen was returning color objects with mode-based properties ({dark, default, light}) instead of hex strings when using --json hex flag. The getMatugenHex() function expected hex strings but received objects, causing errors like:

[Matugen] Invalid color properties (not hex colors): background (value: [object Object]), ...

The function getMatugenVariations() tried to access properties like matugenColors.primary expecting a hex string, but got an object instead.

Solution

Added destructuring logic in generateMatugenColors() to extract hex values from mode-based color objects:

• Extracts the correct color based on the selected mode (dark or light)
• Falls back to default if mode-specific color is not available
• Handles edge cases (direct hex property, RGB values)
• Added comprehensive comments documenting the structure transformation

Changes

src/services/matugen/index.ts

• Added color object destructuring logic to extract hex values based on mode
• Added detailed comments documenting the structure before/after destructuring
• Removed excessive validation code
• Added comment in getMatugenHex() clarifying it expects destructured hex strings

env.d.ts

• Added TypeScript declaration for GIF file imports (*.gif)

src/style/optionsTrackers.ts

• Fixed TypeScript error for connect() method on WallpaperService by adding type assertion to GObject.Object

.gitignore

• Added pnpm-lock.yaml to ignore list

Testing

• ✅ Matugen colors are correctly extracted from mode-based objects
• ✅ Bar colors update correctly when wallpaper changes
• ✅ Matugen works for both dark and light modes

Example

Before (what matugen returns):

{
    "colors": {
        "primary": { "dark": "#4dd0a6", "default": "#4dd0a6", "light": "#006c4c" },
        "background": { "dark": "#0f1512", "default": "#0f1512", "light": "#f5fbf6" }
    }
}

After (what we pass to getMatugenHex):

{
    "primary": "#4dd0a6", // extracted from obj[mode] or obj.default
    "background": "#0f1512"
}