Miss documentation, Bar plugin API: documented bar.foreground doesn't match the color native widgets actually use (bar.barForeground)

[aryanhv]

Summary

shell/plugins/bar/README.md ("Bar properties available to widgets") documents
bar.foreground as the color third-party bar widgets should use for their text/icons:

bar.foreground, bar.background, bar.urgent — theme colors (live-updated)

However, every first-party widget (Workspaces, Clock, Weather, Microphone, etc.)
renders its text through Ui/WidgetButton.qml, which does not use bar.foreground.
It uses a different, undocumented property:

property color foreground: bar ? bar.barForeground : Color.foreground

On themes where foreground and barForeground diverge (Everforest, for example),
a third-party widget written strictly against the documented API ends up a visibly
different color than every native widget sitting next to it in the bar.

Steps to reproduce

1. Set theme to Everforest.
2. Build a minimal custom bar module using the exact example from the docs:

   Text {
     color: bar ? bar.foreground : "white"
     ...
   }

3. Place it next to the built-in Workspaces widget or Clock label.
4. Compare colors — they don't match.

Expected

bar.foreground (the documented property) should produce the same color native
widgets use for their on-bar text, since that's the only theming API third-party
widgets have.

Actual

• Native widgets resolve color via the undocumented bar.barForeground.
• The docs only mention bar.foreground.
• On Everforest, bar.foreground resolves to a light color while bar.barForeground
  (what's actually rendered natively) resolves to black — so a plugin following
  the documented API visibly clashes with the rest of the bar.

Suggested fix (either resolves it)

• Document bar.barForeground in the "Bar properties available to widgets" table, or
• Make bar.foreground resolve to the same value WidgetButton currently gets from
  barForeground, so the documented property is the correct one.

Environment

• Omarchy version: Omarchy 4.0.2-1
• Theme: Everforest, Gruvebox and ...
• Relevant files: shell/Ui/WidgetButton.qml, shell/plugins/bar/README.md