### Install XAMLgui Module

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Installs the XAMLgui module from the PowerShell gallery. Ensure you have an active internet connection.

```powershell
Install-Module -name XAMLgui
```

--------------------------------

### Start Await Job with InitBlock

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Initiates a job that can be awaited, with support for an initialization block. The InitBlock can be constructed using Get-FnAsString.

```powershell
Start-AwaitJob -InitBlock (@( Get-FnAsString "fn1", Get-FnAsString "fn2" ) -Join "`n")
```

--------------------------------

### Download XAMLgui Module Locally

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Saves the XAMLgui module to the current directory without installing it globally. This creates a subfolder for the module.

```powershell
Save-Module -Name XAMLgui -Path .\
```

--------------------------------

### Add Type Assembly

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Example of adding types from System.Drawing and System.Windows.Forms assemblies, as mentioned in v1.1.5.

```powershell
Add-Type -AssemblyName System.Drawing,System.Windows.Forms
```

--------------------------------

### Module Management Functions

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Functions for finding, getting, and importing local modules.

```APIDOC
## Find-LocalModulePath

### Description
Find the path of a module in the current directory.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **Name** (string) - Required - The name of the module.
- **Path** (String) - Optional - The base path to search in. Defaults to ".\ps-modules".

### Request Example
```powershell
Find-LocalModulePath -Name "MyModule"
```

### Response
- **string** - The path to the module if found.
```

```APIDOC
## Get-LocalModule

### Description
Get the path of a module in the current directory if it exists, otherwise download it and return its path.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **Name** (string) - Required - The name of the module.
- **Path** (String) - Optional - The base path to search in. Defaults to ".\ps-modules".
- **Download** (Boolean) - Optional - Whether to download the module if not found. Defaults to $True.

### Request Example
```powershell
Get-LocalModule -Name "MyModule" -Download $true
```

### Response
- **string** - The path to the module.
```

```APIDOC
## Import-LocalModule

### Description
Import a module from the current directory's `\ps-module` folder.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **Name** (string) - Required - The name of the module.
- **Path** (String) - Optional - The base path to search in. Defaults to ".\ps-modules".
- **Download** (Boolean) - Optional - Whether to download the module if not found. Defaults to $True.

### Request Example
```powershell
Import-LocalModule -Name "MyModule"
```

### Response
None
```

```APIDOC
## Set-LocalModulePathBase

### Description
Use to set the a default path for LocalModule commands.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **Path** (string) - Required - The base path for local modules.

### Request Example
```powershell
Set-LocalModulePathBase -Path "C:\Modules"
```

### Response
None
```

--------------------------------

### Start Await Job Arguments Type

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Ensures the -Arguments parameter for Start-AwaitJob is of the correct Object[] type. This was a fix in v1.1.4.

```powershell
Start-AwaitJob -Arguments
```

--------------------------------

### Start and Wait for AwaitJob

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Runs long-running operations in background jobs, keeping the UI responsive. Supports synchronous blocking and asynchronous execution with optional initialization blocks and working directories. Requires XAMLgui module import.

```powershell
Import-Module -Name XAMLgui

# Synchronous background job (blocks but keeps UI responsive)
$result = Start-AwaitJob -ScriptBlock {
    param($url)
    Invoke-WebRequest -Uri $url -UseBasicParsing
    return "Download complete"
} -ArgumentList @("https://example.com/data.json")

Write-Host $result
```

```powershell
# Asynchronous background job
$job = Start-AwaitJob -ScriptBlock {
    Start-Sleep -Seconds 5
    return "Long operation finished"
} -Await $False

# Do other work while job runs...
Write-Host "Job started, continuing with other work..."

# Wait for completion when ready
$result = Wait-AwaitJob $job
Write-Host $result
```

```powershell
# Job with working directory and initialization block
$result = Start-AwaitJob -ScriptBlock {
    Get-ChildItem | Select-Object Name
} -Dir "C:\Projects" -InitBlock "Import-Module MyModule"
```

--------------------------------

### Get File Icon

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Retrieves an icon from a file, suitable for window icons or notification bubbles.

```powershell
Get-IconFromFile
```

--------------------------------

### Get XAMLgui Version

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Retrieves the version of the XAMLgui module. Useful when files are loaded directly without importing the module.

```powershell
Get-XAMLguiVersion
```

--------------------------------

### Get Function as String

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Useful for dynamically generating script blocks, particularly for functions like Start-AwaitJob. Ensure functions are defined before calling this.

```powershell
Get-FnAsString
```

--------------------------------

### Get Local Module

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Downloads a module if it's not present and returns its path. In v1.1.4, it was updated to use the '\ps-modules' subfolder.

```powershell
Get-LocalModule
```

--------------------------------

### Get Known Events

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Lists events that are recognized by XAMLgui. In v1.1.7, more events were added, and Add-KnownEventsByControlName was introduced.

```powershell
Get-KnownEvents
```

--------------------------------

### Get PowerShell Interpreter Path

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Retrieves the current PowerShell executable path and checks for the availability of 'powershell.exe' or 'pwsh.exe'.

```powershell
Get-PowershellInterpreter
```

--------------------------------

### Initialize and Display Window

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Loads a XAML file to generate UI elements and the window object, then displays the window.

```PowerShell
$Elements, $Window = . New-Window ".\MainWindow.xaml" -Debug

