ShellArranger.psm1

#Requires -Version 5.1
<#
.SYNOPSIS
    ShellArranger — Organiza ventanas de terminal en una cuadrícula.
.DESCRIPTION
    MVP sin dependencias externas. Usa Win32 API via Add-Type.
    Detecta: WindowsTerminal, pwsh, powershell, cmd.
    Ignora: VSCode, Chrome, Firefox, Edge, Visual Studio.
.EXAMPLE
    Import-Module .\ShellArranger.psm1
    Layout-Terminals                      # cuadrícula automática
    Layout-Terminals -Rows 2 -Columns 3   # grid fijo
    Layout-Terminals -Gap 8               # más separación
    Get-TerminalWindows                    # solo listar sin mover
    Layout-Terminals -WhatIf              # simular sin aplicar


By: anarcoiris
Visit github.com/anarcoiris/


#>

# ─── Win32 types (carga una sola vez) ─────────────────────────────────────────
if (-not ('TG' -as [type])) {
    Add-Type -TypeDefinition @'
using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using System.Text;

[StructLayout(LayoutKind.Sequential)]
public struct RECT {
    public int Left, Top, Right, Bottom;
    public int Width  { get { return Right - Left; } }
    public int Height { get { return Bottom - Top; } }
}

[StructLayout(LayoutKind.Sequential)]
public struct MONITORINFO {
    public int  cbSize;
    public RECT rcMonitor;
    public RECT rcWork;
    public uint dwFlags;
}

public static class TG {
    private delegate bool EnumWindowsProc(IntPtr hWnd, IntPtr lParam);

    [DllImport("user32.dll")]
    private static extern bool EnumWindows(EnumWindowsProc cb, IntPtr lParam);

    [DllImport("user32.dll")]
    public static extern bool IsWindowVisible(IntPtr hWnd);

    [DllImport("user32.dll", CharSet = CharSet.Unicode)]
    private static extern int GetWindowText(IntPtr hWnd, StringBuilder sb, int max);

    [DllImport("user32.dll")]
    public static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint pid);

    [DllImport("user32.dll")]
    public static extern bool SetWindowPos(
        IntPtr hWnd, IntPtr hWndAfter,
        int x, int y, int cx, int cy, uint flags);

    [DllImport("user32.dll")]
    public static extern bool ShowWindow(IntPtr hWnd, int cmd);

    [DllImport("user32.dll")]
    private static extern IntPtr MonitorFromWindow(IntPtr hWnd, uint flags);

    [DllImport("user32.dll")]
    private static extern bool GetMonitorInfo(IntPtr hMon, ref MONITORINFO info);

    // ── Helpers ───────────────────────────────────────────────────────────────

    public static List<IntPtr> GetVisibleWindows() {
        var list = new List<IntPtr>();
        EnumWindows((h, _) => {
            if (IsWindowVisible(h)) list.Add(h);
            return true;
        }, IntPtr.Zero);
        return list;
    }

    public static string GetTitle(IntPtr hWnd) {
        var sb = new StringBuilder(512);
        GetWindowText(hWnd, sb, 512);
        return sb.ToString();
    }

    public static uint GetPid(IntPtr hWnd) {
        uint pid;
        GetWindowThreadProcessId(hWnd, out pid);
        return pid;
    }

    public static RECT GetWorkArea(IntPtr hWnd) {
        IntPtr hMon = MonitorFromWindow(hWnd, 0x2); // MONITOR_DEFAULTTONEAREST
        MONITORINFO mi = new MONITORINFO();
        mi.cbSize = Marshal.SizeOf(typeof(MONITORINFO));
        GetMonitorInfo(hMon, ref mi);
        return mi.rcWork;
    }

    public const uint SWP_NOZORDER   = 0x0004;
    public const uint SWP_SHOWWINDOW = 0x0040;
    public const int  SW_RESTORE     = 9;
}
'@ -ErrorAction Stop
}

# ─── Filtros ──────────────────────────────────────────────────────────────────
$Script:TargetProcs  = @('WindowsTerminal', 'powershell', 'pwsh', 'cmd')
$Script:ExcludeTitle = 'Code\s*-|Visual\s*Studio|chrome|firefox|msedge|node'

