UserAdminModule.psm1

#requires -Version 5.1
<#
    UserAdminModule.psm1 — Root module entry point
    ================================================
    Structure:
        Private/   — internal helpers (Get-UserAdminModuleConfig)
        Public/    — exported base framework functions (5 functions)
        Shell/     — bundled UX submodule, loaded with -Global
        profiles/  — profile scripts for users to dot-source
        resources/ — config data and templates

    Exported functions:
        Import-PersonalModules          — dynamic category importer (tab-completion)
        Invoke-PersonalModulesMenu      — interactive PSMenu multi-select
        New-PSM1Module                  — submodule folder scaffolder
        Invoke-FunctionIndexRegeneration — rebuilds FunctionIndex.json/.md
        Initialize-UserAdminModule      — first-run setup / config writer

    Private helper (module-scoped, NOT exported):
        Get-UserAdminModuleConfig       — reads $env:APPDATA\UserAdminModule\config.json

    Shell submodule is loaded with -Global so its exported functions (Set-PromptisAdmin,
    Show-IsAdminOrNot, Set-ConsoleConfig, etc.) are available directly in the user's
    session after Import-Module UserAdminModule.

    NOTE: Public functions that discover submodules reference $script:UAMModuleRoot
    (set below) instead of $PSScriptRoot, because after moving to Public/ the file's
    $PSScriptRoot would point to the Public/ subdirectory, not the module root.
#>

# ── Module root — set FIRST; used by Public functions for submodule discovery ─
$script:UAMModuleRoot = $PSScriptRoot

# ── Private helpers (must load before Public functions are parsed) ─────────────
$_privateScripts = @( Get-ChildItem -Path "$PSScriptRoot\Private\*.ps1" -ErrorAction SilentlyContinue )
foreach ($_script in $_privateScripts) {
    . $_script.FullName
}
Remove-Variable _privateScripts, _script -ErrorAction SilentlyContinue

# ── Public base framework functions ───────────────────────────────────────────
$_publicScripts = @( Get-ChildItem -Path "$PSScriptRoot\Public\*.ps1" -ErrorAction SilentlyContinue )
foreach ($_script in $_publicScripts) {
    . $_script.FullName
}
Remove-Variable _publicScripts, _script -ErrorAction SilentlyContinue

# ── Shell submodule (bundled UX layer) ────────────────────────────────────────
# Loaded with -Global so its functions reach the user's session directly.
$_shellModule = Join-Path $PSScriptRoot 'Shell\Shell.psm1'
if (Test-Path $_shellModule) {
    Import-Module $_shellModule -Force -DisableNameChecking -Global -ErrorAction SilentlyContinue
}
else {
    Write-Warning 'UserAdminModule: Shell submodule not found. Prompt helpers will be unavailable.'
}
Remove-Variable _shellModule -ErrorAction SilentlyContinue

# ── Exports ───────────────────────────────────────────────────────────────────
# Get-UserAdminModuleConfig is intentionally NOT exported — private module helper only.
Export-ModuleMember -Function @(
    'Import-PersonalModules'
    'Invoke-PersonalModulesMenu'
    'New-PSM1Module'
    'Invoke-FunctionIndexRegeneration'
    'Initialize-UserAdminModule'
)