# Show main window
$Window | Show-Window
```

--------------------------------

### Initialize Application Workflow

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Sets up the application environment by hiding the console and enabling visual styles.

```powershell
Import-Module -Name XAMLgui

# Hide console for clean GUI experience
Hide-Console | Out-Null
Enable-VisualStyles
```

--------------------------------

### Set-RunOnce

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Configures a script to run automatically at next Windows startup using the RunOnce registry key.

```APIDOC
## Set-RunOnce

### Description
Configures a script to run automatically at next Windows startup using the RunOnce registry key.

### Method
POST

### Endpoint
N/A (Function within a module)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **KeyName** (string) - Required - A unique name for the RunOnce entry.
- **Command** (string) - Optional - The command to execute. Defaults to the current script.
- **Params** (string) - Optional - Parameters to pass to the command.
- **Interpreter** (string) - Optional - The path to the interpreter (e.g., PowerShell.exe).

### Request Example
```powershell
# Run current script at next startup
Set-RunOnce -KeyName "MyAppSetup"

# Run a specific script with custom command
Set-RunOnce -KeyName "ConfigureSystem" `
            -Command "-executionpolicy bypass -file `"C:\Setup\configure.ps1`"" `
            -Params "-Silent"

# Specify PowerShell interpreter explicitly
Set-RunOnce -KeyName "UpdateCheck" `
            -Command "-file `"C:\MyApp\update.ps1`"" `
            -Interpreter "C:\Program Files\PowerShell\7\pwsh.exe"
```

### Response
#### Success Response (200)
- **Status** (string) - Indicates success or failure of setting the RunOnce key.

#### Response Example
```json
{
  "Status": "Success"
}
```
```

--------------------------------

### Get Write Error Clean Mode

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Retrieves the current mode for Write-ErrorClean. This function was added in v1.1.6.

```powershell
Get-WriteErrorCleanMode
```

--------------------------------

### Configure RunOnce Registry Keys

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Schedules scripts to run at the next Windows startup.

```powershell
Import-Module -Name XAMLgui

# Run current script at next startup
Set-RunOnce -KeyName "MyAppSetup"

# Run a specific script with custom command
Set-RunOnce -KeyName "ConfigureSystem" `
            -Command "-executionpolicy bypass -file `"C:\Setup\configure.ps1`"" `
            -Params "-Silent"

# Specify PowerShell interpreter explicitly
Set-RunOnce -KeyName "UpdateCheck" `
            -Command "-file `"C:\MyApp\update.ps1`"" `
            -Interpreter "C:\Program Files\PowerShell\7\pwsh.exe"

# Get current interpreter info
$current, $available = Get-PowershellInterpreter
Write-Host "Current: $current"
Write-Host "Available: $($available | ConvertTo-Json)"
```

--------------------------------

### Create a window from a XAML file

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Loads a WPF window from a local file and binds event handlers using the naming convention WindowClass.ElementEventName.

```powershell
Import-Module -Name XAMLgui

# Define event handler using naming convention: WindowClass.ElementEventName
function ProjectTest1.MainWindow.btnSubmit_Click($Sender, $EventArgs) {
    Show-MessageBox "Button was clicked!"
}

# Load window from XAML file (dot-source to enable handler binding)
$Elements, $MainWindow = . New-Window ".\MainWindow.xaml" -Debug

# Access named elements directly
$Elements.txtUsername.Text = "DefaultUser"
$Elements.lvItems.ItemsSource = @("Item1", "Item2", "Item3")

# Display the window as a modal dialog
$MainWindow | Show-Window
```

--------------------------------

### Create a window from a XAML string

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Initializes a window directly from a XAML string, useful for dynamic UI generation.

```powershell
Import-Module -Name XAMLgui

$xamlContent = @"
<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Quick Dialog" Height="150" Width="300">
    <StackPanel Margin="10">
        <TextBlock Text="Enter your name:" />
        <TextBox x:Name="txtName" Margin="0,5,0,10" />
        <Button x:Name="btnOK" Content="OK" Width="75" />
    </StackPanel>
</Window>
"@

$Elements, $Window = New-WindowXamlString $xamlContent

$Elements.btnOK.Add_Click({
    $script:UserName = $Elements.txtName.Text
    $Window.Close()
})

$Window | Show-Window
Write-Host "User entered: $UserName"
```

--------------------------------

### Window Creation and Display Functions

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Functions for creating and showing windows from XAML, URLs, or XAML strings.

```APIDOC
## New-Window

### Description
Create a new window from a XAML file.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **XamlPath** (string) - Required - The path to the XAML file.
- **Debug** (bool) - Optional - Enable debug mode.

