Multilingual support improvements

## [1.5.0] - Unreleased

### Added
- Multilingual support for AsBuiltReport Core module
    - `Initialize-LocalizedData` function to handle localization for both Core and Report modules
    - `Resolve-Culture` function with comprehensive culture fallback chains for 135+ culture variants
    - Localized user prompts and messages in `New-AsBuiltConfig` function. Initial support for English, Spanish & French.
    - `ReportLanguage` parameter to `New-AsBuiltReport` function with dynamic validation based on available languages in report modules
    - Support for setting default language in report JSON configuration files using the `Report.Language` property
- Improve error handling with comprehensive try-catch blocks and meaningful error messages

### Changed
- Core module functions (`New-AsBuiltConfig`, `New-AsBuiltReport`, `New-AsBuiltReportConfig`) now default to user's OS language instead of hardcoded English
- Report modules default to 'en-US' when no language is specified
- Updated parameter validation to use ValidateScript blocks for dynamic language detection
- Enhanced error messages to include specific language and module information
- Improved progress messaging during report generation
- Updated all y/n prompts in `New-AsBuiltConfig` to show defaults and handle empty input

Author: tpcarman

.gitignore

@@ -0,0 +1 @@
+.claude/

AsBuiltReport.Core.Style.ps1

@@ -1,5 +1,17 @@
 # AsBuiltReport Default Document Style
-Initialize-SessionLocalization -ScriptRoot $PSScriptRoot -LanguageFile 'DefaultStyle'
+try {
+    # Try to initialize localized data for style elements
+    if ($PSScriptRoot) {
+        Initialize-LocalizedData -ModuleBasePath $PSScriptRoot -LanguageFile 'AsBuiltReportCoreStyle' -ModuleType 'Core'
+    } else {
+        # Fallback if $PSScriptRoot is not available
+        $StyleModulePath = Split-Path -Path $MyInvocation.MyCommand.Path -Parent
+        Initialize-LocalizedData -ModuleBasePath $StyleModulePath -LanguageFile 'AsBuiltReportCoreStyle' -ModuleType 'Core'
+    }
+} catch {
+    # If localization fails, continue with default style (don't break report generation)
+    Write-Warning "Could not load style localization: $($_.Exception.Message)"
+}
 
 # Configure document options
 DocumentOption -EnableSectionNumbering -PageSize A4 -DefaultFont 'Segoe Ui' -MarginLeftAndRight 71 -MarginTopAndBottom 71 -Orientation $Orientation

CHANGELOG.md

@@ -8,11 +8,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [1.5.0] - Unreleased
 
 ### Added
-- Add multilingual support for core module
-
-### Changed
-- UI enhancements
-- Improve error handling
+- Multilingual support for AsBuiltReport Core module
+    - `Initialize-LocalizedData` function to handle localization for both Core and Report modules
+    - `Resolve-Culture` function with comprehensive culture fallback chains for 135+ culture variants
+    - Localized user prompts and messages in `New-AsBuiltConfig` function. Initial support for English, Spanish & French.
+    - `ReportLanguage` parameter to `New-AsBuiltReport` function with dynamic validation based on available languages in report modules
+    - Support for setting default language in report JSON configuration files using the `Report.Language` property
+- Improve error handling with comprehensive try-catch blocks and meaningful error messages
+
+### Changed
+- Core module functions (`New-AsBuiltConfig`, `New-AsBuiltReport`, `New-AsBuiltReportConfig`) now default to user's OS language instead of hardcoded English
+- Report modules default to 'en-US' when no language is specified
+- Updated parameter validation to use ValidateScript blocks for dynamic language detection
+- Enhanced error messages to include specific language and module information
+- Improved progress messaging during report generation
+- Updated all y/n prompts in `New-AsBuiltConfig` to show defaults and handle empty input
 
 ## [1.4.3] - 2025-03-08
 
@@ -134,7 +144,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [1.0.0] - 2019-03-26
 ### Added
-- `AsBuiltReport.Core` module created to provide core as built report functionality
+- `AsBuiltReport.Core` module created to provide core AsBuiltReport functionality
 
 ### Changed
 - `AsBuiltReport` module simply becomes a manifest to install required core and report modules
@@ -148,7 +158,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [0.4.0] - 2019-03-16
 ### Added
-- `New-AsbuiltConfig` cmdlet to generate a base As Built Report JSON configuration file
+- `New-AsbuiltConfig` cmdlet to generate a base AsBuiltReport JSON configuration file
 - `New-AsBuiltReport` cmdlet to generate a report JSON configuration file
 - Username and Password parameters on `New-AsBuiltReport`
 - Support for setting the document orientation for the output report
