synedgy.universal.helper

Author(s)

• Gael Colas

Functions

New-UDPsuJobHeader New-UDPsuJobTerminalView Get-ModuleAiTool Get-ModuleApiEndpoint Get-ModuleApiEndpointScriptblock Import-PSUAiTool Import-PSUEndpoint

Dependencies

This module has no dependencies.

Release Notes

## [0.2.0-preview0002] - 2026-07-03

### Added

- Added `New-UDPsuJobHeader` and `New-UDPsuJobTerminalView` public functions
 under `UDComponents`, providing reusable Universal Dashboard components to
 render a PSU job summary header and a terminal-style job output view.
- Added supporting private helpers `Convert-PlainTextToHtml`, `Convert-AnsiToHtml`,
 and `ConvertFrom-PsuJobOutputEntry` used by the new components.
- Added `images/synedgy_pwsh` branding assets used by the new components.
- Added automatic light/dark theming to `New-UDPsuJobHeader` and
 `New-UDPsuJobTerminalView` via a new `-Theme` parameter (`Auto` (default), `Light`,
 `Dark`). `Auto` follows PSU's own theme switch live (no page reload), using the
 `data-theme` attribute PSU sets on `<html>`. The light palette is inspired by the
 classic PowerShell ISE / VS Code light theme colors. Added a `-CustomCss`
 parameter on both components for further customizing the look with raw CSS,
 which is appended after (and can override) the theme rules.
- Added private helpers `Get-UDPsuJobThemePalette`, `Get-UDPsuJobThemeStyleBlock`,
 and `ConvertTo-UDPsuThemedIconMarkup` supporting the new theming feature. The
 themed icon helper always uses the plain monochrome `pwsh_custom_black.svg`
 icon for light theme and `pwsh_custom_white.svg` for dark theme.
- Added `-HideLineNumbers` and `-HideTimestamps` switch parameters to
 `New-UDPsuJobTerminalView` to control whether line numbers and timestamps are
 shown by default for a first-time viewer (shown by default when omitted). A
 viewer's own manual toggle choice, remembered in `localStorage`, still takes
 precedence over these defaults on later visits.
- Added an `AiTool` class attribute (mirroring the existing `APIEndpoint` attribute
 pattern) that can decorate a public function to expose it as a PowerShell
 Universal AI tool. Added `Get-ModuleAiTool`, which scans a module's exported
 functions for `[AiTool()]`-decorated commands and builds their registration
 metadata (`Name`, `Description`, `ScriptFullPath`, `Authenticated`, `Role`,
 `Mcp`, `Environment`), and `Import-PSUAiTool`, which registers each discovered
 function as a PSU Script (`New-PSUScript`) and AI tool (`New-PSUAiTool`) in one
 call, analogous to how `Import-PSUEndpoint` wires up `[APIEndpoint()]`-decorated
 functions.
- Added `source/WikiSource` (Home, UD Job Components, API Endpoint Attribute, AI
 Tool Attribute, PSU Platform Notes pages, and screenshots) as the canonical
 source for the published GitHub wiki, and wired the `DscResource.DocGenerator`
 tasks (`Create_Wiki_Output_Folder`, `Generate_Conceptual_Help`,
 `Generate_Markdown_For_Public_Commands`,
 `Generate_External_Help_File_For_Public_Commands`,
 `Clean_Markdown_Of_Public_Commands`, `Copy_Source_Wiki_Folder`,
 `Generate_Wiki_Sidebar`, `Clean_Markdown_Metadata`) into the `build` workflow, a
 new `docs` workflow (`Package_Wiki_Content`) into `pack`, and enabled
 `Publish_GitHub_Wiki_Content` in the `publish` workflow in `build.yaml`. Added
 `PlatyPS` to `RequiredModules.psd1` (required for command markdown generation).

### Changed

- `ConvertFrom-PsuJobOutputEntry`'s `StreamColor` property now returns a CSS
 `var(--psu-term-stream-*)` reference instead of a literal hex color, so job
 output stream coloring follows the light/dark theme instead of being fixed to
 one palette. This is a private helper; the change is only user-visible via the
 themed rendering of `New-UDPsuJobTerminalView`.

- Changed Warning messages to Debug messages when overriding type accelerators.
 This is to reduce noise in the output and only show warnings for actual issues.

### Fixed

- Fixed the themed icon (top-right/title-bar `>_` icon) in `New-UDPsuJobHeader` and
 `New-UDPsuJobTerminalView` always rendering the light (black) variant regardless
 of PSU's active theme when `-Theme Auto` (the default). `ConvertTo-UDPsuThemedIconMarkup`
 was setting the light/dark icon spans' default visibility via an inline `style`
 attribute, which always takes precedence over stylesheet rules regardless of CSS
 specificity -- so `Get-UDPsuJobThemeStyleBlock`'s `html[data-theme="dark"]` override
 rule could never actually flip visibility. The default and dark-mode-override
 display rules are now both defined in the `<style>` block instead, so the icon
 correctly switches color when the PSU theme switch is toggled live.
- Fixed how the ApiVersion is set and can be overridden.
- Fixed how the Documentation is set and can be overridden.