### Request Example
```powershell
New-Window -XamlPath "C:\MyWindow.xaml" -Debug $true
```

### Response
- **object** - The created window object.
```

```APIDOC
## New-WindowUrl

### Description
Create a new window from a URL.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **Url** (string) - Required - The URL to load.
- **Debug** (bool) - Optional - Enable debug mode.

### Request Example
```powershell
New-WindowUrl -Url "http://example.com/window.xaml" -Debug $true
```

### Response
- **object** - The created window object.
```

```APIDOC
## New-WindowXamlString

### Description
Create a new window from a XAML string.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **XamlString** (string) - Required - The XAML content as a string.
- **Debug** (bool) - Optional - Enable debug mode.

### Request Example
```powershell
New-WindowXamlString -XamlString "<Window xmlns='http://schemas.microsoft.com/winfx/2006/xaml/presentation'>Hello</Window>" -Debug $true
```

### Response
- **object** - The created window object.
```

```APIDOC
## Show-Window

### Description
Show the window with the dialog window style.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **window** ([$Elements)|$(Window]) - Required - The window object to show.
- **dialog** (bool) - Optional - Whether to show as a dialog window. Defaults to $true.

### Request Example
```powershell
$myWindow = New-Window -XamlPath "MyWindow.xaml"
Show-Window -window $myWindow -dialog $false
```

### Response
None
```

--------------------------------

### New-Window

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Creates a new WPF window from a XAML file and returns an elements hashtable with all named UI elements and the window object. Automatically parses the XAML, binds event handlers based on function naming conventions, and prepares the window for display.

```APIDOC
## New-Window

### Description
Creates a new WPF window from a XAML file and returns an elements hashtable with all named UI elements and the window object. Automatically parses the XAML, binds event handlers based on function naming conventions, and prepares the window for display.

### Method
`New-Window`

### Parameters
#### Path Parameters
- **Path** (string) - Required - The path to the XAML file.
- **Debug** (switch) - Optional - Enables debug output during window creation.

#### Request Body
None

### Request Example
```powershell
Import-Module -Name XAMLgui

# Define event handler using naming convention: WindowClass.ElementEventName
function ProjectTest1.MainWindow.btnSubmit_Click($Sender, $EventArgs) {
    Show-MessageBox "Button was clicked!"
}

# Load window from XAML file (dot-source to enable handler binding)
$Elements, $MainWindow = . New-Window ".\MainWindow.xaml" -Debug

# Access named elements directly
$Elements.txtUsername.Text = "DefaultUser"
$Elements.lvItems.ItemsSource = @("Item1", "Item2", "Item3")

# Display the window as a modal dialog
$MainWindow | Show-Window
```

### Response
#### Success Response (200)
- **Elements** (hashtable) - A hashtable containing all named UI elements from the XAML.
- **MainWindow** (System.Windows.Window) - The main window object.

#### Response Example
```powershell
# Example response structure (actual content depends on XAML)
$Elements = @{
    txtUsername = [System.Windows.Controls.TextBox]
    lvItems = [System.Windows.Controls.ListView]
    btnSubmit = [System.Windows.Controls.Button]
}
$MainWindow = [System.Windows.Window]
```
```

--------------------------------

### Basic XAMLgui Usage with Event Handler

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Imports the XAMLgui module, hides the console, defines a simple event handler for a button click, and then displays a XAML window. The event handler must match the window class name and element's event name.

```powershell
Import-Module -Name XAMLgui

Hide-Console | Out-Null

Function ProjectTest1.MainWindow.btnHelloWorld_Click {
    Show-MessageBox "Hello World!"
}

. New-Window .\MainWindow.xaml -Debug | Show-Window
```

--------------------------------

### Configure Known Events and Window Loading

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Sets the list of events to track and initializes a window from a XAML file.

```powershell
Set-KnownEvents @(
    "Click", "MouseDown", "MouseUp",
    "KeyDown", "KeyUp", "TextChanged",
    "SelectionChanged", "Loaded", "Closing"
)

# Now load window with custom event detection
$Elements, $Window = . New-Window ".\MainWindow.xaml" -Debug
```

--------------------------------

### Version Information

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Function to retrieve the XAMLgui version.

```APIDOC
## Get-XAMLguiVersion

### Description
Returns the current XAMLgui version (because: loading the files directly without importing, would not provide the version).

### Method
Cmdlet

### Endpoint
N/A

### Parameters
None

### Request Example
```powershell
Get-XAMLguiVersion
```

### Response
- **string** - The current XAMLgui version.
```

--------------------------------

### Select Folder Dialog

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Opens a folder browser dialog for single or multiple folder selection. Supports custom titles, descriptions, initial paths, and new folder creation. Requires XAMLgui module import.

```powershell
Import-Module -Name XAMLgui

# Simple folder selection
$folder = Select-FolderDialog -Title "Select Output Folder"
```

```powershell
if ($folder) {
    Write-Host "Selected folder: $folder"
}
```

```powershell
# Advanced folder dialog with options
$folders = Select-FolderDialog -Title "Select Backup Locations" `
                               -Description "Choose folders to include in backup" `
                               -Path "C:\Users" `
                               -Multiselect $true `
                               -ShowNewFolderButton $true