@@ -169,5 +179,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - New As-Built JSON configuration structure
   - new `AsBuiltConfigPath` parameter
   - allows unique configuration files to be created and saved
-  - if `AsBuiltConfigPath` parameter is not specified, user is prompted for As Built report configuration information
+  - if `AsBuiltConfigPath` parameter is not specified, user is prompted for AsBuiltReport configuration information
   - `New-AsBuiltConfig.ps1` & `Config.json` files are no longer required

Language/en-US/DefaultStyle.psd1 …nguage/en-US/AsBuiltReportCoreStyle.psd1Language/en-US/DefaultStyle.psd1 renamed to Language/en-US/AsBuiltReportCoreStyle.psd1 Language/en-US/DefaultStyle.psd1 renamed to Language/en-US/AsBuiltReportCoreStyle.psd1

@@ -10,7 +10,7 @@ ReportInfo = ConvertFrom-StringData @'
 # Company Configuration
 CompanyConfig = ConvertFrom-StringData @'
     BannerTitle = Company Information
-    CompanyInfo = Would you like to enter company information for the As Built Report? (y/n)
+    CompanyInfo = Would you like to enter company information for the As Built Report? (y/N)
     CompanyFullName = Enter the Full Company Name
     CompanyShortName = Enter the Company Short Name
     CompanyContact = Enter the Company Contact
@@ -22,21 +22,21 @@ CompanyConfig = ConvertFrom-StringData @'
 # Email Configuration
 EmailConfig = ConvertFrom-StringData @'
     BannerTitle = Email Configuration
-    ConfigureMailSettings = Would you like to enter SMTP configuration? (y/n)
+    ConfigureMailSettings = Would you like to enter SMTP configuration? (y/N)
     MailServer = Enter the mail server FQDN / IP address
     EmptyMailServerAddress = Mail server address cannot be empty. Please enter a valid mail server FQDN / IP address.
     InvalidMailServer = '{0}' is not a valid FQDN or IP address. Please enter a valid mail server FQDN / IP address.
     MailServerPort587 = Enter the mail server port number [587]
     InvalidMailServerPort587 = Invalid port number. Please enter a number between 1 and 65535, or press Enter for default [587].
     MailServerPort25 = Enter the mail server port number [25]
     InvalidMailServerPort25 = Invalid port number. Please enter a number between 1 and 65535, or press Enter for default [25].
-    MailServerUseSSL = Use SSL for mail server connection? (y/n)
-    MailCredentials = Require mail server authentication? (y/n)
+    MailServerUseSSL = Use SSL for mail server connection? (y/N)
+    MailCredentials = Require mail server authentication? (y/N)
     MailFrom = Enter the mail sender email address
     MailTo = Enter the mail server recipient email address
     EmptyEmail = Email address cannot be empty. Please enter a valid email address.
     InvalidEmail = '{0}' is not a valid email address. Please enter a valid email address.
-    AnotherRecipient = Do you want to enter another recipient? (y/n)
+    AnotherRecipient = Do you want to enter another recipient? (y/N)
     MailBodyPrompt = Enter the email message body content
     MailBody = As Built Report attached
 '@
@@ -45,10 +45,10 @@ EmailConfig = ConvertFrom-StringData @'
 ReportConfig = ConvertFrom-StringData @'
     BannerTitle = As Built Report Configuration
     ReportConfigFolder = Enter the full path of the folder to use for storing report configuration files and custom style scripts [{0}]
-    OverwriteReportConfig = A report configuration file already exists in the specified folder for {0}. Would you like to overwrite it? (y/n)
+    OverwriteReportConfig = A report configuration file for {0} already exists in the specified folder. Would you like to overwrite it? (y/N)
     CopyFile = Copying '{0}' to '{1}'.
     OverwriteFile = Copying '{0}' to '{1}'. Overwriting existing file.
-    SaveAsBuiltConfig = Would you like to save the As Built Report configuration file? (y/n)
+    SaveAsBuiltConfig = Would you like to save the As Built Report configuration file? (Y/n)
     AsBuiltName = Enter a name for the As Built Report configuration file [AsBuiltReport]
     AsBuiltExportPath = Enter the path to save the As Built Report configuration file [{0}]
     ConfigFolder = Creating As Built Report configuration folder '{0}'.

Language/en-US/New-AsBuiltConfig.psd1

@@ -7,5 +7,5 @@ ConvertFrom-StringData @'
     Author = Autor:
     Date = Fecha:
     Version = Versión:
-    TOC = Tabla de contenido
+    TOC = Tabla de Contenido
 '@

Language/es-ES/DefaultStyle.psd1 …nguage/es-ES/AsBuiltReportCoreStyle.psd1Language/es-ES/DefaultStyle.psd1 renamed to Language/es-ES/AsBuiltReportCoreStyle.psd1 Language/es-ES/DefaultStyle.psd1 renamed to Language/es-ES/AsBuiltReportCoreStyle.psd1