# ─── Get-TerminalWindows ──────────────────────────────────────────────────────
function Get-TerminalWindows {
<#
.SYNOPSIS Devuelve las ventanas de terminal detectadas (sin moverlas).
.EXAMPLE  Get-TerminalWindows | Format-Table Title, Process, PID
#>
    [CmdletBinding()]
    param()

    $found = [System.Collections.Generic.List[PSCustomObject]]::new()

    foreach ($hWnd in [TG]::GetVisibleWindows()) {
        $title = [TG]::GetTitle($hWnd)
        if (-not $title)                         { continue }
        if ($title -match $Script:ExcludeTitle)  { continue }

        $pid  = [TG]::GetPid($hWnd)
        $proc = Get-Process -Id $pid -ErrorAction SilentlyContinue
        if ($proc -and $Script:TargetProcs -contains $proc.ProcessName) {
            $found.Add([PSCustomObject]@{
                hWnd    = $hWnd
                Title   = $title
                Process = $proc.ProcessName
                PID     = $pid
            })
        }
    }

    if ($found.Count -eq 0) {
        Write-Warning 'No se encontraron ventanas de terminal.'
    }

    return $found
}

# ─── Arrange-Terminals ────────────────────────────────────────────────────────
function Layout-Terminals {
<#
.SYNOPSIS  Distribuye las ventanas de terminal en una cuadrícula.
.PARAMETER Rows    Número de filas   (0 = automático)
.PARAMETER Columns Número de columnas (0 = automático)
.PARAMETER Gap     Separación en píxeles entre celdas (default 4)
.EXAMPLE
    ShellArranger-Terminals                    # cuadrícula automática
    ShellArranger-Terminals -Rows 2 -Columns 3
    ShellArranger-Terminals -WhatIf            # simulación sin mover nada
#>
    [CmdletBinding(SupportsShouldProcess)]
    param(
        [int]$Rows    = 0,
        [int]$Columns = 0,
        [int]$Gap     = 4
    )

    $wins = Get-TerminalWindows
    $n    = $wins.Count
    if ($n -eq 0) { return }

    # ── Calcular grid ──────────────────────────────────────────────────────
    if ($Columns -eq 0 -and $Rows -eq 0) {
        $Columns = [int][Math]::Ceiling([Math]::Sqrt($n))
        $Rows    = [int][Math]::Ceiling($n / $Columns)
    } elseif ($Columns -eq 0) {
        $Columns = [int][Math]::Ceiling($n / $Rows)
    } elseif ($Rows -eq 0) {
        $Rows    = [int][Math]::Ceiling($n / $Columns)
    }

    # ── Área de trabajo (respeta barra de tareas) ──────────────────────────
    $area  = [TG]::GetWorkArea($wins[0].hWnd)
    $cellW = [int](($area.Width  - $Gap * ($Columns + 1)) / $Columns)
    $cellH = [int](($area.Height - $Gap * ($Rows    + 1)) / $Rows)

    Write-Host ("ShellArranger: {0} ventana(s) → grid {1}×{2}  celda {3}×{4}px  gap {5}px" `
        -f $n, $Rows, $Columns, $cellW, $cellH, $Gap)

    # ── Colocar ventanas ───────────────────────────────────────────────────
    for ($i = 0; $i -lt $n; $i++) {
        $col = $i % $Columns
        $row = [int]($i / $Columns)
        $x   = $area.Left + $Gap + $col * ($cellW + $Gap)
        $y   = $area.Top  + $Gap + $row * ($cellH + $Gap)

        $label = "R$($row+1)C$($col+1) @ ($x,$y) ${cellW}×${cellH}"

        if ($PSCmdlet.ShouldProcess($wins[$i].Title, "Mover → $label")) {
            [TG]::ShowWindow($wins[$i].hWnd, [TG]::SW_RESTORE) | Out-Null
            [TG]::SetWindowPos(
                $wins[$i].hWnd,
                [IntPtr]::Zero,
                $x, $y, $cellW, $cellH,
                ([TG]::SWP_NOZORDER -bor [TG]::SWP_SHOWWINDOW)
            ) | Out-Null
        }

        Write-Host ("  [{0}/{1}] {2,-40} → {3}" -f ($i+1), $n, $wins[$i].Title, $label)
    }

    Write-Host 'Listo.'
}

Export-ModuleMember -Function Layout-Terminals, Get-TerminalWindows

# SIG # Begin signature block
# MIIFjAYJKoZIhvcNAQcCoIIFfTCCBXkCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCChtoT6sBW53UAs
# kLNS6dW10IGKcGDIELIb2t22ALU0AKCCAwQwggMAMIIB6KADAgECAhAaBw9fB+HP
# oUTNV/wIdl18MA0GCSqGSIb3DQEBCwUAMBgxFjAUBgNVBAMMDVNoZWxsQXJyYW5n
# ZXIwHhcNMjYwNjI5MTcyMzE2WhcNMjcwNjI5MTc0MzE2WjAYMRYwFAYDVQQDDA1T
# aGVsbEFycmFuZ2VyMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArstc
# kL5k3eZI3gEXV/+rew4Oxpf0ejfk3FfDNmQXQ4F/AAFYq5IFLtqQcG7rMKFggDHA
# TmRuP5s1ZH1JAVCWTeQ8vKbPmDwDh46HDnV3gVwFtSpnRJavWTfhsoydxqu91u4n
# url2y0CDgmlPgflG+3sl3ecbJzOh0/dOd3ISTUhjJEnrfpWs1qOaM6WFiBSFjVfs
# RJkzZ7S7mjdu4aITMHi476JdkSloAMoy9aJA72/AZm404CGSrsfiCwro+mfIVXue
# y46VGy1eDuxE+g2q/bRIOn9Vq//kFgSaEEiFTdvjuTmAAulRpZDm4mti3cqWtCZs
# DVdfrvxWZRozJiv46QIDAQABo0YwRDAOBgNVHQ8BAf8EBAMCB4AwEwYDVR0lBAww
# CgYIKwYBBQUHAwMwHQYDVR0OBBYEFE8jpUrzLkfZcmZnupVpuDHD8ZFVMA0GCSqG
# SIb3DQEBCwUAA4IBAQB7bh++JP51yr2awHvpQfXtHDCR6/OsUmiT+vu8v7Htynwt
# /LaaZlnGgXh5FJr1RrCreK+rDLn5Zptb2HLfpWcsthkbTHITOmywBDd/KY+2+Wj7
# 5IUtmCd3v+wC+7LfiwyYoUfv3Ag6s3MNU0w6NDNJzH1+hUAhJmUohhD9kTLNH5CS
# lbErHLVAch7A55xWaG5iYjrENld04sE5FoHfVTGpp4KChRLilK02r2UqP6WO3rjm
# XLyO120OsbX9k3tWfcuTh+QI2vC2BVQcS0/hcNobn8wjLDCwrUvCyuOyPVvlKZqo
# B8dmCOVXdIdXbpb/+xrR69crXPwUfTZZSsp1uFnaMYIB3jCCAdoCAQEwLDAYMRYw
# FAYDVQQDDA1TaGVsbEFycmFuZ2VyAhAaBw9fB+HPoUTNV/wIdl18MA0GCWCGSAFl
# AwQCAQUAoIGEMBgGCisGAQQBgjcCAQwxCjAIoAKAAKECgAAwGQYJKoZIhvcNAQkD
# MQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJ
# KoZIhvcNAQkEMSIEIHkMmmGkR6Sut7UU9Zhj9ux6OiHlz7iyAng9OmPZdOZVMA0G
# CSqGSIb3DQEBAQUABIIBAH5snq/LZUoXQgBANFwlQG8MGwNpUyZW0tMMEI6/l5XE
# FCAcJtvzVc0DWfSzemkO077xDoHAScM6uR02nmLLkWZ/gECaI4nRS638mCmjL2vD
# /LDl1RMvRN5KGCY2bolh0gD2L5MWgta/UWw89ul3U0tN/qjHfTRfumWvoKHKYiTu
# Yo00xSbi9reFuEwmtw9gGrlSbcuYUI8I9fkZUFXdAb3KczaMcZakUy+jTC6OrerS
# uhSjZ4Bq1O6ZHYaSfy9UN8whTyiE/NxtHCRjTS1n1Sa+2glVMrT5BliIaO7I+uQl
# k/blP5sLJFlr17Mc83Tgfpu3IMDbXC8883GY9GxoFZc=
# SIG # End signature block