```

```powershell
foreach ($folder in $folders) {
    Write-Host "Will backup: $folder"
}
```

--------------------------------

### Select File Dialog

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Opens a file browser dialog for selecting one or multiple files. Allows filtering by extension and setting an initial path. Requires XAMLgui module import.

```powershell
Import-Module -Name XAMLgui

# Select image files
$files = Select-FileDialog -Title "Select Images" `
                           -Filter "Images (*.jpg, *.png)|*.jpg;*.png" `
                           -Multiselect $true
```

```powershell
foreach ($file in $files) {
    Write-Host "Selected: $file"
}
```

```powershell
# Select configuration file
$configFile = Select-FileDialog -Title "Select Configuration" `
                               -Path "C:\MyApp\Config" `
                               -Filter "Config Files (*.ini, *.xml)|*.ini;*.xml|All Files (*.*)|*.*"
```

```powershell
if ($configFile) {
    $config = Get-Content $configFile
}
```

```powershell
# Select PowerShell scripts
$scripts = Select-FileDialog -Title "Select Scripts to Run" `
                             -Filter "PowerShell (*.ps1)|*.ps1" `
                             -Multiselect $true
```

--------------------------------

### Set Run Once Script Execution

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Configures a script to run once at startup. In v1.1.7, it defaults to the currently used PowerShell version with a full path. In v1.1.3, an -Interpreter parameter was added.

```powershell
Set-RunOnce
```

--------------------------------

### Show-Window

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Displays a window either as a modal dialog (blocking) or non-modal window (non-blocking). Accepts both window objects and element hashtables.

```APIDOC
## Show-Window

### Description
Displays a window either as a modal dialog (blocking) or non-modal window (non-blocking). Accepts both window objects and element hashtables.

### Method
`Show-Window`

### Parameters
#### Path Parameters
None

#### Query Parameters
- **dialog** (boolean) - Optional - If `$True` (default), shows the window as a modal dialog. If `$False`, shows it as a non-modal window.

#### Request Body
None

### Request Example
```powershell
Import-Module -Name XAMLgui

$Elements, $MainWindow = . New-Window ".\MainWindow.xaml"

# Show as modal dialog (default) - blocks until window is closed
$MainWindow | Show-Window

# Show as non-modal window - continues script execution
$MainWindow | Show-Window -dialog $False

# Can also pass the elements hashtable directly
$Elements | Show-Window -dialog $False
```

### Response
None (This function displays a window and does not return a value directly related to the display operation itself.)
```

--------------------------------

### Import Local Module

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Loads a module from the '.\ps_modules' directory, with the capability to download and import it if necessary. Added in v1.1.3.

```powershell
Import-LocalModule
```

--------------------------------

### Load a window from a remote URL

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Fetches a XAML definition from a remote URL to enable centralized UI management.

```powershell
Import-Module -Name XAMLgui

# Load XAML from a remote URL
$Elements, $Window = New-WindowUrl "https://example.com/ui/MainWindow.xaml" -Debug

# Attach handlers after loading
$Elements.btnRefresh.Add_Click({
    Write-Host "Refreshing data..."
})

$Window | Show-Window
```

--------------------------------

### Start-AwaitJob and Wait-AwaitJob

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Runs long-running operations in background jobs while keeping the UI responsive, with optional async execution.

```APIDOC
## Start-AwaitJob and Wait-AwaitJob

### Description
Runs long-running operations in background jobs while keeping the UI responsive, with optional async execution.

### Method
Cmdlet

### Endpoint
N/A (Local cmdlets)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```powershell
# Synchronous background job (blocks but keeps UI responsive)
$result = Start-AwaitJob -ScriptBlock {
    param($url)
    Invoke-WebRequest -Uri $url -UseBasicParsing
    return "Download complete"
} -ArgumentList @("https://example.com/data.json")

Write-Host $result

# Asynchronous background job
$job = Start-AwaitJob -ScriptBlock {
    Start-Sleep -Seconds 5
    return "Long operation finished"
} -Await $False

# Do other work while job runs...
Write-Host "Job started, continuing with other work..."

# Wait for completion when ready
$result = Wait-AwaitJob $job
Write-Host $result

# Job with working directory and initialization block
$result = Start-AwaitJob -ScriptBlock {
    Get-ChildItem | Select-Object Name
} -Dir "C:\Projects" -InitBlock "Import-Module MyModule"
```

### Response
#### Success Response (200)
- **$result** (string or object) - The result of the background job's script block execution.
- **$job** (object) - A job object representing the background task.

#### Response Example
```powershell
# Example for synchronous job result
"Download complete"

# Example for asynchronous job result after waiting
"Long operation finished"

# Example for job with working directory
[
  { "Name": "file1.txt" },
  { "Name": "script.ps1" }
]
```
```

--------------------------------

### New-WindowXamlString

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Creates a window directly from a XAML string instead of a file, useful for dynamically generated interfaces or embedded UI definitions.

```APIDOC
## New-WindowXamlString