@@ -10,7 +10,7 @@ ReportInfo = ConvertFrom-StringData @'
 # Configuración de la Empresa
 CompanyConfig = ConvertFrom-StringData @'
     BannerTitle = Información de la Empresa
-    CompanyInfo = ¿Desea ingresar información de la empresa para el Informe Según Construcción? (y/n)
+    CompanyInfo = ¿Desea ingresar información de la empresa para el Informe Según Construcción? (y/N)
     CompanyFullName = Ingrese el Nombre Completo de la Empresa
     CompanyShortName = Ingrese el Nombre Corto de la Empresa
     CompanyContact = Ingrese el Contacto de la Empresa
@@ -22,21 +22,21 @@ CompanyConfig = ConvertFrom-StringData @'
 # Configuración de Correo Electrónico
 EmailConfig = ConvertFrom-StringData @'
     BannerTitle = Configuración de Correo Electrónico
-    ConfigureMailSettings = ¿Le gustaría ingresar la configuración SMTP? (y/n)
+    ConfigureMailSettings = ¿Le gustaría ingresar la configuración SMTP? (y/N)
     MailServer = Ingrese el FQDN / dirección IP del servidor de correo
     EmptyMailServerAddress = La dirección del servidor de correo no puede estar vacía. Por favor ingrese un FQDN / dirección IP válida del servidor de correo.
     InvalidMailServer = '{0}' no es un FQDN o dirección IP válida. Por favor ingrese un FQDN / dirección IP válida del servidor de correo.
     MailServerPort587 = Ingrese el número de puerto del servidor de correo [587]
     InvalidMailServerPort587 = Número de puerto inválido. Por favor ingrese un número entre 1 y 65535, o presione Enter para el valor predeterminado [587].
     MailServerPort25 = Ingrese el número de puerto del servidor de correo [25]
     InvalidMailServerPort25 = Número de puerto inválido. Por favor ingrese un número entre 1 y 65535, o presione Enter para el valor predeterminado [25].
-    MailServerUseSSL = ¿Se requiere autenticación del servidor de correo? (y/n)
-    MailCredentials = ¿Requiere autenticación del servidor de correo? (y/n)
+    MailServerUseSSL = ¿Se requiere autenticación del servidor de correo? (y/N)
+    MailCredentials = ¿Requiere autenticación del servidor de correo? (y/N)
     MailFrom = Ingrese la dirección de correo electrónico del remitente
     MailTo = Introduzca la dirección de correo electrónico del destinatario del servidor de correo
     EmptyEmail = La dirección de correo electrónico no puede estar vacía. Por favor ingrese una dirección de correo electrónico válida.
     InvalidEmail = '{0}' no es una dirección de correo electrónico válida. Por favor ingrese una dirección de correo electrónico válida.
-    AnotherRecipient = ¿Quieres introducir otro destinatario? (y/n)
+    AnotherRecipient = ¿Quieres introducir otro destinatario? (y/N)
     MailBodyPrompt = Ingrese el contenido del cuerpo del mensaje de correo electrónico
     MailBody = Informe As Built adjunto
 '@
@@ -45,10 +45,10 @@ EmailConfig = ConvertFrom-StringData @'
 ReportConfig = ConvertFrom-StringData @'
     BannerTitle = Configuración del Informe Según Construcción
     ReportConfigFolder = Ingrese la ruta completa de la carpeta a usar para almacenar archivos de configuración del informe y scripts de estilo personalizados [{0}]
-    OverwriteReportConfig = Ya existe un archivo de configuración del informe en la carpeta especificada para {0}. ¿Le gustaría sobrescribirlo? (y/n)
+    OverwriteReportConfig = Ya existe un archivo de configuración  para {0} del informe en la carpeta especificada. ¿Le gustaría sobrescribirlo? (y/N)
     CopyFile = Copiando '{0}' a '{1}'.
     OverwriteFile = Copiando '{0}' a '{1}'. Sobrescribiendo archivo existente.
-    SaveAsBuiltConfig = ¿Le gustaría guardar el archivo de configuración del Informe As Built? (y/n)
+    SaveAsBuiltConfig = ¿Le gustaría guardar el archivo de configuración del Informe As Built? (Y/n)
     AsBuiltName = Ingrese un nombre para el archivo de configuración del Informe As Built [AsBuiltReport]
     AsBuiltExportPath = Ingrese la ruta para guardar el archivo de configuración del Informe As Built [{0}]
     ConfigFolder = Creando carpeta de configuración del Informe As Built '{0}'.

Language/es-ES/New-AsBuiltConfig.psd1