### Description
Creates a window directly from a XAML string instead of a file, useful for dynamically generated interfaces or embedded UI definitions.

### Method
`New-WindowXamlString`

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **XamlString** (string) - Required - The XAML content as a string.

### Request Example
```powershell
Import-Module -Name XAMLgui

$xamlContent = @"
<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Quick Dialog" Height="150" Width="300">
    <StackPanel Margin="10">
        <TextBlock Text="Enter your name:" />
        <TextBox x:Name="txtName" Margin="0,5,0,10" />
        <Button x:Name="btnOK" Content="OK" Width="75" />
    </StackPanel>
</Window>
"@

$Elements, $Window = New-WindowXamlString $xamlContent

$Elements.btnOK.Add_Click({
    $script:UserName = $Elements.txtName.Text
    $Window.Close()
})

$Window | Show-Window
Write-Host "User entered: $UserName"
```

### Response
#### Success Response (200)
- **Elements** (hashtable) - A hashtable containing all named UI elements from the XAML.
- **Window** (System.Windows.Window) - The main window object.

#### Response Example
```powershell
# Example response structure (actual content depends on XAML)
$Elements = @{
    txtName = [System.Windows.Controls.TextBox]
    btnOK = [System.Windows.Controls.Button]
}
$Window = [System.Windows.Window]
```
```

--------------------------------

### Handle Window Class Optional

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

The 'class' attribute in '<Window class=""' is now optional. Handlers can be attached without needing a class string prefix if no class is specified. Changed in v1.1.0.

```powershell
New-Window*
```

--------------------------------

### New-WindowUrl

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Loads a XAML window definition from a remote URL, enabling centralized UI definitions or dynamic interface loading.

```APIDOC
## New-WindowUrl

### Description
Loads a XAML window definition from a remote URL, enabling centralized UI definitions or dynamic interface loading.

### Method
`New-WindowUrl`

### Parameters
#### Path Parameters
- **Url** (string) - Required - The URL of the XAML file.
- **Debug** (switch) - Optional - Enables debug output during window creation.

#### Query Parameters
None

#### Request Body
None

### Request Example
```powershell
Import-Module -Name XAMLgui

# Load XAML from a remote URL
$Elements, $Window = New-WindowUrl "https://example.com/ui/MainWindow.xaml" -Debug

# Attach handlers after loading
$Elements.btnRefresh.Add_Click({
    Write-Host "Refreshing data..."
})

$Window | Show-Window
```

### Response
#### Success Response (200)
- **Elements** (hashtable) - A hashtable containing all named UI elements from the XAML.
- **Window** (System.Windows.Window) - The main window object.

#### Response Example
```powershell
# Example response structure (actual content depends on XAML)
$Elements = @{
    btnRefresh = [System.Windows.Controls.Button]
}
$Window = [System.Windows.Window]
```
```

--------------------------------

### Select-FileDialog

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Opens a file browser dialog for selecting one or multiple files with configurable filters.

```APIDOC
## Select-FileDialog

### Description
Opens a file browser dialog for selecting one or multiple files with configurable filters.

### Method
Cmdlet

### Endpoint
N/A (Local cmdlet)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```powershell
# Select image files
$files = Select-FileDialog -Title "Select Images" `
                           -Filter "Images (*.jpg, *.png)|*.jpg;*.png" `
                           -Multiselect $true

foreach ($file in $files) {
    Write-Host "Selected: $file"
}

# Select configuration file
$configFile = Select-FileDialog -Title "Select Configuration" `
                                -Path "C:\MyApp\Config" `
                                -Filter "Config Files (*.ini, *.xml)|*.ini;*.xml|All Files (*.*)|*.*

if ($configFile) {
    $config = Get-Content $configFile
}

# Select PowerShell scripts
$scripts = Select-FileDialog -Title "Select Scripts to Run" `
                             -Filter "PowerShell (*.ps1)|*.ps1" `
                             -Multiselect $true
```

### Response
#### Success Response (200)
- **$files** (array of strings) - An array of paths to the selected files.
- **$configFile** (string) - The path to the selected configuration file.
- **$scripts** (array of strings) - An array of paths to the selected PowerShell scripts.

#### Response Example
```powershell
# Example for multiple file selection
[
  "C:\Images\photo1.jpg",
  "C:\Images\photo2.png"
]

# Example for single file selection
"C:\MyApp\Config\settings.ini"
```
```

--------------------------------

### Handlers with ScriptBlock

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Pass event handlers directly to New-Window using a scriptblock parameter, keeping handlers encapsulated with the window creation.

```APIDOC
## Handlers with ScriptBlock

### Description
Pass event handlers directly to `New-Window` using a scriptblock parameter, keeping handlers encapsulated with the window creation.

### Method
`New-Window` with `-Handlers` parameter

### Parameters
#### Path Parameters
- **Path** (string) - Required - The path to the XAML file.
- **Debug** (switch) - Optional - Enables debug output during window creation.
- **Handlers** (scriptblock) - Optional - A scriptblock containing function definitions for event handlers.

#### Query Parameters
None

#### Request Body
None

### Request Example
```powershell
Import-Module -Name XAMLgui

$Elements, $MainWindow = . New-Window ".\MainWindow.xaml" -Debug -Handlers {
    function Updater.MainWindow.DoActions_Click {
        Write-Host "Action button clicked"
        Show-MessageBox "Processing complete!"
    }

    function Updater.MainWindow.LbCopy_MouseDown($Sender, $EventArgs) {
        Show-MessageBox "Copyright clicked"
    }

    Write-Host "Handlers loaded successfully"
}

$MainWindow | Show-Window
```

### Response
#### Success Response (200)
- **Elements** (hashtable) - A hashtable containing all named UI elements from the XAML.
- **MainWindow** (System.Windows.Window) - The main window object.

#### Response Example
```powershell
# Example response structure (actual content depends on XAML)
$Elements = @{
    DoActions = [System.Windows.Controls.Button]
    LbCopy = [System.Windows.Controls.Label]
}
$MainWindow = [System.Windows.Window]
```
```

--------------------------------

### Attach Manual Event Handlers

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Use the Add_Click method on UI elements for dynamic or custom event handling logic.

```PowerShell
$Elements.btnExit.Add_Click({
    $result = Show-MessageBox -Message "Are you sure you want to exit?" `
                              -Title "Confirm Exit" `
                              -Type "Question" `
                              -Buttons "YesNo"
    if ($result -eq "Yes") {
        $Window.Close()
    }
})
```

--------------------------------

### Dot-source event handlers with New-Window

Source: https://github.com/bananaacid/xamlgui/blob/main/docs/README.md

Handlers can be defined and dot-sourced before calling New-Window.

```powershell
Function Updater.MainWindow.DoActions_Click {
    Show-MessageBox "1"
}

$Elements,$MainWindow = . New-Window $XamlFile -Debug
```

--------------------------------

### Display windows with Show-Window

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Controls window visibility as either a modal or non-modal dialog.

```powershell
Import-Module -Name XAMLgui

$Elements, $MainWindow = . New-Window ".\MainWindow.xaml"

# Show as modal dialog (default) - blocks until window is closed
$MainWindow | Show-Window

# Show as non-modal window - continues script execution
$MainWindow | Show-Window -dialog $False

# Can also pass the elements hashtable directly
$Elements | Show-Window -dialog $False
```

--------------------------------

### Select-FolderDialog

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Opens a folder browser dialog allowing users to select one or multiple folders with customizable options.

```APIDOC
## Select-FolderDialog

### Description
Opens a folder browser dialog allowing users to select one or multiple folders with customizable options.

### Method
Cmdlet

### Endpoint
N/A (Local cmdlet)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```powershell
# Simple folder selection
$folder = Select-FolderDialog -Title "Select Output Folder"

if ($folder) {
    Write-Host "Selected folder: $folder"
}

# Advanced folder dialog with options
$folders = Select-FolderDialog -Title "Select Backup Locations" `
                               -Description "Choose folders to include in backup" `
                               -Path "C:\Users" `
                               -Multiselect $true `
                               -ShowNewFolderButton $true

foreach ($folder in $folders) {
    Write-Host "Will backup: $folder"
}
```

### Response
#### Success Response (200)
- **$folder** (string) - The path to the selected folder.
- **$folders** (array of strings) - An array of paths to the selected folders when multiselect is enabled.

#### Response Example
```powershell
# Example for single folder selection
"C:\Users\Public\Documents"

# Example for multi-folder selection
[
  "C:\Users\User1\Documents",
  "C:\Users\User1\Downloads"
]
```
```

--------------------------------

### Show-MessageBox

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Displays a customizable Windows message box with various icon types and button configurations, returning the user's selection.

```APIDOC
## Show-MessageBox

### Description
Displays a customizable Windows message box with various icon types and button configurations, returning the user's selection.

### Method
`Show-MessageBox`

### Parameters
#### Path Parameters
None

#### Query Parameters
- **Message** (string) - Required - The message to display in the message box.
- **Title** (string) - Optional - The title of the message box window. Defaults to "Message".
- **Type** (string) - Optional - The icon type to display. Valid options: "None", "Error", "Question", "Warning", "Information". Defaults to "None".
- **Buttons** (string) - Optional - The button configuration. Valid options: "OK", "OKCancel", "YesNo", "YesNoCancel", "AbortRetryIgnore", "RetryCancel". Defaults to "OK".

### Request Example
```powershell
Import-Module -Name XAMLgui

# Simple message box
Show-MessageBox "Operation completed successfully!"

# Message box with custom title and icon type
Show-MessageBox -Message "File not found!" -Title "Error" -Type "Error" -Buttons "OK"

# Confirmation dialog with Yes/No buttons
$result = Show-MessageBox -Message "Do you want to save changes?" `
                          -Title "Confirm Save" `
                          -Type "Question" `
                          -Buttons "YesNoCancel"

switch ($result) {
    "Yes"    { Write-Host "Saving..." }
    "No"     { Write-Host "Discarding changes..." }
    "Cancel" { Write-Host "Operation cancelled" }
}
```

### Response
#### Success Response (200)
- **Result** (string) - The button clicked by the user. Possible values depend on the `Buttons` parameter (e.g., "OK", "Yes", "No", "Cancel").

#### Response Example
```powershell
# If user clicks 'Yes' on a YesNoCancel dialog:
"Yes"
```
```

--------------------------------

### Define UI Event Handlers

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Functions defined with the naming convention MyApp.MainWindow.[ControlName]_Click are automatically bound to UI elements.

```PowerShell
function MyApp.MainWindow.btnBrowse_Click($Sender, $EventArgs) {
    $folder = Select-FolderDialog -Title "Select Working Directory"
    if ($folder) {
        $Elements.txtPath.Text = $folder
    }
}

function MyApp.MainWindow.btnProcess_Click($Sender, $EventArgs) {
    $path = $Elements.txtPath.Text
    if (-not $path) {
        Show-MessageBox -Message "Please select a folder first" -Type "Warning"
        return
    }

    $Elements.btnProcess.IsEnabled = $false
    $Elements.progressBar.IsIndeterminate = $true

    $job = Start-AwaitJob -ScriptBlock {
        param($folder)
        Get-ChildItem $folder -Recurse | Measure-Object
    } -ArgumentList @($path) -Await $False

    $result = Wait-AwaitJob $job

    $Elements.progressBar.IsIndeterminate = $false
    $Elements.btnProcess.IsEnabled = $true

    Invoke-BalloonTip -Message "Found $($result.Count) items" -Title "Processing Complete"
}
```

--------------------------------

### Define global event handlers

Source: https://github.com/bananaacid/xamlgui/blob/main/docs/README.md

Use the global: prefix to make event handlers accessible globally.

```powershell
Function global:Updater.MainWindow.DoActions_Click {
    Show-MessageBox "3"
}

$Elements,$MainWindow = New-Window $XamlFile -Debug
```

--------------------------------

### Manage Local PowerShell Modules

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Handles module imports and paths for portable applications without internet access.

```powershell
Import-Module -Name XAMLgui

# Set a custom base path for local modules
Set-LocalModulePathBase ".\lib\ps-modules"

# Import a module (downloads if not present)
Import-LocalModule -Name "PSWriteHTML" -Download $True

# Get module path without importing (downloads if needed)
$modulePath = Get-LocalModule -Name "ImportExcel"
Write-Host "Module located at: $modulePath"

# Find existing local module path (no download)
$existingPath = Find-LocalModulePath -Name "Pester"
if ($existingPath) {
    Import-Module $existingPath
}

# Use custom path for specific module
Import-LocalModule -Name "ThreadJob" -Path "D:\PortableModules" -Download $True
```

--------------------------------

### Import-LocalModule and Get-LocalModule

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Manages local PowerShell modules for portable applications that may not have internet access.

```APIDOC
## Import-LocalModule and Get-LocalModule

### Description
Manages local PowerShell modules for portable applications that may not have internet access.

### Method
GET/POST

### Endpoint
N/A (Functions within a module)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```powershell
# Set a custom base path for local modules
Set-LocalModulePathBase ".\lib\ps-modules"

# Import a module (downloads if not present)
Import-LocalModule -Name "PSWriteHTML" -Download $True

# Get module path without importing (downloads if needed)
$modulePath = Get-LocalModule -Name "ImportExcel"
Write-Host "Module located at: $modulePath"

# Find existing local module path (no download)
$existingPath = Find-LocalModulePath -Name "Pester"
if ($existingPath) {
    Import-Module $existingPath
}

# Use custom path for specific module
Import-LocalModule -Name "ThreadJob" -Path "D:\PortableModules" -Download $True
```

### Response
#### Success Response (200)
- **ModulePath** (string) - The file path to the module.

#### Response Example
```json
{
  "ModulePath": "C:\Path\To\Module"
}
```
```

--------------------------------

### UI Dialog and Notification Functions

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Functions for displaying message boxes, balloon tips, and file/folder dialogs.

```APIDOC
## Show-MessageBox

### Description
Show a message box with the specified message, title, and icon.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **Message** (string) - Optional - The message to display. Defaults to "This is a default Message.".
- **Title** (string) - Optional - The title of the message box. Defaults to "Default Title".
- **Type** (ValidateSet("Asterisk","Error","Exclamation","Hand","Information","None","Question","Stop","Warning")) - Optional - The type of icon to display. Defaults to "Error".
- **Buttons** (ValidateSet("AbortRetryIgnore","OK","OKCancel","RetryCancel","YesNo","YesNoCancel")) - Optional - The buttons to display. Defaults to "OK".

### Request Example
```powershell
Show-MessageBox -Message "Operation completed successfully." -Title "Success" -Type "Information" -Buttons "OK"
```

### Response
- **string** - The button pressed by the user.
```

```APIDOC
## Invoke-BalloonTip

### Description
Show a balloon tip with the specified message, title, icon, and duration.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **Message** (Parameter(Mandatory=$True)) - Required - The message to display.
- **Title** (string) - Optional - The title of the balloon tip. Defaults to "Attention $env:username".
- **MessageType** (System.Windows.Forms.ToolTipIcon) - Optional - The type of icon to display. Defaults to "Info".
- **SysTrayIconPath** (string) - Optional - The path to a system tray icon.
- **Duration** (int) - Optional - The duration in milliseconds the balloon tip is displayed. Defaults to 1000.

### Request Example
```powershell
Invoke-BalloonTip -Message "New update available." -Title "Update Notification" -MessageType "Warning" -Duration 5000
```

### Response
None
```

```APIDOC
## Select-FolderDialog

### Description
Show a folder dialog and return the selected folder path.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **Title** (string) - Optional - The title of the dialog window. Defaults to "Select a Folder".
- **Description** (string) - Optional - A description for the dialog.
- **Path** (string) - Optional - The initial path to display. Defaults to the Desktop folder.
- **SelectedPath** (string) - Optional - The initially selected path.
- **Multiselect** (boolean) - Optional - Whether to allow multiple folder selections. Defaults to $false.
- **ShowNewFolderButton** (boolean) - Optional - Whether to show the "New Folder" button. Defaults to $false.

### Request Example
```powershell
Select-FolderDialog -Title "Choose Output Directory" -Path "C:\Data"
```

### Response
- **string** - The path of the selected folder.
```

```APIDOC
## Select-FileDialog

### Description
Show a file dialog and return the selected file path.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **Title** (string) - Optional - The title of the dialog window. Defaults to "Select Folder".
- **Path** (string) - Optional - The initial path to display. Defaults to "Desktop".
- **Filter** (string) - Optional - The file filter. Defaults to 'Images (*.jpg, *.png) | *.jpg;*.png'.
- **Multiselect** (boolean) - Optional - Whether to allow multiple file selections. Defaults to $false.

### Request Example
```powershell
Select-FileDialog -Title "Select Image File" -Filter 'All Files (*.*) | *.*'
```

### Response
- **string** - The path of the selected file.
```

--------------------------------

### Show Messagebox Visual Styles

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Ensures that Show-Messagebox always enables visual styles for a consistent appearance. Changed in v1.1.3.

```powershell
Show-Messagebox
```

--------------------------------

### Extract and Manage Icons

Source: https://context7.com/bananaacid/xamlgui/llms.txt

Extracts icons from files and applies them to windows or notifications.

```powershell
Import-Module -Name XAMLgui

# Extract icon from executable
$icon = Get-IconFromFile -FilePath "C:\Windows\System32\notepad.exe"

# Load icon from image file (bmp, jpg, png)
$icon = Get-IconFromFile -FilePath ".\myicon.png"

# Load .ico file directly
$iconPath = Get-IconFromFile -FilePath ".\app.ico"

# Use with balloon notifications
Invoke-BalloonTip -Message "Task complete" `
                  -SysTrayIconPath "C:\MyApp\custom.png"

# Set window icon programmatically
$Elements, $Window = . New-Window ".\MainWindow.xaml"
$Window.Icon = Get-IconFromFile -FilePath ".\app.ico"
$Window | Show-Window
```

--------------------------------

### Select File Dialog Multiselect

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Ensures that Select-FileDialog correctly handles the -Multiselect parameter, returning all selected files. Changed in v1.1.0.

```powershell
Select-FileDialog -Multiselect
```

--------------------------------

### Object and Property Access Functions

Source: https://github.com/bananaacid/xamlgui/blob/main/README.md

Functions for retrieving object properties and visual children.

```APIDOC
## Get-PropOrNull

### Description
Get the value of a property on an object or return null if the property does not exist.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **parent** (object) - Required - The parent object.
- **prop** (string) - Required - The name of the property.

### Request Example
```powershell
Get-PropOrNull -parent $myObject -prop "PropertyName"
```

### Response
- **object** - The value of the property or null.
```

```APIDOC
## Get-VisualChildren

### Description
Get all visual children of a parent object.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **Parent** (object) - Required - The parent object.

### Request Example
```powershell
Get-VisualChildren -Parent $myParentObject
```

### Response
- **array** - An array of visual child objects.
```

```APIDOC
## Get-CellItemByName

### Description
Get a child item from a parent object by name.

### Method
Cmdlet

### Endpoint
N/A

### Parameters
#### Path Parameters
- **Parent** (ref) - Required - A reference to the parent object.
- **ItemNo** (int) - Required - The item number.
- **Name** (string) - Required - The name of the item.

### Request Example
```powershell
Get-CellItemByName -Parent ([ref]$myParent) -ItemNo 1 -Name "ItemName"
```

### Response
- **object** - The child item object.
```