@@ -10,7 +10,7 @@ ReportInfo = ConvertFrom-StringData @'
 # Configuration de l'entreprise
 CompanyConfig = ConvertFrom-StringData @'
     BannerTitle = Information de l'entreprise
-    CompanyInfo = Souhaitez-vous saisir les informations de l'entreprise pour le rapport As Built ? (y/n)
+    CompanyInfo = Souhaitez-vous saisir les informations de l'entreprise pour le rapport As Built ? (y/N)
     CompanyFullName = Entrez le nom complet de l'entreprise
     CompanyShortName = Entrez le nom abrégé de l'entreprise
     CompanyContact = Entrez le contact de l'entreprise
@@ -22,21 +22,21 @@ CompanyConfig = ConvertFrom-StringData @'
 # Configuration de la messagerie électronique
 EmailConfig = ConvertFrom-StringData @'
     BannerTitle = Configuration de la messagerie électronique
-    ConfigureMailSettings = Souhaitez-vous configurer le SMTP ? (y/n)
+    ConfigureMailSettings = Souhaitez-vous configurer le SMTP ? (y/N)
     MailServer = Entrez le FQDN / l'adresse IP du serveur de messagerie
     EmptyMailServerAddress = L'adresse du serveur de messagerie ne peut pas être vide. Veuillez saisir un nom de domaine complet (FQDN) ou une adresse IP valide.
     InvalidMailServer = {0} n'est pas un nom de domaine complet (FQDN) ni une adresse IP valide. Veuillez saisir un nom de domaine complet (FQDN) ou une adresse IP de serveur de messagerie valide.
     MailServerPort587 = Entrez le numéro de port du serveur de messagerie [587]
     InvalidMailServerPort587 = Numéro de port non valide. Veuillez saisir un numéro compris entre 1 et 65535, ou appuyez sur Entrée pour la valeur par défaut. [587].
     MailServerPort25 = Entrez le numéro de port du serveur de messagerie [25]
     InvalidMailServerPort25 = Numéro de port non valide. Veuillez saisir un numéro compris entre 1 et 65535, ou appuyez sur Entrée pour la valeur par défaut. [25].
-    MailServerUseSSL = Utiliser SSL pour la connexion au serveur de messagerie? (y/n)
-    MailCredentials = Exiger une authentification du serveur de messagerie? (y/n)
+    MailServerUseSSL = Utiliser SSL pour la connexion au serveur de messagerie? (y/N)
+    MailCredentials = Exiger une authentification du serveur de messagerie? (y/N)
     MailFrom = Saisissez l'adresse e-mail de l'expéditeur du courrier
     MailTo = Saisissez l'adresse e-mail du destinataire du serveur de messagerie
     EmptyEmail = L'adresse e-mail ne peut pas être vide. Veuillez saisir une adresse e-mail valide.
     InvalidEmail = '{0}' n'est pas une adresse e-mail valide. Veuillez saisir une adresse e-mail valide.
-    AnotherRecipient = Voulez-vous saisir un autre destinataire? (y/n)
+    AnotherRecipient = Voulez-vous saisir un autre destinataire? (y/N)
     MailBodyPrompt = Saisissez le contenu du corps du message électronique
     MailBody = Rapport de construction ci-joint
 '@
@@ -45,10 +45,10 @@ EmailConfig = ConvertFrom-StringData @'
 ReportConfig = ConvertFrom-StringData @'
     BannerTitle = Configuration du rapport tel que construit
     ReportConfigFolder = Saisissez le chemin complet du dossier à utiliser pour stocker les fichiers de configuration de rapport et les scripts de style personnalisés [{0}]
-    OverwriteReportConfig = Un fichier de configuration de rapport existe déjà dans le dossier spécifié pour {0}. Souhaitez-vous le remplacer? (y/n)
+    OverwriteReportConfig = Un fichier de configuration de rapport pour {0} existe déjà dans le dossier spécifié. Souhaitez-vous le remplacer? (y/N)
     CopyFile = Copie de '{0}' vers '{1}'.
     OverwriteFile = Copie de {0} vers {1}. Écrasement du fichier existant.
-    SaveAsBuiltConfig = Souhaitez-vous enregistrer le fichier de configuration du rapport As Built ? (y/n)
+    SaveAsBuiltConfig = Souhaitez-vous enregistrer le fichier de configuration du rapport As Built ? (Y/n)
     AsBuiltName = Entrez un nom pour le fichier de configuration du rapport As Built [AsBuiltReport]
     AsBuiltExportPath = Entrez le chemin pour enregistrer le fichier de configuration du rapport As Built [{0}]
     ConfigFolder = Création d'un dossier de configuration de rapport tel que construit '{0}'.