$Whitespace\}${endComment}\s{0,}${IgnoredContext})"
+
+ # Cuda's compiler is "nvcc" (if found)
+ $Compiler = 'nvcc'
+ $LanguageName = 'Cuda'
+ Export-ModuleMember -Variable * -Function * -Alias *
+} -AsCustomObject
+$languageDefinition.pstypenames.clear()
+$languageDefinition.pstypenames.add("Language")
+$languageDefinition.pstypenames.add("Language.Cuda")
+$this.psobject.properties.add([PSNoteProperty]::new('Self',$languageDefinition))
+}
+$this.Self
+}
+
diff --git a/Languages/Conf/Conf-Language.ps.ps1 b/Languages/Conf/Conf-Language.ps.ps1
index e0b020ed9..859e996ff 100644
--- a/Languages/Conf/Conf-Language.ps.ps1
+++ b/Languages/Conf/Conf-Language.ps.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>Conf|Language)\s")]
+param()
+
Language function Conf {
<#
.SYNOPSIS
diff --git a/Languages/Conf/Conf-Language.ps1 b/Languages/Conf/Conf-Language.ps1
index 4aee9ec60..8199a8f01 100644
--- a/Languages/Conf/Conf-Language.ps1
+++ b/Languages/Conf/Conf-Language.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>Conf|Language)\s")]
+param()
+
function Language.Conf {
<#
diff --git a/Languages/Crystal/Crystal-Language.ps.ps1 b/Languages/Crystal/Crystal-Language.ps.ps1
index 8c59e023e..b4da4e6c1 100644
--- a/Languages/Crystal/Crystal-Language.ps.ps1
+++ b/Languages/Crystal/Crystal-Language.ps.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>Crystal|Language)\s")]
+param()
+
Language function Crystal {
<#
.SYNOPSIS
diff --git a/Languages/Crystal/Crystal-Language.ps1 b/Languages/Crystal/Crystal-Language.ps1
index bc1e9600b..b71c678bf 100644
--- a/Languages/Crystal/Crystal-Language.ps1
+++ b/Languages/Crystal/Crystal-Language.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>Crystal|Language)\s")]
+param()
+
function Language.Crystal {
<#
diff --git a/Languages/Crystal/Crystal-Template-HelloWorld.ps.ps1 b/Languages/Crystal/Templates/Crystal-Template-HelloWorld.ps.ps1
similarity index 89%
rename from Languages/Crystal/Crystal-Template-HelloWorld.ps.ps1
rename to Languages/Crystal/Templates/Crystal-Template-HelloWorld.ps.ps1
index f642bdd54..fbc49e773 100644
--- a/Languages/Crystal/Crystal-Template-HelloWorld.ps.ps1
+++ b/Languages/Crystal/Templates/Crystal-Template-HelloWorld.ps.ps1
@@ -1,3 +1,5 @@
+[ValidatePattern("Crystal")]
+param()
Template function HelloWorld.cr {
<#
.SYNOPSIS
diff --git a/Languages/Crystal/Crystal-Template-HelloWorld.ps1 b/Languages/Crystal/Templates/Crystal-Template-HelloWorld.ps1
similarity index 100%
rename from Languages/Crystal/Crystal-Template-HelloWorld.ps1
rename to Languages/Crystal/Templates/Crystal-Template-HelloWorld.ps1
diff --git a/Languages/Dart/Dart-Language.ps.ps1 b/Languages/Dart/Dart-Language.ps.ps1
index 7a7b1a5de..b1c66dbe6 100644
--- a/Languages/Dart/Dart-Language.ps.ps1
+++ b/Languages/Dart/Dart-Language.ps.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>Dart|Language)\s")]
+param()
+
Language function Dart {
<#
.SYNOPSIS
diff --git a/Languages/Dart/Dart-Language.ps1 b/Languages/Dart/Dart-Language.ps1
index 9502cf981..975cffb7f 100644
--- a/Languages/Dart/Dart-Language.ps1
+++ b/Languages/Dart/Dart-Language.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>Dart|Language)\s")]
+param()
+
function Language.Dart {
<#
diff --git a/Languages/Dart/Templates/Dart-Template-HelloWorld.ps.ps1 b/Languages/Dart/Templates/Dart-Template-HelloWorld.ps.ps1
new file mode 100644
index 000000000..53b986436
--- /dev/null
+++ b/Languages/Dart/Templates/Dart-Template-HelloWorld.ps.ps1
@@ -0,0 +1,24 @@
+[ValidatePattern("Dart")]
+param()
+
+Template function HelloWorld.dart {
+ <#
+ .SYNOPSIS
+ Hello World in Dart
+ .DESCRIPTION
+ A Template for Hello World, in Dart.
+ #>
+ param(
+ # The message to print. By default, "hello world".
+ [vbn()]
+ [string]
+ $Message = "hello world"
+ )
+ process {
+@"
+void main() {
+ print('$Message');
+}
+"@
+ }
+}
diff --git a/Languages/Dart/Templates/Dart-Template-HelloWorld.ps1 b/Languages/Dart/Templates/Dart-Template-HelloWorld.ps1
new file mode 100644
index 000000000..817256425
--- /dev/null
+++ b/Languages/Dart/Templates/Dart-Template-HelloWorld.ps1
@@ -0,0 +1,29 @@
+[ValidatePattern("Dart")]
+param()
+
+
+function Template.HelloWorld.dart {
+
+ <#
+ .SYNOPSIS
+ Hello World in Dart
+ .DESCRIPTION
+ A Template for Hello World, in Dart.
+ #>
+ param(
+ # The message to print. By default, "hello world".
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Message = "hello world"
+ )
+ process {
+@"
+void main() {
+ print('$Message');
+}
+"@
+ }
+
+}
+
+
diff --git a/Languages/Docker/Docker-Language.ps.ps1 b/Languages/Docker/Docker-Language.ps.ps1
index 32551dc66..ee5381ab2 100644
--- a/Languages/Docker/Docker-Language.ps.ps1
+++ b/Languages/Docker/Docker-Language.ps.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>Docker|Language)\s")]
+param()
+
Language function Docker {
<#
.SYNOPSIS
diff --git a/Languages/Docker/Docker-Language.ps1 b/Languages/Docker/Docker-Language.ps1
index 192390c91..2c1834db0 100644
--- a/Languages/Docker/Docker-Language.ps1
+++ b/Languages/Docker/Docker-Language.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>Docker|Language)\s")]
+param()
+
function Language.Docker {
<#
diff --git a/Languages/Docker/Templates/Docker-Template-InstallModule.ps.ps1 b/Languages/Docker/Templates/Docker-Template-InstallModule.ps.ps1
new file mode 100644
index 000000000..6c548c204
--- /dev/null
+++ b/Languages/Docker/Templates/Docker-Template-InstallModule.ps.ps1
@@ -0,0 +1,30 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.InstallModule {
+ <#
+ .SYNOPSIS
+ Template for installing a PowerShell module in a Dockerfile.
+ .DESCRIPTION
+ A Template for installing a PowerShell module in a Dockerfile.
+ #>
+ param(
+ # The module to install.
+ [vbn()]
+ [string]
+ $ModuleName,
+
+ # The version of the module to install.
+ [vbn()]
+ [Version]
+ $ModuleVersion
+ )
+
+ process {
+ if ($ModuleVersion) {
+ "RUN pwsh -Command Install-Module -Name '$($ModuleName -replace "'","''")' -RequiredVersion '$ModuleVersion' -Force -SkipPublisherCheck -AcceptLicense"
+ } else {
+ "RUN pwsh -Command Install-Module -Name '$($ModuleName -replace "'","''")' -Force -SkipPublisherCheck -AcceptLicense"
+ }
+ }
+}
diff --git a/Languages/Docker/Templates/Docker-Template-InstallModule.ps1 b/Languages/Docker/Templates/Docker-Template-InstallModule.ps1
new file mode 100644
index 000000000..c3265dae5
--- /dev/null
+++ b/Languages/Docker/Templates/Docker-Template-InstallModule.ps1
@@ -0,0 +1,35 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.InstallModule {
+
+ <#
+ .SYNOPSIS
+ Template for installing a PowerShell module in a Dockerfile.
+ .DESCRIPTION
+ A Template for installing a PowerShell module in a Dockerfile.
+ #>
+ param(
+ # The module to install.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $ModuleName,
+
+ # The version of the module to install.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Version]
+ $ModuleVersion
+ )
+
+ process {
+ if ($ModuleVersion) {
+ "RUN pwsh -Command Install-Module -Name '$($ModuleName -replace "'","''")' -RequiredVersion '$ModuleVersion' -Force -SkipPublisherCheck -AcceptLicense"
+ } else {
+ "RUN pwsh -Command Install-Module -Name '$($ModuleName -replace "'","''")' -Force -SkipPublisherCheck -AcceptLicense"
+ }
+ }
+
+}
+
+
diff --git a/Languages/Docker/Templates/Docker-Template-InstallPackage.ps.ps1 b/Languages/Docker/Templates/Docker-Template-InstallPackage.ps.ps1
new file mode 100644
index 000000000..4e06c9e53
--- /dev/null
+++ b/Languages/Docker/Templates/Docker-Template-InstallPackage.ps.ps1
@@ -0,0 +1,21 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.InstallPackage {
+ <#
+ .SYNOPSIS
+ Template for installing a package in a Dockerfile.
+ .DESCRIPTION
+ A Template for installing a package in a Dockerfile.
+ #>
+ param(
+ # The package to install.
+ [vbn()]
+ [string[]]
+ $PackageName
+ )
+
+ process {
+ "RUN apt-get update && apt-get install -y $($PackageName -join ' ')"
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Docker-Template-InstallPackage.ps1 b/Languages/Docker/Templates/Docker-Template-InstallPackage.ps1
new file mode 100644
index 000000000..f74e81926
--- /dev/null
+++ b/Languages/Docker/Templates/Docker-Template-InstallPackage.ps1
@@ -0,0 +1,25 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.InstallPackage {
+
+ <#
+ .SYNOPSIS
+ Template for installing a package in a Dockerfile.
+ .DESCRIPTION
+ A Template for installing a package in a Dockerfile.
+ #>
+ param(
+ # The package to install.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string[]]
+ $PackageName
+ )
+
+ process {
+ "RUN apt-get update && apt-get install -y $($PackageName -join ' ')"
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Docker-Template-LabelModule.ps.ps1 b/Languages/Docker/Templates/Docker-Template-LabelModule.ps.ps1
new file mode 100644
index 000000000..cc9323aa9
--- /dev/null
+++ b/Languages/Docker/Templates/Docker-Template-LabelModule.ps.ps1
@@ -0,0 +1,49 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.LabelModule {
+ <#
+ .SYNOPSIS
+ Labels a docker image from a module.
+ .DESCRIPTION
+ Applies labels to a docker image from module metadata.
+ #>
+ [Alias('Template.Docker.ModuleLabel','Template.Docker.ModuleLabels')]
+ param(
+ # The module to label.
+ [vfp()]
+ [PSModuleInfo]
+ $Module
+ )
+
+ process {
+ $this = $theModule = $Module
+
+ if ($this.PrivateData.PSData.ProjectURI) {
+ Template.Docker.Label -Label "ProjectURI" -Value "$($this.PrivateData.PSData.ProjectURI)"
+ Template.Docker.Label -Label "org.opencontainers.image.source" -Value "$($this.PrivateData.PSData.ProjectURI)"
+ }
+
+ if ($this.PrivateData.PSData.LicenseUri) {
+ Template.Docker.Label -Label "LicenseURI" -Value "$($this.PrivateData.PSData.LicenseUri)"
+ }
+
+ Template.Docker.Label -Label "Version" -Value "$($theModule.Version)"
+ Template.Docker.Label -Label "Name" -Value "$($theModule.Name)"
+
+ if ($theModule.Description) {
+ Template.Docker.Label -Label "Description" -Value "$($theModule.Description)"
+ Template.Docker.Label -Label "org.opencontainers.image.description" -Value "$($theModule.Description)"
+ }
+
+ if ($theModule.CompanyName) {
+ Template.Docker.Label -Label "CompanyName" -Value "$($theModule.CompanyName)"
+ Template.Docker.Label -Label "org.opencontainers.image.vendor" -Value "$($theModule.CompanyName)"
+ }
+
+ if ($theModule.Author) {
+ Template.Docker.Label -Label "Author" -Value "$($theModule.Author)"
+ Template.Docker.Label -Label "org.opencontainers.image.authors" -Value "$($theModule.Author)"
+ }
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Docker-Template-LabelModule.ps1 b/Languages/Docker/Templates/Docker-Template-LabelModule.ps1
new file mode 100644
index 000000000..548ea467f
--- /dev/null
+++ b/Languages/Docker/Templates/Docker-Template-LabelModule.ps1
@@ -0,0 +1,53 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.LabelModule {
+
+ <#
+ .SYNOPSIS
+ Labels a docker image from a module.
+ .DESCRIPTION
+ Applies labels to a docker image from module metadata.
+ #>
+ [Alias('Template.Docker.ModuleLabel','Template.Docker.ModuleLabels')]
+ param(
+ # The module to label.
+ [Parameter(ValueFromPipeline)]
+ [PSModuleInfo]
+ $Module
+ )
+
+ process {
+ $this = $theModule = $Module
+
+ if ($this.PrivateData.PSData.ProjectURI) {
+ Template.Docker.Label -Label "ProjectURI" -Value "$($this.PrivateData.PSData.ProjectURI)"
+ Template.Docker.Label -Label "org.opencontainers.image.source" -Value "$($this.PrivateData.PSData.ProjectURI)"
+ }
+
+ if ($this.PrivateData.PSData.LicenseUri) {
+ Template.Docker.Label -Label "LicenseURI" -Value "$($this.PrivateData.PSData.LicenseUri)"
+ }
+
+ Template.Docker.Label -Label "Version" -Value "$($theModule.Version)"
+ Template.Docker.Label -Label "Name" -Value "$($theModule.Name)"
+
+ if ($theModule.Description) {
+ Template.Docker.Label -Label "Description" -Value "$($theModule.Description)"
+ Template.Docker.Label -Label "org.opencontainers.image.description" -Value "$($theModule.Description)"
+ }
+
+ if ($theModule.CompanyName) {
+ Template.Docker.Label -Label "CompanyName" -Value "$($theModule.CompanyName)"
+ Template.Docker.Label -Label "org.opencontainers.image.vendor" -Value "$($theModule.CompanyName)"
+ }
+
+ if ($theModule.Author) {
+ Template.Docker.Label -Label "Author" -Value "$($theModule.Author)"
+ Template.Docker.Label -Label "org.opencontainers.image.authors" -Value "$($theModule.Author)"
+ }
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Add.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Add.ps.ps1
new file mode 100644
index 000000000..07c886f0c
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Add.ps.ps1
@@ -0,0 +1,56 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.Add {
+ <#
+ .SYNOPSIS
+ Template for adding files to a Docker image.
+ .DESCRIPTION
+ A Template for adding files to a Docker image.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#add
+ #>
+ [Alias('Template.Docker.NewItem')]
+ param(
+ # The source of the file to add.
+ [vbn()]
+ [string]
+ $Source,
+
+ # The destination of the file to add.
+ [vbn()]
+ [string]
+ $Destination,
+
+ # Keep git directory
+ [vbn()]
+ [switch]
+ $KeepGit,
+
+ # Verify the checksum of the file
+ [vbn()]
+ [string]
+ $Checksum,
+
+ # Change the owner permissions
+ [Alias('Chown')]
+ [vbn()]
+ [string]
+ $ChangeOwner
+ )
+
+ process {
+ $AddOptions = @(
+ if ($KeepGit) {
+ "--keep-git-dir=true"
+ }
+ if ($Checksum) {
+ "--checksum=$Checksum"
+ }
+ if ($ChangeOwner) {
+ "--chown=$ChangeOwner"
+ }
+ ) -join ' '
+ "ADD $addOptions $Source $Destination" -replace '\s{2,}', ' '
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Add.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Add.ps1
new file mode 100644
index 000000000..d3e1d2d9e
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Add.ps1
@@ -0,0 +1,60 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.Add {
+
+ <#
+ .SYNOPSIS
+ Template for adding files to a Docker image.
+ .DESCRIPTION
+ A Template for adding files to a Docker image.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#add
+ #>
+ [Alias('Template.Docker.NewItem')]
+ param(
+ # The source of the file to add.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Source,
+
+ # The destination of the file to add.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Destination,
+
+ # Keep git directory
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $KeepGit,
+
+ # Verify the checksum of the file
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Checksum,
+
+ # Change the owner permissions
+ [Alias('Chown')]
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $ChangeOwner
+ )
+
+ process {
+ $AddOptions = @(
+ if ($KeepGit) {
+ "--keep-git-dir=true"
+ }
+ if ($Checksum) {
+ "--checksum=$Checksum"
+ }
+ if ($ChangeOwner) {
+ "--chown=$ChangeOwner"
+ }
+ ) -join ' '
+ "ADD $addOptions $Source $Destination" -replace '\s{2,}', ' '
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Argument.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Argument.ps.ps1
new file mode 100644
index 000000000..4ecbcbf5b
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Argument.ps.ps1
@@ -0,0 +1,33 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.Argument {
+ <#
+ .SYNOPSIS
+ Template for an argument in a Dockerfile.
+ .DESCRIPTION
+ A Template for an argument in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#arg
+ #>
+ [Alias('Template.Docker.Arg')]
+ param(
+ # The name of the argument.
+ [vbn()]
+ [string]
+ $Name,
+
+ # The default value of the argument.
+ [vbn()]
+ [string]
+ $DefaultValue
+ )
+
+ process {
+ if ($DefaultValue) {
+ "ARG $Name=$DefaultValue"
+ } else {
+ "ARG $Name"
+ }
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Argument.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Argument.ps1
new file mode 100644
index 000000000..430ee647d
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Argument.ps1
@@ -0,0 +1,37 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.Argument {
+
+ <#
+ .SYNOPSIS
+ Template for an argument in a Dockerfile.
+ .DESCRIPTION
+ A Template for an argument in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#arg
+ #>
+ [Alias('Template.Docker.Arg')]
+ param(
+ # The name of the argument.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Name,
+
+ # The default value of the argument.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $DefaultValue
+ )
+
+ process {
+ if ($DefaultValue) {
+ "ARG $Name=$DefaultValue"
+ } else {
+ "ARG $Name"
+ }
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Command.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Command.ps.ps1
new file mode 100644
index 000000000..4d95feb78
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Command.ps.ps1
@@ -0,0 +1,25 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.Command {
+ <#
+ .SYNOPSIS
+ Template for running a command in a Dockerfile.
+ .DESCRIPTION
+ The CMD instruction sets the command to be executed when running a container from an image.
+
+ There can only be one command. If you list more than one command, only the last one will take effect.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#cmd
+ #>
+ param(
+ # The command to run.
+ [vbn()]
+ [string]
+ $Command
+ )
+
+ process {
+ "CMD $Command"
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Command.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Command.ps1
new file mode 100644
index 000000000..f4dc26115
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Command.ps1
@@ -0,0 +1,29 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.Command {
+
+ <#
+ .SYNOPSIS
+ Template for running a command in a Dockerfile.
+ .DESCRIPTION
+ The CMD instruction sets the command to be executed when running a container from an image.
+
+ There can only be one command. If you list more than one command, only the last one will take effect.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#cmd
+ #>
+ param(
+ # The command to run.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Command
+ )
+
+ process {
+ "CMD $Command"
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-CopyItem.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-CopyItem.ps.ps1
new file mode 100644
index 000000000..f1e44d2c7
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-CopyItem.ps.ps1
@@ -0,0 +1,30 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.CopyItem {
+ <#
+ .SYNOPSIS
+ Template for copying an item in a Dockerfile.
+ .DESCRIPTION
+ A Template for copying an item in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#copy
+ #>
+ [Alias('Template.Docker.Copy')]
+ param(
+ # The source item to copy.
+ [vbn()]
+ [Alias('SourcePath','SourceItem')]
+ [string]
+ $Source,
+
+ # The destination to copy the item to.
+ [vbn()]
+ [string]
+ $Destination
+ )
+
+ process {
+ "COPY $Source $Destination"
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-CopyItem.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-CopyItem.ps1
new file mode 100644
index 000000000..dd51b7e95
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-CopyItem.ps1
@@ -0,0 +1,34 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.CopyItem {
+
+ <#
+ .SYNOPSIS
+ Template for copying an item in a Dockerfile.
+ .DESCRIPTION
+ A Template for copying an item in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#copy
+ #>
+ [Alias('Template.Docker.Copy')]
+ param(
+ # The source item to copy.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('SourcePath','SourceItem')]
+ [string]
+ $Source,
+
+ # The destination to copy the item to.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Destination
+ )
+
+ process {
+ "COPY $Source $Destination"
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-EntryPoint.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-EntryPoint.ps.ps1
new file mode 100644
index 000000000..a943f4dd2
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-EntryPoint.ps.ps1
@@ -0,0 +1,34 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.EntryPoint {
+ <#
+ .SYNOPSIS
+ Template for a Dockerfile ENTRYPOINT statement.
+ .DESCRIPTION
+ A Template for a Dockerfile ENTRYPOINT statement.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#entrypoint
+ #>
+ param(
+ # The command to run when the container starts.
+ [vbn()]
+ [string]
+ $Command,
+
+ # The arguments to pass to the command.
+ [vbn()]
+ [Alias('Arguments','Args','ArgumentList')]
+ [string[]]
+ $Argument
+ )
+
+ process {
+ if ($Argument) {
+ "ENTRYPOINT $Command $Argument"
+ } else {
+ "ENTRYPOINT $Command"
+ }
+
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-EntryPoint.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-EntryPoint.ps1
new file mode 100644
index 000000000..67d65020d
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-EntryPoint.ps1
@@ -0,0 +1,38 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.EntryPoint {
+
+ <#
+ .SYNOPSIS
+ Template for a Dockerfile ENTRYPOINT statement.
+ .DESCRIPTION
+ A Template for a Dockerfile ENTRYPOINT statement.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#entrypoint
+ #>
+ param(
+ # The command to run when the container starts.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Command,
+
+ # The arguments to pass to the command.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Arguments','Args','ArgumentList')]
+ [string[]]
+ $Argument
+ )
+
+ process {
+ if ($Argument) {
+ "ENTRYPOINT $Command $Argument"
+ } else {
+ "ENTRYPOINT $Command"
+ }
+
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Expose.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Expose.ps.ps1
new file mode 100644
index 000000000..5c16d604e
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Expose.ps.ps1
@@ -0,0 +1,28 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.Expose {
+ <#
+ .SYNOPSIS
+ Template for exposing a port in a Dockerfile.
+ .DESCRIPTION
+ A Template for exposing a port in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#expose
+ #>
+ param(
+ # The port to expose. By default, 80.
+ [vbn()]
+ [int]
+ $Port = 80,
+
+ # The protocol to expose. By default, tcp.
+ [ValidateSet('tcp','udp')]
+ [string]
+ $Protocol = 'tcp'
+ )
+
+ process {
+ "EXPOSE $Port/$Protocol"
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Expose.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Expose.ps1
new file mode 100644
index 000000000..e9ee82fc2
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Expose.ps1
@@ -0,0 +1,32 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.Expose {
+
+ <#
+ .SYNOPSIS
+ Template for exposing a port in a Dockerfile.
+ .DESCRIPTION
+ A Template for exposing a port in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#expose
+ #>
+ param(
+ # The port to expose. By default, 80.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [int]
+ $Port = 80,
+
+ # The protocol to expose. By default, tcp.
+ [ValidateSet('tcp','udp')]
+ [string]
+ $Protocol = 'tcp'
+ )
+
+ process {
+ "EXPOSE $Port/$Protocol"
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-From.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-From.ps.ps1
new file mode 100644
index 000000000..5964faa49
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-From.ps.ps1
@@ -0,0 +1,23 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.From {
+ <#
+ .SYNOPSIS
+ Template for a Dockerfile FROM statement.
+ .DESCRIPTION
+ A Template for a Dockerfile FROM statement.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#from
+ #>
+ param(
+ # The base image to use. By default, mcr.microsoft.com/powershell.
+ [vbn()]
+ [string]
+ $BaseImage = 'mcr.microsoft.com/powershell'
+ )
+
+ process {
+ "FROM $BaseImage"
+ }
+}
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-From.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-From.ps1
new file mode 100644
index 000000000..ee8745512
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-From.ps1
@@ -0,0 +1,28 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.From {
+
+ <#
+ .SYNOPSIS
+ Template for a Dockerfile FROM statement.
+ .DESCRIPTION
+ A Template for a Dockerfile FROM statement.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#from
+ #>
+ param(
+ # The base image to use. By default, mcr.microsoft.com/powershell.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $BaseImage = 'mcr.microsoft.com/powershell'
+ )
+
+ process {
+ "FROM $BaseImage"
+ }
+
+}
+
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-HealthCheck.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-HealthCheck.ps.ps1
new file mode 100644
index 000000000..07ff8b93b
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-HealthCheck.ps.ps1
@@ -0,0 +1,55 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.HealthCheck {
+ <#
+ .SYNOPSIS
+ Template for a health check in a Dockerfile.
+ .DESCRIPTION
+ A Template for a health check in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#healthcheck
+ #>
+ param(
+ # The command to run.
+ [vbn()]
+ [string]
+ $Command,
+
+ # The interval between checks.
+ [vbn()]
+ [timespan]
+ $Interval = [Timespan]'00::00:30',
+
+ # The timeout for a check.
+ [vbn()]
+ [timespan]
+ $Timeout = [Timespan]'00::00:30',
+
+ # The start period for the check.
+ [vbn()]
+ [timespan]
+ $StartPeriod = [Timespan]'00::00:00',
+
+ # The start interval for the check.
+ [vbn()]
+ [timespan]
+ $StartInterval = [Timespan]'00::00:05',
+
+ # The number of retries.
+ [vbn()]
+ [Alias('Retries','Retry')]
+ [int]
+ $RetryCount = 3
+ )
+
+ process {
+ $HealthCheckParameters = foreach ($myParameterKeyValue in $PSBoundParameters.GetEnumerator()) {
+ if ($myParameterKeyValue.Key -eq 'Command') {
+ continue
+ }
+ "--$($myParameterKeyValue.Key.ToLower() -replace 'start', 'start-') $($myParameterKeyValue.Value.TotalSeconds)"
+ }
+ "HEALTHCHECK $HealthCheckParameters $Command" -replace '\s{2,}', ' '
+ }
+}
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-HealthCheck.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-HealthCheck.ps1
new file mode 100644
index 000000000..fe5b5d4d0
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-HealthCheck.ps1
@@ -0,0 +1,60 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.HealthCheck {
+
+ <#
+ .SYNOPSIS
+ Template for a health check in a Dockerfile.
+ .DESCRIPTION
+ A Template for a health check in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#healthcheck
+ #>
+ param(
+ # The command to run.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Command,
+
+ # The interval between checks.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [timespan]
+ $Interval = [Timespan]'00::00:30',
+
+ # The timeout for a check.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [timespan]
+ $Timeout = [Timespan]'00::00:30',
+
+ # The start period for the check.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [timespan]
+ $StartPeriod = [Timespan]'00::00:00',
+
+ # The start interval for the check.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [timespan]
+ $StartInterval = [Timespan]'00::00:05',
+
+ # The number of retries.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Retries','Retry')]
+ [int]
+ $RetryCount = 3
+ )
+
+ process {
+ $HealthCheckParameters = foreach ($myParameterKeyValue in $PSBoundParameters.GetEnumerator()) {
+ if ($myParameterKeyValue.Key -eq 'Command') {
+ continue
+ }
+ "--$($myParameterKeyValue.Key.ToLower() -replace 'start', 'start-') $($myParameterKeyValue.Value.TotalSeconds)"
+ }
+ "HEALTHCHECK $HealthCheckParameters $Command" -replace '\s{2,}', ' '
+ }
+
+}
+
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Label.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Label.ps.ps1
new file mode 100644
index 000000000..aa746fb7b
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Label.ps.ps1
@@ -0,0 +1,28 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.Label {
+ <#
+ .SYNOPSIS
+ Template for setting a label in a Dockerfile.
+ .DESCRIPTION
+ A Template for setting a label in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#label
+ #>
+ param(
+ # The label to set.
+ [vbn()]
+ [string]
+ $Label,
+
+ # The value of the label.
+ [vbn()]
+ [string]
+ $Value
+ )
+
+ process {
+ "LABEL $Label=`"$($Value -replace '"', '\"')`""
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Label.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Label.ps1
new file mode 100644
index 000000000..05cf5fcba
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Label.ps1
@@ -0,0 +1,32 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.Label {
+
+ <#
+ .SYNOPSIS
+ Template for setting a label in a Dockerfile.
+ .DESCRIPTION
+ A Template for setting a label in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#label
+ #>
+ param(
+ # The label to set.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Label,
+
+ # The value of the label.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Value
+ )
+
+ process {
+ "LABEL $Label=`"$($Value -replace '"', '\"')`""
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-OnBuild.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-OnBuild.ps.ps1
new file mode 100644
index 000000000..d26114e72
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-OnBuild.ps.ps1
@@ -0,0 +1,23 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.OnBuild {
+ <#
+ .SYNOPSIS
+ Template for running a command in the build of a Dockerfile.
+ .DESCRIPTION
+ A Template for running a command in the build of this image in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#onbuild
+ #>
+ param(
+ # The command to run.
+ [vbn()]
+ [string]
+ $Command
+ )
+
+ process {
+ "ONBUILD $Command"
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-OnBuild.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-OnBuild.ps1
new file mode 100644
index 000000000..6c7dc6d36
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-OnBuild.ps1
@@ -0,0 +1,27 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.OnBuild {
+
+ <#
+ .SYNOPSIS
+ Template for running a command in the build of a Dockerfile.
+ .DESCRIPTION
+ A Template for running a command in the build of this image in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#onbuild
+ #>
+ param(
+ # The command to run.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Command
+ )
+
+ process {
+ "ONBUILD $Command"
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Run.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Run.ps.ps1
new file mode 100644
index 000000000..55e217f27
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Run.ps.ps1
@@ -0,0 +1,23 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.Run {
+ <#
+ .SYNOPSIS
+ Template for running a command in a Dockerfile.
+ .DESCRIPTION
+ A Template for running a command in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#run
+ #>
+ param(
+ # The command to run.
+ [vbn()]
+ [string]
+ $Command
+ )
+
+ process {
+ "RUN $Command"
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Run.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Run.ps1
new file mode 100644
index 000000000..a4a2c13dd
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Run.ps1
@@ -0,0 +1,27 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.Run {
+
+ <#
+ .SYNOPSIS
+ Template for running a command in a Dockerfile.
+ .DESCRIPTION
+ A Template for running a command in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#run
+ #>
+ param(
+ # The command to run.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Command
+ )
+
+ process {
+ "RUN $Command"
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-SetLocation.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-SetLocation.ps.ps1
new file mode 100644
index 000000000..f235814db
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-SetLocation.ps.ps1
@@ -0,0 +1,24 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.SetLocation {
+ <#
+ .SYNOPSIS
+ Template for setting the working directory in a Dockerfile.
+ .DESCRIPTION
+ A Template for setting the working directory in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#workdir
+ #>
+ [Alias('Template.Docker.WorkDir','Template.Docker.CD')]
+ param(
+ # The path to set as the working directory.
+ [vbn()]
+ [string]
+ $Path
+ )
+
+ process {
+ "WORKDIR $Path"
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-SetLocation.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-SetLocation.ps1
new file mode 100644
index 000000000..5be071e8c
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-SetLocation.ps1
@@ -0,0 +1,28 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.SetLocation {
+
+ <#
+ .SYNOPSIS
+ Template for setting the working directory in a Dockerfile.
+ .DESCRIPTION
+ A Template for setting the working directory in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#workdir
+ #>
+ [Alias('Template.Docker.WorkDir','Template.Docker.CD')]
+ param(
+ # The path to set as the working directory.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Path
+ )
+
+ process {
+ "WORKDIR $Path"
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-SetShell.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-SetShell.ps.ps1
new file mode 100644
index 000000000..2d496fc99
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-SetShell.ps.ps1
@@ -0,0 +1,28 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.SetShell {
+ <#
+ .SYNOPSIS
+ Template for setting the shell in a Dockerfile.
+ .DESCRIPTION
+ A Template for setting the shell in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#shell
+ #>
+ [Alias('Template.Docker.Shell')]
+ param(
+ # The shell to set.
+ [vbn()]
+ [string]
+ $Shell,
+
+ # The arguments to pass to the shell.
+ [string[]]
+ $Argument
+ )
+
+ process {
+ "SHELL [`"$(@(@($Shell) + $Argument) -replace '"', '\"') -join '", "'`"]"
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-SetShell.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-SetShell.ps1
new file mode 100644
index 000000000..ba4093834
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-SetShell.ps1
@@ -0,0 +1,32 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.SetShell {
+
+ <#
+ .SYNOPSIS
+ Template for setting the shell in a Dockerfile.
+ .DESCRIPTION
+ A Template for setting the shell in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#shell
+ #>
+ [Alias('Template.Docker.Shell')]
+ param(
+ # The shell to set.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Shell,
+
+ # The arguments to pass to the shell.
+ [string[]]
+ $Argument
+ )
+
+ process {
+ "SHELL [`"$(@(@($Shell) + $Argument) -replace '"', '\"') -join '", "'`"]"
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-SetUser.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-SetUser.ps.ps1
new file mode 100644
index 000000000..66be93143
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-SetUser.ps.ps1
@@ -0,0 +1,24 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.SetUser {
+ <#
+ .SYNOPSIS
+ Template for setting the current user in a Dockerfile.
+ .DESCRIPTION
+ A Template for setting the current user in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#user
+ #>
+ [Alias('Template.Docker.User')]
+ param(
+ # The user to set.
+ [vbn()]
+ [string]
+ $User
+ )
+
+ process {
+ "USER $User"
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-SetUser.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-SetUser.ps1
new file mode 100644
index 000000000..610c4887a
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-SetUser.ps1
@@ -0,0 +1,28 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.SetUser {
+
+ <#
+ .SYNOPSIS
+ Template for setting the current user in a Dockerfile.
+ .DESCRIPTION
+ A Template for setting the current user in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#user
+ #>
+ [Alias('Template.Docker.User')]
+ param(
+ # The user to set.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $User
+ )
+
+ process {
+ "USER $User"
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-SetVariable.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-SetVariable.ps.ps1
new file mode 100644
index 000000000..39510a8f3
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-SetVariable.ps.ps1
@@ -0,0 +1,29 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.SetVariable {
+ <#
+ .SYNOPSIS
+ Template for setting a variable in a Dockerfile.
+ .DESCRIPTION
+ A Template for setting a variable in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#env
+ #>
+ [Alias('Template.Docker.SetEnvironmentVariable','Template.Docker.SetEnvironment','Template.Docker.Env')]
+ param(
+ # The name of the variable to set.
+ [vbn()]
+ [string]
+ $Name,
+
+ # The value to set the variable to.
+ [vbn()]
+ [string]
+ $Value
+ )
+
+ process {
+ "ENV $Name $Value"
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-SetVariable.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-SetVariable.ps1
new file mode 100644
index 000000000..a120ad975
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-SetVariable.ps1
@@ -0,0 +1,33 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.SetVariable {
+
+ <#
+ .SYNOPSIS
+ Template for setting a variable in a Dockerfile.
+ .DESCRIPTION
+ A Template for setting a variable in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#env
+ #>
+ [Alias('Template.Docker.SetEnvironmentVariable','Template.Docker.SetEnvironment','Template.Docker.Env')]
+ param(
+ # The name of the variable to set.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Name,
+
+ # The value to set the variable to.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Value
+ )
+
+ process {
+ "ENV $Name $Value"
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-StopSignal.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-StopSignal.ps.ps1
new file mode 100644
index 000000000..47e9c4e45
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-StopSignal.ps.ps1
@@ -0,0 +1,23 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.StopSignal {
+ <#
+ .SYNOPSIS
+ Template for setting the stop signal in a Dockerfile.
+ .DESCRIPTION
+ A Template for setting the stop signal in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#stopsignal
+ #>
+ param(
+ # The signal to stop the container.
+ [vbn()]
+ [string]
+ $Signal
+ )
+
+ process {
+ "STOPSIGNAL $Signal"
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-StopSignal.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-StopSignal.ps1
new file mode 100644
index 000000000..6224361c6
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-StopSignal.ps1
@@ -0,0 +1,27 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.StopSignal {
+
+ <#
+ .SYNOPSIS
+ Template for setting the stop signal in a Dockerfile.
+ .DESCRIPTION
+ A Template for setting the stop signal in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#stopsignal
+ #>
+ param(
+ # The signal to stop the container.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Signal
+ )
+
+ process {
+ "STOPSIGNAL $Signal"
+ }
+
+}
+
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Volume.ps.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Volume.ps.ps1
new file mode 100644
index 000000000..1271b3c36
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Volume.ps.ps1
@@ -0,0 +1,24 @@
+[ValidatePattern("docker")]
+param()
+
+Template function Docker.Volume {
+ <#
+ .SYNOPSIS
+ Template for creating a volume in a Dockerfile.
+ .DESCRIPTION
+ A Template for creating a volume in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#volume
+ #>
+ [Alias('Template.Docker.Vol')]
+ param(
+ # The path of the volume.
+ [vbn()]
+ [string]
+ $Path
+ )
+
+ process {
+ "VOLUME $Path"
+ }
+}
\ No newline at end of file
diff --git a/Languages/Docker/Templates/Syntax/Docker-Template-Volume.ps1 b/Languages/Docker/Templates/Syntax/Docker-Template-Volume.ps1
new file mode 100644
index 000000000..a7edbfcc9
--- /dev/null
+++ b/Languages/Docker/Templates/Syntax/Docker-Template-Volume.ps1
@@ -0,0 +1,28 @@
+[ValidatePattern("docker")]
+param()
+
+
+function Template.Docker.Volume {
+
+ <#
+ .SYNOPSIS
+ Template for creating a volume in a Dockerfile.
+ .DESCRIPTION
+ A Template for creating a volume in a Dockerfile.
+ .LINK
+ https://docs.docker.com/engine/reference/builder/#volume
+ #>
+ [Alias('Template.Docker.Vol')]
+ param(
+ # The path of the volume.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Path
+ )
+
+ process {
+ "VOLUME $Path"
+ }
+
+}
+
diff --git a/Languages/Eiffel/Eiffel-Language.ps.ps1 b/Languages/Eiffel/Eiffel-Language.ps.ps1
index 615f2e159..55a8be89c 100644
--- a/Languages/Eiffel/Eiffel-Language.ps.ps1
+++ b/Languages/Eiffel/Eiffel-Language.ps.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>Eiffel|Language)[\s\p{P}]")]
+param()
+
Language function Eiffel {
<#
.SYNOPSIS
diff --git a/Languages/Eiffel/Eiffel-Language.ps1 b/Languages/Eiffel/Eiffel-Language.ps1
index 39fa48d0b..80882b0b9 100644
--- a/Languages/Eiffel/Eiffel-Language.ps1
+++ b/Languages/Eiffel/Eiffel-Language.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>Eiffel|Language)[\s\p{P}]")]
+param()
+
function Language.Eiffel {
<#
diff --git a/Languages/FSharp/FSharp-Language.ps.ps1 b/Languages/FSharp/FSharp-Language.ps.ps1
index 4929316f0..2aa657106 100644
--- a/Languages/FSharp/FSharp-Language.ps.ps1
+++ b/Languages/FSharp/FSharp-Language.ps.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>FSharp|F\#|Language)[\s\p{P}]")]
+param()
+
Language function FSharp {
<#
.SYNOPSIS
diff --git a/Languages/FSharp/FSharp-Language.ps1 b/Languages/FSharp/FSharp-Language.ps1
index 2f85d64d8..056e112f6 100644
--- a/Languages/FSharp/FSharp-Language.ps1
+++ b/Languages/FSharp/FSharp-Language.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>FSharp|F\#|Language)[\s\p{P}]")]
+param()
+
function Language.FSharp {
<#
diff --git a/Languages/GCode/GCode-Language.ps.ps1 b/Languages/GCode/GCode-Language.ps.ps1
index da09ae59c..3c7fe01f4 100644
--- a/Languages/GCode/GCode-Language.ps.ps1
+++ b/Languages/GCode/GCode-Language.ps.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>G-?Code|Language)[\s\p{P}]")]
+param()
+
Language function GCode {
<#
.SYNOPSIS
diff --git a/Languages/GCode/GCode-Language.ps1 b/Languages/GCode/GCode-Language.ps1
index d25d950fd..f7fe5265a 100644
--- a/Languages/GCode/GCode-Language.ps1
+++ b/Languages/GCode/GCode-Language.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>G-?Code|Language)[\s\p{P}]")]
+param()
+
function Language.GCode {
<#
diff --git a/Languages/GLSL/GLSL-Language.ps.ps1 b/Languages/GLSL/GLSL-Language.ps.ps1
index 5cbe3f891..ad4570e76 100644
--- a/Languages/GLSL/GLSL-Language.ps.ps1
+++ b/Languages/GLSL/GLSL-Language.ps.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>GLSL|Language)[\s\p{P}]")]
+param()
+
Language function GLSL {
<#
.SYNOPSIS
diff --git a/Languages/GLSL/GLSL-Language.ps1 b/Languages/GLSL/GLSL-Language.ps1
index 478cbb025..a8285f684 100644
--- a/Languages/GLSL/GLSL-Language.ps1
+++ b/Languages/GLSL/GLSL-Language.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>GLSL|Language)[\s\p{P}]")]
+param()
+
function Language.GLSL {
<#
diff --git a/Languages/Go/Go-Language.ps.ps1 b/Languages/Go/Go-Language.ps.ps1
index 5a331ec2a..fcbe149cc 100644
--- a/Languages/Go/Go-Language.ps.ps1
+++ b/Languages/Go/Go-Language.ps.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>Go|Language)[\s\p{P}]")]
+param()
+
Language function Go {
<#
.SYNOPSIS
diff --git a/Languages/Go/Go-Language.ps1 b/Languages/Go/Go-Language.ps1
index 85f743fa4..db7f5cf65 100644
--- a/Languages/Go/Go-Language.ps1
+++ b/Languages/Go/Go-Language.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>Go|Language)[\s\p{P}]")]
+param()
+
function Language.Go {
<#
diff --git a/Languages/Go/Go-Template-HelloWorld.ps.ps1 b/Languages/Go/Templates/Go-Template-HelloWorld.ps.ps1
similarity index 90%
rename from Languages/Go/Go-Template-HelloWorld.ps.ps1
rename to Languages/Go/Templates/Go-Template-HelloWorld.ps.ps1
index 90f02a2e4..81db9fe75 100644
--- a/Languages/Go/Go-Template-HelloWorld.ps.ps1
+++ b/Languages/Go/Templates/Go-Template-HelloWorld.ps.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("Go[\s\p{P}]")]
+param()
+
Template function HelloWorld.go {
<#
.SYNOPSIS
diff --git a/Languages/Go/Go-Template-HelloWorld.ps1 b/Languages/Go/Templates/Go-Template-HelloWorld.ps1
similarity index 90%
rename from Languages/Go/Go-Template-HelloWorld.ps1
rename to Languages/Go/Templates/Go-Template-HelloWorld.ps1
index c9b2a7c25..a3971dd18 100644
--- a/Languages/Go/Go-Template-HelloWorld.ps1
+++ b/Languages/Go/Templates/Go-Template-HelloWorld.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("Go[\s\p{P}]")]
+param()
+
function Template.HelloWorld.go {
diff --git a/Languages/HCL/HCL-Language.ps.ps1 b/Languages/HCL/HCL-Language.ps.ps1
index 246ec5315..9bd564d63 100644
--- a/Languages/HCL/HCL-Language.ps.ps1
+++ b/Languages/HCL/HCL-Language.ps.ps1
@@ -1,3 +1,7 @@
+[ValidatePattern("(?>HCL|Language)[\s\p{P}]")]
+param()
+
+
Language function HCL {
<#
.SYNOPSIS
diff --git a/Languages/HCL/HCL-Language.ps1 b/Languages/HCL/HCL-Language.ps1
index 14fb7b8fa..8b152d3bd 100644
--- a/Languages/HCL/HCL-Language.ps1
+++ b/Languages/HCL/HCL-Language.ps1
@@ -1,3 +1,7 @@
+[ValidatePattern("(?>HCL|Language)[\s\p{P}]")]
+param()
+
+
function Language.HCL {
<#
diff --git a/Languages/HLSL/HLSL-Language.ps.ps1 b/Languages/HLSL/HLSL-Language.ps.ps1
index 2449e7f1a..40403d134 100644
--- a/Languages/HLSL/HLSL-Language.ps.ps1
+++ b/Languages/HLSL/HLSL-Language.ps.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>HLSL|Language)[\s\p{P}]")]
+param()
+
Language function HLSL {
<#
.SYNOPSIS
diff --git a/Languages/HLSL/HLSL-Language.ps1 b/Languages/HLSL/HLSL-Language.ps1
index ed964cf0e..25857d2a9 100644
--- a/Languages/HLSL/HLSL-Language.ps1
+++ b/Languages/HLSL/HLSL-Language.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>HLSL|Language)[\s\p{P}]")]
+param()
+
function Language.HLSL {
<#
diff --git a/Languages/HTML/HTML-Language.ps.ps1 b/Languages/HTML/HTML-Language.ps.ps1
index a9796b453..cc5ea59e2 100644
--- a/Languages/HTML/HTML-Language.ps.ps1
+++ b/Languages/HTML/HTML-Language.ps.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>HTML|Language)[\s\p{P}]")]
+param()
+
Language function HTML {
<#
.SYNOPSIS
diff --git a/Languages/HTML/HTML-Language.ps1 b/Languages/HTML/HTML-Language.ps1
index 747fd34df..dec73d362 100644
--- a/Languages/HTML/HTML-Language.ps1
+++ b/Languages/HTML/HTML-Language.ps1
@@ -1,3 +1,6 @@
+[ValidatePattern("(?>HTML|Language)[\s\p{P}]")]
+param()
+
function Language.HTML {
<#
diff --git a/Languages/HTML/Templates/Controls/HTML-Template-CustomElement.ps.ps1 b/Languages/HTML/Templates/Controls/HTML-Template-CustomElement.ps.ps1
new file mode 100644
index 000000000..453f5d13d
--- /dev/null
+++ b/Languages/HTML/Templates/Controls/HTML-Template-CustomElement.ps.ps1
@@ -0,0 +1,296 @@
+[ValidatePattern("(?>HTML|JavaScript)")]
+param()
+
+Template function HTML.CustomElement {
+ <#
+ .SYNOPSIS
+ Template for a custom HTML element.
+ .DESCRIPTION
+ A Template for a custom HTML element.
+
+ Creates the JavaScript for a custom HTML element.
+ .LINK
+ https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements
+ .EXAMPLE
+ Template.HTML.CustomElement -ElementName hello-world -Template "Hello, World!
" -OnConnected "
+ console.log('Hello, World!')
+ "
+ Template.HTML.Element -Name "hello-world"
+ #>
+ [Alias(
+ 'Template.HTML.Control',
+ 'Template.Control.html',
+ 'Template.CustomElement.html',
+ 'Template.JavaScript.Control',
+ 'Template.JavaScript.CustomElement',
+ 'Template.Control.js',
+ 'Template.CustomElement.js'
+ )]
+ param(
+ # The name of the element. By default, custom-element.
+ [vbn()]
+ [Alias('Element','Name')]
+ [string]
+ $ElementName = 'custom-element',
+
+ # The class name.
+ # If not provided, it will be derived from the element name.
+ [vbn()]
+ [Alias('Class')]
+ [string]
+ $ClassName,
+
+ # The class that the element extends. By default, HTMLElement.
+ [vbn()]
+ [Alias('Extends','Extend')]
+ [string]
+ $ExtendClass = 'HTMLElement',
+
+ # The base HTML element that is being extended.
+ # If a specific element is extended, you can create a control in form:
+ # ~~~html
+ #
+ # ~~~
+ [vbn()]
+ [Alias('ExtendElements')]
+ [string]
+ $ExtendElement,
+
+ # The parameters to any template.
+ [vbn()]
+ [Alias('Parameters')]
+ [PSObject]
+ $Parameter,
+
+ # The properties for the element.
+ # If multiple values are provided, the property will be gettable and settable.
+ [vbn()]
+ [Alias('Properties')]
+ [PSObject[]]
+ $Property,
+
+ # Any additional members for the element.
+ [vbn()]
+ [Alias('Methods')]
+ [PSObject[]]
+ $Method,
+
+ # Any additional fields for the element.
+ [vbn()]
+ [Alias('Fields')]
+ [PSObject[]]
+ $Field,
+
+ # The template content, or the ID of a template.
+ [vbn()]
+ [Alias('TemplateID','TemplateContent','Content')]
+ [string]
+ $Template,
+
+ # The JavaScript to run when the element is connected.
+ [vbn()]
+ [Alias('OnConnection','ConnectedCallback', 'ConnectionCallback')]
+ [string]
+ $OnConnected,
+
+ # The JavaScript to run when the element is disconnected.
+ [vbn()]
+ [Alias('OnDisconnection','DisconnectedCallback', 'DisconnectionCallback')]
+ [string]
+ $OnDisconnected,
+
+ # The JavaScript to run when the element is adopted.
+ [vbn()]
+ [Alias('OnAdoption','AdoptedCallback', 'AdoptionCallback')]
+ [string]
+ $OnAdopted,
+
+ # The JavaScript to run when attributes are updated.
+ [vbn()]
+ [Alias('OnAttributeChanged','AttributeChangeCallback', 'AttributeChangedCallback')]
+ [string]
+ $OnAttributeChange,
+
+ # A collection of event handlers.
+ # Each key or property will be the element ID (followed by a period) and the event name.
+ # Multiple event names can be separated by commas.
+ [vbn()]
+ [Alias('EventHandlers')]
+ [PSObject]
+ $EventHandler,
+
+ # The list of observable attributes.
+ [vbn()]
+ [Alias('ObservableAttributes','Observable')]
+ [string[]]
+ $ObservableAttribute
+ )
+
+ process {
+ if (-not $PSBoundParameters['ClassName']) {
+ $ClassName = $ElementName -replace '-','_'
+ }
+
+ $Field += @{"#shadow" = "this.attachShadow({mode: 'open'});"}
+ if ($ObservableAttribute -and -not $OnAttributeChange) {
+ foreach ($observerableAttr in $ObservableAttribute) {
+ $defaultFieldName = "#$($observerableAttr -replace "-","_")"
+ if (-not @($field.$defaultFieldName)) {
+ $Field += @{$defaultFieldName = "null"}
+ }
+ $defaultPropertyName = "$($observerableAttr -replace "-","_")"
+ if (-not @($Property.$defaultPropertyName)) {
+ $Property += @{$defaultPropertyName = @("return this.$defaultFieldName","this.$defaultFieldName = value") }
+ }
+ }
+ }
+
+
+ $allMembers = @(
+ if ($field) {
+ foreach ($PropertyBag in @($Field)) {
+ if ($PropertyBag -is [Collections.IDictionary]) {
+ $PropertyBag = [PSCustomObject]$PropertyBag
+ }
+ foreach ($prop in $PropertyBag.PSObject.properties) {
+ "$($prop.Name) = $($prop.Value)"
+ }
+ }
+ }
+
+ if ($EventHandler) {
+ if ($EventHandler -is [Collections.IDictionary]) {
+ $EventHandler = [PSCustomObject]([Ordered]@{} + $EventHandler)
+ }
+ $wireEventHandlers = foreach ($prop in $eventHandler.psobject.properties) {
+ if ($prop.Name -notmatch '\.') { continue }
+ $propNameSegements = $prop.Name -split '\.'
+ if ($propNameSegements.Count -lt 2) { continue }
+ $elementId = $propNameSegements[0..($propNameSegements.Count - 2)] -join '.'
+ $eventNames = $propNameSegements[-1] -split '\s{0,},\s{0,}'
+ $eventHandlerScript = $prop.Value
+ if ($eventHandlerScript -notmatch 'function') {
+ $eventHandlerScript = "function(event) { $eventHandlerScript }"
+ if ($eventHandlerScript -notmatch '.bind(this)\s{0,}$') {
+ $eventHandlerScript = "$eventHandlerScript.bind(this)"
+ }
+ }
+ foreach ($eventName in $eventnames) {
+ @("this.#shadow.getElementById(`"$elementId`").addEventListener("
+ " `"$eventName`","
+ " $eventHandlerScript"
+ ");") -join [Environment]::NewLine
+ }
+ }
+ if ($OnConnected) {
+ $OnConnected = $wireEventHandlers, $OnConnected -join [Environment]::NewLine
+ }
+ }
+
+ if ($OnConnected) {
+ "connectedCallback() { $OnConnected }"
+ }
+ if ($OnDisconnected) {
+ "disconnectedCallback() { $OnDisconnected }"
+ }
+ if ($OnAdopted) {
+ "adoptedCallback() { $OnAdopted }"
+ }
+ if ($ObservableAttribute) {
+ "static get observedAttributes() { return $(ConvertTo-Json -InputObject $ObservableAttribute -Compress) }"
+ }
+ if ($OnAttributeChange) {
+ "attributeChangedCallback(name, oldValue, newValue) { $OnAttributeChange }"
+ } elseif ($ObservableAttribute) {
+ "attributeChangedCallback(name, oldValue, newValue) {
+ this.setAttribute(name, newValue);
+ if (this[name.replace('-','_')] && this[name.replace('-','_')] != newValue) {
+ this[name.replace('-','_')] = newValue;
+ }
+ }"
+ }
+
+ if ($property) {
+ foreach ($PropertyBag in @($Property)) {
+ if ($PropertyBag -is [Collections.IDictionary]) {
+ $PropertyBag = [PSCustomObject]$PropertyBag
+ }
+ foreach ($prop in $PropertyBag.PSObject.properties) {
+ $propName = $prop.Name
+ $propGet, $propSet = $prop.Value
+ if ($propGet) {
+ "get $propName() { $propGet }"
+ }
+ if ($propSet) {
+ "set $propName(value) { $propSet }"
+ }
+ }
+ }
+ }
+
+ if ($method) {
+ foreach ($MemberBag in @($method)) {
+ if ($MemberBag -is [Collections.IDictionary]) {
+ $MemberBag = [PSCustomObject]$MemberBag
+ }
+ foreach ($member in $MemberBag.PSObject.properties) {
+ $memberName = $member.Name
+ $memberValue = $member.Value
+ if ($memberValue -notmatch '\s{0,}\{') {
+ $memberValue = "{ $memberValue }"
+ }
+ "$memberName $memberValue"
+ }
+ }
+ }
+ )
+
+ @"
+$(if ($MyInvocation.InvocationName -match 'HTML') {'
+"@
+ }
+}
diff --git a/Languages/HTML/Templates/Controls/HTML-Template-CustomElement.ps1 b/Languages/HTML/Templates/Controls/HTML-Template-CustomElement.ps1
new file mode 100644
index 000000000..ca61cd3c7
--- /dev/null
+++ b/Languages/HTML/Templates/Controls/HTML-Template-CustomElement.ps1
@@ -0,0 +1,301 @@
+[ValidatePattern("(?>HTML|JavaScript)")]
+param()
+
+
+function Template.HTML.CustomElement {
+
+ <#
+ .SYNOPSIS
+ Template for a custom HTML element.
+ .DESCRIPTION
+ A Template for a custom HTML element.
+
+ Creates the JavaScript for a custom HTML element.
+ .LINK
+ https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements
+ .EXAMPLE
+ Template.HTML.CustomElement -ElementName hello-world -Template "Hello, World!
" -OnConnected "
+ console.log('Hello, World!')
+ "
+ Template.HTML.Element -Name "hello-world"
+ #>
+ [Alias(
+ 'Template.HTML.Control',
+ 'Template.Control.html',
+ 'Template.CustomElement.html',
+ 'Template.JavaScript.Control',
+ 'Template.JavaScript.CustomElement',
+ 'Template.Control.js',
+ 'Template.CustomElement.js'
+ )]
+ param(
+ # The name of the element. By default, custom-element.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Element','Name')]
+ [string]
+ $ElementName = 'custom-element',
+
+ # The class name.
+ # If not provided, it will be derived from the element name.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Class')]
+ [string]
+ $ClassName,
+
+ # The class that the element extends. By default, HTMLElement.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Extends','Extend')]
+ [string]
+ $ExtendClass = 'HTMLElement',
+
+ # The base HTML element that is being extended.
+ # If a specific element is extended, you can create a control in form:
+ # ~~~html
+ #
+ # ~~~
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('ExtendElements')]
+ [string]
+ $ExtendElement,
+
+ # The parameters to any template.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Parameters')]
+ [PSObject]
+ $Parameter,
+
+ # The properties for the element.
+ # If multiple values are provided, the property will be gettable and settable.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Properties')]
+ [PSObject[]]
+ $Property,
+
+ # Any additional members for the element.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Methods')]
+ [PSObject[]]
+ $Method,
+
+ # Any additional fields for the element.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Fields')]
+ [PSObject[]]
+ $Field,
+
+ # The template content, or the ID of a template.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('TemplateID','TemplateContent','Content')]
+ [string]
+ $Template,
+
+ # The JavaScript to run when the element is connected.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('OnConnection','ConnectedCallback', 'ConnectionCallback')]
+ [string]
+ $OnConnected,
+
+ # The JavaScript to run when the element is disconnected.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('OnDisconnection','DisconnectedCallback', 'DisconnectionCallback')]
+ [string]
+ $OnDisconnected,
+
+ # The JavaScript to run when the element is adopted.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('OnAdoption','AdoptedCallback', 'AdoptionCallback')]
+ [string]
+ $OnAdopted,
+
+ # The JavaScript to run when attributes are updated.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('OnAttributeChanged','AttributeChangeCallback', 'AttributeChangedCallback')]
+ [string]
+ $OnAttributeChange,
+
+ # A collection of event handlers.
+ # Each key or property will be the element ID (followed by a period) and the event name.
+ # Multiple event names can be separated by commas.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('EventHandlers')]
+ [PSObject]
+ $EventHandler,
+
+ # The list of observable attributes.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('ObservableAttributes','Observable')]
+ [string[]]
+ $ObservableAttribute
+ )
+
+ process {
+ if (-not $PSBoundParameters['ClassName']) {
+ $ClassName = $ElementName -replace '-','_'
+ }
+
+ $Field += @{"#shadow" = "this.attachShadow({mode: 'open'});"}
+ if ($ObservableAttribute -and -not $OnAttributeChange) {
+ foreach ($observerableAttr in $ObservableAttribute) {
+ $defaultFieldName = "#$($observerableAttr -replace "-","_")"
+ if (-not @($field.$defaultFieldName)) {
+ $Field += @{$defaultFieldName = "null"}
+ }
+ $defaultPropertyName = "$($observerableAttr -replace "-","_")"
+ if (-not @($Property.$defaultPropertyName)) {
+ $Property += @{$defaultPropertyName = @("return this.$defaultFieldName","this.$defaultFieldName = value") }
+ }
+ }
+ }
+
+
+ $allMembers = @(
+ if ($field) {
+ foreach ($PropertyBag in @($Field)) {
+ if ($PropertyBag -is [Collections.IDictionary]) {
+ $PropertyBag = [PSCustomObject]$PropertyBag
+ }
+ foreach ($prop in $PropertyBag.PSObject.properties) {
+ "$($prop.Name) = $($prop.Value)"
+ }
+ }
+ }
+
+ if ($EventHandler) {
+ if ($EventHandler -is [Collections.IDictionary]) {
+ $EventHandler = [PSCustomObject]([Ordered]@{} + $EventHandler)
+ }
+ $wireEventHandlers = foreach ($prop in $eventHandler.psobject.properties) {
+ if ($prop.Name -notmatch '\.') { continue }
+ $propNameSegements = $prop.Name -split '\.'
+ if ($propNameSegements.Count -lt 2) { continue }
+ $elementId = $propNameSegements[0..($propNameSegements.Count - 2)] -join '.'
+ $eventNames = $propNameSegements[-1] -split '\s{0,},\s{0,}'
+ $eventHandlerScript = $prop.Value
+ if ($eventHandlerScript -notmatch 'function') {
+ $eventHandlerScript = "function(event) { $eventHandlerScript }"
+ if ($eventHandlerScript -notmatch '.bind(this)\s{0,}$') {
+ $eventHandlerScript = "$eventHandlerScript.bind(this)"
+ }
+ }
+ foreach ($eventName in $eventnames) {
+ @("this.#shadow.getElementById(`"$elementId`").addEventListener("
+ " `"$eventName`","
+ " $eventHandlerScript"
+ ");") -join [Environment]::NewLine
+ }
+ }
+ if ($OnConnected) {
+ $OnConnected = $wireEventHandlers, $OnConnected -join [Environment]::NewLine
+ }
+ }
+
+ if ($OnConnected) {
+ "connectedCallback() { $OnConnected }"
+ }
+ if ($OnDisconnected) {
+ "disconnectedCallback() { $OnDisconnected }"
+ }
+ if ($OnAdopted) {
+ "adoptedCallback() { $OnAdopted }"
+ }
+ if ($ObservableAttribute) {
+ "static get observedAttributes() { return $(ConvertTo-Json -InputObject $ObservableAttribute -Compress) }"
+ }
+ if ($OnAttributeChange) {
+ "attributeChangedCallback(name, oldValue, newValue) { $OnAttributeChange }"
+ } elseif ($ObservableAttribute) {
+ "attributeChangedCallback(name, oldValue, newValue) {
+ this.setAttribute(name, newValue);
+ if (this[name.replace('-','_')] && this[name.replace('-','_')] != newValue) {
+ this[name.replace('-','_')] = newValue;
+ }
+ }"
+ }
+
+ if ($property) {
+ foreach ($PropertyBag in @($Property)) {
+ if ($PropertyBag -is [Collections.IDictionary]) {
+ $PropertyBag = [PSCustomObject]$PropertyBag
+ }
+ foreach ($prop in $PropertyBag.PSObject.properties) {
+ $propName = $prop.Name
+ $propGet, $propSet = $prop.Value
+ if ($propGet) {
+ "get $propName() { $propGet }"
+ }
+ if ($propSet) {
+ "set $propName(value) { $propSet }"
+ }
+ }
+ }
+ }
+
+ if ($method) {
+ foreach ($MemberBag in @($method)) {
+ if ($MemberBag -is [Collections.IDictionary]) {
+ $MemberBag = [PSCustomObject]$MemberBag
+ }
+ foreach ($member in $MemberBag.PSObject.properties) {
+ $memberName = $member.Name
+ $memberValue = $member.Value
+ if ($memberValue -notmatch '\s{0,}\{') {
+ $memberValue = "{ $memberValue }"
+ }
+ "$memberName $memberValue"
+ }
+ }
+ }
+ )
+
+ @"
+$(if ($MyInvocation.InvocationName -match 'HTML') {'
+"@
+ }
+
+}
+
+
diff --git a/Languages/HTML/Templates/HTML-Template-HelloWorld.ps.ps1 b/Languages/HTML/Templates/HTML-Template-HelloWorld.ps.ps1
new file mode 100644
index 000000000..0380e7d86
--- /dev/null
+++ b/Languages/HTML/Templates/HTML-Template-HelloWorld.ps.ps1
@@ -0,0 +1,25 @@
+[ValidatePattern("HTML")]
+param()
+
+Template function HelloWorld.html {
+ <#
+ .SYNOPSIS
+ Hello World in HTML
+ .DESCRIPTION
+ A Template for Hello World, in HTML.
+ #>
+ [Alias('Template.HTML.HelloWorld')]
+ param(
+ # The message to print. By default, "hello world".
+ [vbn()]
+ [string]
+ $Message = "hello world"
+ )
+ process {
+@"
+
+$([Security.SecurityElement]::Escape($message))
+
+"@
+ }
+}
diff --git a/Languages/HTML/Templates/HTML-Template-HelloWorld.ps1 b/Languages/HTML/Templates/HTML-Template-HelloWorld.ps1
new file mode 100644
index 000000000..6a8f3f745
--- /dev/null
+++ b/Languages/HTML/Templates/HTML-Template-HelloWorld.ps1
@@ -0,0 +1,30 @@
+[ValidatePattern("HTML")]
+param()
+
+
+function Template.HelloWorld.html {
+
+ <#
+ .SYNOPSIS
+ Hello World in HTML
+ .DESCRIPTION
+ A Template for Hello World, in HTML.
+ #>
+ [Alias('Template.HTML.HelloWorld')]
+ param(
+ # The message to print. By default, "hello world".
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Message = "hello world"
+ )
+ process {
+@"
+
+$([Security.SecurityElement]::Escape($message))
+
+"@
+ }
+
+}
+
+
diff --git a/Languages/HTML/Templates/Input/HTML-Template-Command-Input.ps.ps1 b/Languages/HTML/Templates/Input/HTML-Template-Command-Input.ps.ps1
new file mode 100644
index 000000000..657056f97
--- /dev/null
+++ b/Languages/HTML/Templates/Input/HTML-Template-Command-Input.ps.ps1
@@ -0,0 +1,265 @@
+[ValidatePattern('HTML')]
+param()
+
+
+Template function HTML.Command.Input {
+ <#
+ .SYNOPSIS
+ Generates an HTML command input.
+ .DESCRIPTION
+ Generates HTML input for a command.
+ .EXAMPLE
+ Get-Command Get-Command | Template.HTML.Command.Input
+ .EXAMPLE
+ New-WebPage -Content @(
+ Get-Command Template.HTML.Command.Input | Template.HTML.Command.Input
+ ) -Palette "Konsolas"
+ #>
+ [CmdletBinding(DefaultParameterSetName='None')]
+ param(
+ # The Command Metadata. This can be provided via the pipeline from Get-Command.
+ [vfp(Mandatory,ParameterSetName='CommandMetadata')]
+ [Management.Automation.CommandMetadata]
+ $CommandMetadata,
+
+ # The name of the command.
+ [vbn()]
+ [Alias('CommandName')]
+ [string]
+ $Name,
+
+ # The element identifier.
+ [vbn()]
+ [Alias('ElementID')]
+ [string]
+ $Id,
+
+ # The display name of the command.
+ # If this is not provided, it will be the name, split on camel cased spaced or punctuation.
+ [vbn()]
+ [Alias('FriendlyName')]
+ [string]
+ $DisplayName,
+
+ # The reset text, by default, nothing.
+ [vbn()]
+ [string]
+ $ResetText = '',
+
+ # If the command supports ShouldProcess (`-WhatIf`, `-Confirm`)
+ [vbn()]
+ [switch]
+ $SupportsShouldProcess,
+
+ # If the command supports paging.
+ [vbn()]
+ [switch]
+ $SupportsPaging,
+
+ # If the command supports positional binding
+ [vbn()]
+ [switch]
+ $PositionalBinding,
+
+ # The help URI for the command.
+ [vbn()]
+ [uri]
+ $HelpUri,
+
+ # The confirm impact of the command.
+ [vbn()]
+ [Management.Automation.ConfirmImpact]
+ $ConfirmImpact,
+
+ # The parameter metadata for the command.
+ [vbn()]
+ [Alias('Parameters')]
+ [PSObject]
+ $Parameter,
+
+ # The Command Description.
+ [vbn()]
+ [Alias('CommandDescription')]
+ [string]
+ $Description,
+
+ # The Command Synopsis.
+ [vbn()]
+ [Alias('CommandSynopsis')]
+ [string]
+ $Synopsis,
+
+ # The Command Example.
+ [vbn()]
+ [Alias('CommandExample')]
+ [string[]]
+ $Example,
+
+ # The Command Notes.
+ [vbn()]
+ [Alias('Note','CommandNotes')]
+ [string[]]
+ $Notes,
+
+ # The Command Links.
+ [vbn()]
+ [Alias('Links','CommandLinks')]
+ [string[]]
+ $Link,
+
+ # The Element Map.
+ # This maps parameters to the HTML elements that will be used to render them.
+ [vbn()]
+ [Management.Automation.Hidden()]
+ [Alias('ElementNameMap','ElementNames')]
+ [PSObject]
+ $ElementMap = [Ordered]@{
+ 'Name' = 'h2'
+ 'Synopsis' = 'p'
+ 'Description' = 'p'
+ 'Example' = 'code'
+ 'Link' = 'p'
+ 'Notes' = 'p'
+ },
+
+ # The Element Attribute Map.
+ # This maps parameters to the HTML element attributes that will be used to render them.
+ [vbn()]
+ [Management.Automation.Hidden()]
+ [PSObject]
+ $ElementAttributeMap = [Ordered]@{
+ 'Example' = [Ordered]@{
+ 'class' = 'language-powershell'
+ 'language' = 'PowerShell'
+ }
+ },
+
+ # The element separator. This is used to separate elements.
+ [vbn()]
+ [psobject]
+ $ElementSeparator = '
',
+
+ # The Command Attributes. These are used to provide additional information about the command.
+ # They will be automatically provided if piping a command into this function.
+ # If an attribute named HTML.Input is provided, it will be returned directly.
+ [vbn()]
+ [Alias('Attributes','CommandAttribute','CommandAttributes')]
+ [PSObject[]]
+ $Attribute,
+
+ # The Container Element. This is used to hold all of the elements.
+ [vbn()]
+ [string]
+ $ContainerElement,
+
+ # The Container Attributes.
+ [vbn()]
+ [PSObject[]]
+ $ContainerAttribute,
+
+ # The Item Element. This is used to hold each item.
+ [vbn()]
+ [string]
+ $ItemElement,
+
+ # The Item Attributes.
+ [vbn()]
+ [PSObject[]]
+ $ItemAttribute,
+
+ # The Item Separator. This is used to separate items.
+ # The default is a line break.
+ [vbn()]
+ [PSObject]
+ $ItemSeparator = "
",
+
+ # If set, this will not include a submit button.
+ [vbn()]
+ [switch]
+ $NoSubmit,
+
+ # If set, this will not include a reset button.
+ [vbn()]
+ [switch]
+ $NoReset
+ )
+
+
+ process {
+ # First, check our attributes
+ foreach ($attr in $Attribute) {
+ # to see if we have an HTML Input attribute.
+ if ($attr -is [Reflection.AssemblyMetadataAttribute] -and
+ $attr.Key -match '^HTML\p{P}?Input') {
+ # If we do, return it.
+ return $attr.Value
+ }
+ }
+
+
+ # Then copy the parameters
+ $myParameterCopy = [Ordered]@{} + $PSBoundParameters
+ $elementOrder =
+ @(if ($elementMap -is [Collections.IDictionary]) {
+ $elementMap.Keys
+ } else {
+ $elementMap.PSObject.Properties.Name
+ })
+
+
+
+ $ItemsInContainer = @(
+ # Many parameters will be turned directly into elements,
+ # using the -ElementMap and -ElementAttributeMap
+ foreach ($potentialElement in $elementOrder) {
+ @(if ($myParameterCopy.($potentialElement)) {
+ $ElementSplat = [Ordered]@{
+ Name = $elementMap.$potentialElement
+ Content = "$($myParameterCopy.$potentialElement)"
+ }
+ if ($ElementAttributeMap.$potentialElement) {
+ $ElementSplat.Attribute = $ElementAttributeMap.$potentialElement
+ }
+ Template.HTML.Element @ElementSplat
+ }) -join $ElementSeparator
+ }
+
+ # Any parameters should be turned into input elements.
+ if ($parameter -is [Collections.IDictionary]) {
+ $parameter.Values | Template.HTML.Parameter.Input
+ } elseif ($Parameter) {
+ $Parameter | Template.HTML.Parameter.Input
+ }
+ $CamelCaseSpace = [Regex]::new('(?(?<=[a-z])(?=[A-Z]))')
+ $CamelCaseOrPunctuation = [Regex]::new("(?>[\s\p{P}]|$CamelCaseSpace)")
+ if ($ResetText) {
+ if (-not $NoReset) {
+ Template.HTML.InputElement -InputType reset -Value $ResetText
+ }
+ }
+ if (-not $NoSubmit -and ($name -or $DisplayName)) {
+ Template.HTML.InputElement -InputType submit -Value $(
+ $(if ($DisplayName) { $DisplayName } else { $Name }) -replace $CamelCaseOrPunctuation,' '
+ )
+ }
+ )
+
+ # Now we want to put all of the items into a container.
+ $ContainerContent =
+ @(foreach ($itemInContainer in $ItemsInContainer) {
+ # If we have an item element, wrap it in that element.
+ if ($ItemElement) {
+ Template.HTML.Element -Name $ItemElement -Content $itemInContainer -Attribute $ItemAttribute
+ } else {
+ $itemInContainer
+ }
+ }) -join $ItemSeparator # If we have an item separator, join the items with it.
+
+ # If we have a container element, wrap the all the items in that element.
+ if ($ContainerElement) {
+ Template.HTML.Element -Name $ContainerElement -Content $ContainerContent -Attribute $ContainerAttribute -Id $Id
+ } else {
+ $ContainerContent # Otherwise, return the items directly.
+ }
+ }
+}
\ No newline at end of file
diff --git a/Languages/HTML/Templates/Input/HTML-Template-Command-Input.ps1 b/Languages/HTML/Templates/Input/HTML-Template-Command-Input.ps1
new file mode 100644
index 000000000..039e6d6d7
--- /dev/null
+++ b/Languages/HTML/Templates/Input/HTML-Template-Command-Input.ps1
@@ -0,0 +1,269 @@
+[ValidatePattern('HTML')]
+param()
+
+
+
+function Template.HTML.Command.Input {
+
+ <#
+ .SYNOPSIS
+ Generates an HTML command input.
+ .DESCRIPTION
+ Generates HTML input for a command.
+ .EXAMPLE
+ Get-Command Get-Command | Template.HTML.Command.Input
+ .EXAMPLE
+ New-WebPage -Content @(
+ Get-Command Template.HTML.Command.Input | Template.HTML.Command.Input
+ ) -Palette "Konsolas"
+ #>
+ [CmdletBinding(DefaultParameterSetName='None')]
+ param(
+ # The Command Metadata. This can be provided via the pipeline from Get-Command.
+ [Parameter(Mandatory,ParameterSetName='CommandMetadata',ValueFromPipeline)]
+ [Management.Automation.CommandMetadata]
+ $CommandMetadata,
+
+ # The name of the command.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('CommandName')]
+ [string]
+ $Name,
+
+ # The element identifier.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('ElementID')]
+ [string]
+ $Id,
+
+ # The display name of the command.
+ # If this is not provided, it will be the name, split on camel cased spaced or punctuation.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('FriendlyName')]
+ [string]
+ $DisplayName,
+
+ # The reset text, by default, nothing.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $ResetText = '',
+
+ # If the command supports ShouldProcess (`-WhatIf`, `-Confirm`)
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $SupportsShouldProcess,
+
+ # If the command supports paging.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $SupportsPaging,
+
+ # If the command supports positional binding
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $PositionalBinding,
+
+ # The help URI for the command.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [uri]
+ $HelpUri,
+
+ # The confirm impact of the command.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Management.Automation.ConfirmImpact]
+ $ConfirmImpact,
+
+ # The parameter metadata for the command.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Parameters')]
+ [PSObject]
+ $Parameter,
+
+ # The Command Description.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('CommandDescription')]
+ [string]
+ $Description,
+
+ # The Command Synopsis.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('CommandSynopsis')]
+ [string]
+ $Synopsis,
+
+ # The Command Example.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('CommandExample')]
+ [string[]]
+ $Example,
+
+ # The Command Notes.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Note','CommandNotes')]
+ [string[]]
+ $Notes,
+
+ # The Command Links.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Links','CommandLinks')]
+ [string[]]
+ $Link,
+
+ # The Element Map.
+ # This maps parameters to the HTML elements that will be used to render them.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Management.Automation.Hidden()]
+ [Alias('ElementNameMap','ElementNames')]
+ [PSObject]
+ $ElementMap = [Ordered]@{
+ 'Name' = 'h2'
+ 'Synopsis' = 'p'
+ 'Description' = 'p'
+ 'Example' = 'code'
+ 'Link' = 'p'
+ 'Notes' = 'p'
+ },
+
+ # The Element Attribute Map.
+ # This maps parameters to the HTML element attributes that will be used to render them.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Management.Automation.Hidden()]
+ [PSObject]
+ $ElementAttributeMap = [Ordered]@{
+ 'Example' = [Ordered]@{
+ 'class' = 'language-powershell'
+ 'language' = 'PowerShell'
+ }
+ },
+
+ # The element separator. This is used to separate elements.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [psobject]
+ $ElementSeparator = '
',
+
+ # The Command Attributes. These are used to provide additional information about the command.
+ # They will be automatically provided if piping a command into this function.
+ # If an attribute named HTML.Input is provided, it will be returned directly.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Attributes','CommandAttribute','CommandAttributes')]
+ [PSObject[]]
+ $Attribute,
+
+ # The Container Element. This is used to hold all of the elements.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $ContainerElement,
+
+ # The Container Attributes.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [PSObject[]]
+ $ContainerAttribute,
+
+ # The Item Element. This is used to hold each item.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $ItemElement,
+
+ # The Item Attributes.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [PSObject[]]
+ $ItemAttribute,
+
+ # The Item Separator. This is used to separate items.
+ # The default is a line break.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [PSObject]
+ $ItemSeparator = "
",
+
+ # If set, this will not include a submit button.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $NoSubmit,
+
+ # If set, this will not include a reset button.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $NoReset
+ )
+
+
+ process {
+ # First, check our attributes
+ foreach ($attr in $Attribute) {
+ # to see if we have an HTML Input attribute.
+ if ($attr -is [Reflection.AssemblyMetadataAttribute] -and
+ $attr.Key -match '^HTML\p{P}?Input') {
+ # If we do, return it.
+ return $attr.Value
+ }
+ }
+
+
+ # Then copy the parameters
+ $myParameterCopy = [Ordered]@{} + $PSBoundParameters
+ $elementOrder =
+ @(if ($elementMap -is [Collections.IDictionary]) {
+ $elementMap.Keys
+ } else {
+ $elementMap.PSObject.Properties.Name
+ })
+
+
+
+ $ItemsInContainer = @(
+ # Many parameters will be turned directly into elements,
+ # using the -ElementMap and -ElementAttributeMap
+ foreach ($potentialElement in $elementOrder) {
+ @(if ($myParameterCopy.($potentialElement)) {
+ $ElementSplat = [Ordered]@{
+ Name = $elementMap.$potentialElement
+ Content = "$($myParameterCopy.$potentialElement)"
+ }
+ if ($ElementAttributeMap.$potentialElement) {
+ $ElementSplat.Attribute = $ElementAttributeMap.$potentialElement
+ }
+ Template.HTML.Element @ElementSplat
+ }) -join $ElementSeparator
+ }
+
+ # Any parameters should be turned into input elements.
+ if ($parameter -is [Collections.IDictionary]) {
+ $parameter.Values | Template.HTML.Parameter.Input
+ } elseif ($Parameter) {
+ $Parameter | Template.HTML.Parameter.Input
+ }
+ $CamelCaseSpace = [Regex]::new('(?(?<=[a-z])(?=[A-Z]))')
+ $CamelCaseOrPunctuation = [Regex]::new("(?>[\s\p{P}]|$CamelCaseSpace)")
+ if ($ResetText) {
+ if (-not $NoReset) {
+ Template.HTML.InputElement -InputType reset -Value $ResetText
+ }
+ }
+ if (-not $NoSubmit -and ($name -or $DisplayName)) {
+ Template.HTML.InputElement -InputType submit -Value $(
+ $(if ($DisplayName) { $DisplayName } else { $Name }) -replace $CamelCaseOrPunctuation,' '
+ )
+ }
+ )
+
+ # Now we want to put all of the items into a container.
+ $ContainerContent =
+ @(foreach ($itemInContainer in $ItemsInContainer) {
+ # If we have an item element, wrap it in that element.
+ if ($ItemElement) {
+ Template.HTML.Element -Name $ItemElement -Content $itemInContainer -Attribute $ItemAttribute
+ } else {
+ $itemInContainer
+ }
+ }) -join $ItemSeparator # If we have an item separator, join the items with it.
+
+ # If we have a container element, wrap the all the items in that element.
+ if ($ContainerElement) {
+ Template.HTML.Element -Name $ContainerElement -Content $ContainerContent -Attribute $ContainerAttribute -Id $Id
+ } else {
+ $ContainerContent # Otherwise, return the items directly.
+ }
+ }
+
+}
+
diff --git a/Languages/HTML/Templates/Input/HTML-Template-InputElement.ps.ps1 b/Languages/HTML/Templates/Input/HTML-Template-InputElement.ps.ps1
new file mode 100644
index 000000000..67ef878c5
--- /dev/null
+++ b/Languages/HTML/Templates/Input/HTML-Template-InputElement.ps.ps1
@@ -0,0 +1,230 @@
+[ValidatePattern('HTML')]
+param()
+
+Template function HTML.InputElement {
+ <#
+ .SYNOPSIS
+ Template for an HTML input.
+ .DESCRIPTION
+ A Template for an HTML input element.
+ .LINK
+ https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input
+ #>
+ [CmdletBinding(PositionalBinding=$false)]
+ param(
+ # The name of the input.
+ [vbn()]
+ [Alias('InputName')]
+ [string]
+ $Name,
+
+ # The type of input.
+ [vbn()]
+ [alias('type')]
+ [ValidateSet("button","checkbox","color","date","datetime-local",
+ "email","file","hidden","image","month","number",
+ "password","radio","range","reset","search","submit",
+ "tel","text","time","url","week")]
+ [string]
+ $InputType,
+
+ # The ID of the input.
+ [vbn()]
+ [string]
+ $ID,
+
+ # The class of the input.
+ [vbn()]
+ [Alias('CssClass')]
+ [string[]]
+ $Class,
+
+ # The label of the input.
+ [vbn()]
+ [string]
+ $Label,
+
+ # The value of the input.
+ [vbn()]
+ [string]
+ $Value,
+
+ # The placeholder of the input.
+ [vbn()]
+ [string]
+ $Placeholder,
+
+ # If the input is required.
+ [vbn()]
+ [switch]
+ $Required,
+
+ # If the input is disabled.
+ [vbn()]
+ [switch]
+ $Disabled,
+
+ # If the input is readonly.
+ [vbn()]
+ [switch]
+ $ReadOnly,
+
+ # If the input is checked.
+ [vbn()]
+ [switch]
+ $Checked,
+
+ # The minimum value of the input.
+ [vbn()]
+ [string]
+ $Min,
+
+ # The maximum value of the input.
+ [vbn()]
+ [string]
+ $Max,
+
+ # The step value of the input.
+ [vbn()]
+ [string]
+ $Step,
+
+ # The pattern of the input.
+ [vbn()]
+ [string]
+ $Pattern,
+
+ # The autocomplete of the input.
+ [vbn()]
+ [ValidateSet("on","off")]
+ [string]
+ $AutoComplete,
+
+ # The form that the input is associated with.
+ [vbn()]
+ [string]
+ $Form,
+
+ # The formaction of the input.
+ [vbn()]
+ [string]
+ $FormAction,
+
+ # The formenctype of the input.
+ [vbn()]
+ [Alias('FormEnc','FormEncType')]
+ [ValidateSet("application/x-www-form-urlencoded","multipart/form-data","text/plain")]
+ [string]
+ $FormEncodingType,
+
+ # The formmethod of the input.
+ [vbn()]
+ [Alias('FormMeth')]
+ [ValidateSet("get","post")]
+ [string]
+ $FormMethod,
+
+ # The formnovalidate of the input.
+ [vbn()]
+ [switch]
+ $FormNoValidate,
+
+ # The formtarget of the input.
+ [vbn()]
+ [Alias('FormTarg')]
+ [ValidateSet("_blank","_self","_parent","_top")]
+ [string]
+ $FormTarget,
+
+ # The height of the input.
+ [vbn()]
+ [string]
+ $Height,
+
+ # The width of the input.
+ [vbn()]
+ [string]
+ $Width,
+
+ # The list of the input.
+ [vbn()]
+ [string]
+ $List,
+
+ # The minimum length of the input.
+ [vbn()]
+ [Alias('MinimumLength')]
+ [int]
+ $MinLength,
+
+ # If set, an email input can accept multiple emails, or a file input can accept multiple files.
+ [vbn()]
+ [switch]
+ $Multiple,
+
+ # The size of the input.
+ [vbn()]
+ [string]
+ $Size,
+
+ # The accept of the input.
+ [vbn()]
+ [string]
+ $Accept,
+
+ # The accept-charset of the input.
+ [vbn()]
+ [string]
+ $AcceptCharset,
+
+ # The autofocus of the input.
+ [vbn()]
+ [switch]
+ $AutoFocus
+ )
+
+ process {
+ $InputAttributes = @(
+ if ($ID) { "id='$ID'" }
+ if ($Class) { "class='$($Class -join ' ')'" }
+ if ($inputType) { "type='$inputType'" }
+ if ($name) { "name='$name'" }
+ if ($value) { "value='$value'" }
+ if ($placeholder) { "placeholder='$placeholder'" }
+ if ($required) { "required" }
+ if ($disabled) { "disabled" }
+ if ($readOnly) { "readonly" }
+ if ($checked) { "checked" }
+ if ($min) { "min='$min'" }
+ if ($max) { "max='$max'" }
+ if ($step) { "step='$step'" }
+ if ($pattern) { "pattern='$pattern'" }
+ if ($autoComplete) { "autocomplete='$autoComplete'" }
+ if ($form) { "form='$form'" }
+ if ($formAction) { "formaction='$formAction'" }
+ if ($formEncodingType) { "formenctype='$formEncodingType'" }
+ if ($formMethod) { "formmethod='$formMethod'" }
+ if ($formNoValidate) { "formnovalidate" }
+ if ($formTarget) { "formtarget='$formTarget'" }
+ if ($height) { "height='$height'" }
+ if ($width) { "width='$width'" }
+ if ($list) { "list='$list'" }
+ if ($multiple) { "multiple" }
+ if ($size) { "size='$size'" }
+ if ($accept) { "accept='$accept'" }
+ if ($acceptCharset) { "accept-charset='$acceptCharset'" }
+ if ($autoFocus) { "autofocus" }
+ ) -join ' '
+
+
+ @(
+ if ($Label -and $ID) {
+ if ($label -notmatch '"
+ ) -join [Environment]::newLine
+ }
+}
\ No newline at end of file
diff --git a/Languages/HTML/Templates/Input/HTML-Template-InputElement.ps1 b/Languages/HTML/Templates/Input/HTML-Template-InputElement.ps1
new file mode 100644
index 000000000..909c71f2a
--- /dev/null
+++ b/Languages/HTML/Templates/Input/HTML-Template-InputElement.ps1
@@ -0,0 +1,234 @@
+[ValidatePattern('HTML')]
+param()
+
+
+function Template.HTML.InputElement {
+
+ <#
+ .SYNOPSIS
+ Template for an HTML input.
+ .DESCRIPTION
+ A Template for an HTML input element.
+ .LINK
+ https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input
+ #>
+ [CmdletBinding(PositionalBinding=$false)]
+ param(
+ # The name of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('InputName')]
+ [string]
+ $Name,
+
+ # The type of input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [alias('type')]
+ [ValidateSet("button","checkbox","color","date","datetime-local",
+ "email","file","hidden","image","month","number",
+ "password","radio","range","reset","search","submit",
+ "tel","text","time","url","week")]
+ [string]
+ $InputType,
+
+ # The ID of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $ID,
+
+ # The class of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('CssClass')]
+ [string[]]
+ $Class,
+
+ # The label of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Label,
+
+ # The value of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Value,
+
+ # The placeholder of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Placeholder,
+
+ # If the input is required.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $Required,
+
+ # If the input is disabled.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $Disabled,
+
+ # If the input is readonly.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $ReadOnly,
+
+ # If the input is checked.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $Checked,
+
+ # The minimum value of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Min,
+
+ # The maximum value of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Max,
+
+ # The step value of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Step,
+
+ # The pattern of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Pattern,
+
+ # The autocomplete of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [ValidateSet("on","off")]
+ [string]
+ $AutoComplete,
+
+ # The form that the input is associated with.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Form,
+
+ # The formaction of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $FormAction,
+
+ # The formenctype of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('FormEnc','FormEncType')]
+ [ValidateSet("application/x-www-form-urlencoded","multipart/form-data","text/plain")]
+ [string]
+ $FormEncodingType,
+
+ # The formmethod of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('FormMeth')]
+ [ValidateSet("get","post")]
+ [string]
+ $FormMethod,
+
+ # The formnovalidate of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $FormNoValidate,
+
+ # The formtarget of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('FormTarg')]
+ [ValidateSet("_blank","_self","_parent","_top")]
+ [string]
+ $FormTarget,
+
+ # The height of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Height,
+
+ # The width of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Width,
+
+ # The list of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $List,
+
+ # The minimum length of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('MinimumLength')]
+ [int]
+ $MinLength,
+
+ # If set, an email input can accept multiple emails, or a file input can accept multiple files.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $Multiple,
+
+ # The size of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Size,
+
+ # The accept of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $Accept,
+
+ # The accept-charset of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $AcceptCharset,
+
+ # The autofocus of the input.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [switch]
+ $AutoFocus
+ )
+
+ process {
+ $InputAttributes = @(
+ if ($ID) { "id='$ID'" }
+ if ($Class) { "class='$($Class -join ' ')'" }
+ if ($inputType) { "type='$inputType'" }
+ if ($name) { "name='$name'" }
+ if ($value) { "value='$value'" }
+ if ($placeholder) { "placeholder='$placeholder'" }
+ if ($required) { "required" }
+ if ($disabled) { "disabled" }
+ if ($readOnly) { "readonly" }
+ if ($checked) { "checked" }
+ if ($min) { "min='$min'" }
+ if ($max) { "max='$max'" }
+ if ($step) { "step='$step'" }
+ if ($pattern) { "pattern='$pattern'" }
+ if ($autoComplete) { "autocomplete='$autoComplete'" }
+ if ($form) { "form='$form'" }
+ if ($formAction) { "formaction='$formAction'" }
+ if ($formEncodingType) { "formenctype='$formEncodingType'" }
+ if ($formMethod) { "formmethod='$formMethod'" }
+ if ($formNoValidate) { "formnovalidate" }
+ if ($formTarget) { "formtarget='$formTarget'" }
+ if ($height) { "height='$height'" }
+ if ($width) { "width='$width'" }
+ if ($list) { "list='$list'" }
+ if ($multiple) { "multiple" }
+ if ($size) { "size='$size'" }
+ if ($accept) { "accept='$accept'" }
+ if ($acceptCharset) { "accept-charset='$acceptCharset'" }
+ if ($autoFocus) { "autofocus" }
+ ) -join ' '
+
+
+ @(
+ if ($Label -and $ID) {
+ if ($label -notmatch '"
+ ) -join [Environment]::newLine
+ }
+
+}
+
diff --git a/Languages/HTML/Templates/Input/HTML-Template-Parameter-Input.ps.ps1 b/Languages/HTML/Templates/Input/HTML-Template-Parameter-Input.ps.ps1
new file mode 100644
index 000000000..d0b7da8fa
--- /dev/null
+++ b/Languages/HTML/Templates/Input/HTML-Template-Parameter-Input.ps.ps1
@@ -0,0 +1,165 @@
+Template function HTML.Parameter.Input {
+ <#
+ .SYNOPSIS
+ Generates an HTML parameter input.
+ .DESCRIPTION
+ Generates an HTML input element for a parameter.
+ #>
+ [CmdletBinding(DefaultParameterSetName='None')]
+ param(
+ # The Parameter Metadata. This can be provided via the pipeline from the Parameter.Values of any command.
+ [vfp(Mandatory,ParameterSetName='ParameterMetadata')]
+ [Management.Automation.ParameterMetaData]
+ $ParameterMetadata,
+
+ # The name of the command.
+ [vbn()]
+ [string]
+ $CommandName,
+
+ # The name of the parameter.
+ [vbn()]
+ [string]
+ $ParameterName,
+
+ # The parameter attributes
+ [vbn()]
+ [Alias('Attribute','Attributes')]
+ [PSObject[]]
+ $ParameterAttribute,
+
+ # The parameter type
+ [vbn()]
+ [type]
+ $ParameterType,
+
+ # The parameter help.
+ [vbn()]
+ [string]
+ $ParameterHelp,
+
+ # If set, the automatic parameters will be included.
+ # (by default, they will be hidden)
+ [vbn()]
+ [Alias('IncludeAutomaticParameters')]
+ [switch]
+ $IncludeAutomaticParameter
+ )
+
+ process {
+
+ if ($PSCmdlet.ParameterSetName -eq 'ParameterMetadata') {
+ $ParameterName = $ParameterMetadata.Name
+ $ParameterType = $ParameterMetadata.ParameterType
+ $Alias = $ParameterMetadata.Aliases
+ $ParameterAttribute = $ParameterMetadata.Attributes
+ }
+
+ if (-not $IncludeAutomaticParameter) {
+ if ($ParameterName -in 'Verbose','Debug',
+ 'ErrorAction','ErrorVariable',
+ 'WarningAction','WarningVariable',
+ 'InformationAction','InformationVariable',
+ 'ProgressAction',
+ 'Confirm','WhatIf',
+ 'OutBuffer','OutVariable',
+ 'PipelineVariable'
+ ) {
+ return
+ }
+ }
+
+ $htmlInputParameters = [Ordered]@{
+ Name = $ParameterName
+ }
+
+ if ($CommandName) {
+ $htmlInputParameters.id = "$CommandName-$ParameterName" -replace '\p{P}', '-' -replace "\s", '_'
+ } else {
+ $htmlInputParameters.id = $ParameterName -replace '\p{P}', '-' -replace "\s", '_'
+ }
+
+ $validValuesList = @()
+
+ :PickingInputType switch ($ParameterType) {
+ { $_ -in [int], [double] } {
+ $htmlInputParameters.type = 'number'
+ break
+ }
+ { $_ -eq [DateTime]} {
+ $htmlInputParameters.type = 'datetime-local'
+ break
+ }
+ { $_ -eq [bool] -or $_ -eq [switch]} {
+ $htmlInputParameters.type = 'checkbox'
+ break
+ }
+ { $_.IsSubclassOf([Enum]) } {
+ $validValuesList += [Enum]::GetNames($ParameterType)
+ }
+ { $_ -eq [IO.FileInfo]} {
+ $htmlInputParameters.type = 'file'
+ break
+ }
+ default {
+ switch -regex ($ParameterName) {
+ 'Colou?r' {
+ $htmlInputParameters.type = 'color'
+ break PickingInputType
+ }
+ 'Email' {
+ $htmlInputParameters.type = 'email'
+ break PickingInputType
+
+ }
+ }
+ $htmlInputParameters.type = 'text'
+ }
+ }
+
+
+
+
+ foreach ($attribute in $ParameterAttribute) {
+ switch ($attribute) {
+ [ValidateRange] {
+ $htmlInputParameters.min = $attribute.Minimum
+ $htmlInputParameters.max = $attribute.Maximum
+ }
+ [ValidatePattern] {
+ $htmlInputParameters.pattern = $attribute.RegexPattern
+ }
+ [ValidateSet] {
+ $validValuesList += $attribute.ValidValues
+ }
+ [Management.Automation.HiddenAttribute] {
+ # If the parameter is hidden, do not show it.
+ return
+ }
+ [Reflection.AssemblyMetadataAttribute] {
+ if ($attribute.Key -match 'Html\.?InputType') {
+ $htmlInputParameters.type = $attribute.Value
+ }
+ elseif ($attribute.Key -eq 'HTML.Input' -or 'Input.HTML') {
+ return $attribute.Value
+ }
+ }
+ }
+ }
+
+
+ if ($validValuesList) {
+ @(
+ ""
+ ""
+ ) -join [Environment]::newLine
+ } else {
+ $htmlInputParameters.Label = $ParameterName
+ Template.HTML.InputElement @htmlInputParameters
+ }
+ }
+}
diff --git a/Languages/HTML/Templates/Input/HTML-Template-Parameter-Input.ps1 b/Languages/HTML/Templates/Input/HTML-Template-Parameter-Input.ps1
new file mode 100644
index 000000000..d0db5e75d
--- /dev/null
+++ b/Languages/HTML/Templates/Input/HTML-Template-Parameter-Input.ps1
@@ -0,0 +1,175 @@
+
+function Template.HTML.Parameter.Input {
+
+ <#
+ .SYNOPSIS
+ Generates an HTML parameter input.
+ .DESCRIPTION
+ Generates an HTML input element for a parameter.
+ #>
+ [CmdletBinding(DefaultParameterSetName='None')]
+ param(
+ # The Parameter Metadata. This can be provided via the pipeline from the Parameter.Values of any command.
+ [Parameter(Mandatory,ParameterSetName='ParameterMetadata',ValueFromPipeline)]
+ [Management.Automation.ParameterMetaData]
+ $ParameterMetadata,
+
+ # The name of the command.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $CommandName,
+
+ # The name of the parameter.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $ParameterName,
+
+ # The parameter attributes
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('Attribute','Attributes')]
+ [PSObject[]]
+ $ParameterAttribute,
+
+ # The parameter type
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [type]
+ $ParameterType,
+
+ # The parameter help.
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [string]
+ $ParameterHelp,
+
+ # If set, the automatic parameters will be included.
+ # (by default, they will be hidden)
+ [Parameter(ValueFromPipelineByPropertyName)]
+ [Alias('IncludeAutomaticParameters')]
+ [switch]
+ $IncludeAutomaticParameter
+ )
+
+ process {
+
+ if ($PSCmdlet.ParameterSetName -eq 'ParameterMetadata') {
+ $ParameterName = $ParameterMetadata.Name
+ $ParameterType = $ParameterMetadata.ParameterType
+ $Alias = $ParameterMetadata.Aliases
+ $ParameterAttribute = $ParameterMetadata.Attributes
+ }
+
+ if (-not $IncludeAutomaticParameter) {
+ if ($ParameterName -in 'Verbose','Debug',
+ 'ErrorAction','ErrorVariable',
+ 'WarningAction','WarningVariable',
+ 'InformationAction','InformationVariable',
+ 'ProgressAction',
+ 'Confirm','WhatIf',
+ 'OutBuffer','OutVariable',
+ 'PipelineVariable'
+ ) {
+ return
+ }
+ }
+
+ $htmlInputParameters = [Ordered]@{
+ Name = $ParameterName
+ }
+
+ if ($CommandName) {
+ $htmlInputParameters.id = "$CommandName-$ParameterName" -replace '\p{P}', '-' -replace "\s", '_'
+ } else {
+ $htmlInputParameters.id = $ParameterName -replace '\p{P}', '-' -replace "\s", '_'
+ }
+
+ $validValuesList = @()
+
+ :PickingInputType switch ($ParameterType) {
+ { $_ -in [int], [double] } {
+ $htmlInputParameters.type = 'number'
+ break
+ }
+ { $_ -eq [DateTime]} {
+ $htmlInputParameters.type = 'datetime-local'
+ break
+ }
+ { $_ -eq [bool] -or $_ -eq [switch]} {
+ $htmlInputParameters.type = 'checkbox'
+ break
+ }
+ { $_.IsSubclassOf([Enum]) } {
+ $validValuesList += [Enum]::GetNames($ParameterType)
+ }
+ { $_ -eq [IO.FileInfo]} {
+ $htmlInputParameters.type = 'file'
+ break
+ }
+ default {
+ switch -regex ($ParameterName) {
+ 'Colou?r' {
+ $htmlInputParameters.type = 'color'
+ break PickingInputType
+ }
+ 'Email' {
+ $htmlInputParameters.type = 'email'
+ break PickingInputType
+
+ }
+ }
+ $htmlInputParameters.type = 'text'
+ }
+ }
+
+
+
+
+ foreach ($attribute in $ParameterAttribute) {
+ switch ($attribute) {
+ {$_ -is [ValidateRange]}
+ {
+ $htmlInputParameters.min = $attribute.Minimum
+ $htmlInputParameters.max = $attribute.Maximum
+ }
+ {$_ -is [ValidatePattern]}
+ {
+ $htmlInputParameters.pattern = $attribute.RegexPattern
+ }
+ {$_ -is [ValidateSet]}
+ {
+ $validValuesList += $attribute.ValidValues
+ }
+ {$_ -is [Management.Automation.HiddenAttribute]}
+ {
+ # If the parameter is hidden, do not show it.
+ return
+ }
+ {$_ -is [Reflection.AssemblyMetadataAttribute]}
+ {
+ if ($attribute.Key -match 'Html\.?InputType') {
+ $htmlInputParameters.type = $attribute.Value
+ }
+ elseif ($attribute.Key -eq 'HTML.Input' -or 'Input.HTML') {
+ return $attribute.Value
+ }
+ }
+ }
+ }
+
+
+ if ($validValuesList) {
+ @(
+ ""
+ ""
+ ) -join [Environment]::newLine
+ } else {
+ $htmlInputParameters.Label = $ParameterName
+ Template.HTML.InputElement @htmlInputParameters
+ }
+ }
+
+}
+
+
diff --git a/Languages/HTML/Templates/Layout/HTML-Default-Layout.ps.ps1 b/Languages/HTML/Templates/Layout/HTML-Default-Layout.ps.ps1
new file mode 100644
index 000000000..8d65572a0
--- /dev/null
+++ b/Languages/HTML/Templates/Layout/HTML-Default-Layout.ps.ps1
@@ -0,0 +1,314 @@
+[ValidatePattern('HTML')]
+param()
+
+Template function HTML.Default.Layout {
+ <#
+ .SYNOPSIS
+ The default HTML layout.
+ .DESCRIPTION
+ The template for a default HTML layout.
+
+ This generates a single HTML page with the provided content and metadata.
+
+ HTML.Default.Layout -Name 'My Page' -Content 'This is my page'
+ #>
+ [CmdletBinding(PositionalBinding=$false)]
+ [Alias('New-WebPage','Template.default.html')]
+ param(
+ # The name of the page. This will set the title tag.
+ [vbn(Position=0)]
+ [Alias('Title','DisplayName')]
+ [string]
+ $Name,
+
+ # The content of the page. This is the body of the page.
+ [vbn(Position=1)]
+ [Alias('PageContent','Body')]
+ [psobject]
+ $Content,
+
+ # The separator. This will be placed between multiple content items, if `-Content` is an array.
+ # By default, this is a line break.
+ [vbn()]
+ [psobject]
+ $Separator = "
",
+
+ # The name of the site. If set, it will include the og:site_name meta tag.
+ [vbn()]
+ [Alias('SiteTitle','WebsiteName')]
+ [string]
+ $SiteName,
+
+ # The page type. By default 'website'.
+ # This sets the og:type meta tag.
+ # Cannonically, this can be set to 'article', 'book', 'profile', 'video', 'music', 'movie', 'restaurant', 'product', 'place', 'game', 'app', 'event', or 'author'.
+ [vbn()]
+ [string]
+ $PageType = 'website',
+
+ # The description of the page. If set, it will include the og:description meta tag.
+ [vbn()]
+ [Alias('Desc')]
+ [string]
+ $Description,
+
+ # One or more stylesheets. If this ends in .CSS, it will be included as a link tag. Otherwise, it will be included as a style tag.
+ [vbn()]
+ [Alias('CSS')]
+ [psobject[]]
+ $StyleSheet,
+
+ # One or more RSS feeds to include in the page. If set, it will automatically include the link tag.
+ [vbn()]
+ [Alias('Feed','Feeds','RSSFeed','RSSUrl')]
+ [PSObject]
+ $RSS,
+
+ # One or more Atom feeds to include in the page. If set, it will automatically include the link tag.
+ [vbn()]
+ [Alias('AtomFeed','AtomUrl')]
+ [PSObject]
+ $Atom,
+
+ # Any JavaScripts to include in the page. If set, it will include the script tag.
+ [vbn()]
+ [Alias('JavaScripts','JS')]
+ [psobject[]]
+ $JavaScript,
+
+ # The name of the palette to use. If set, it will include the 4bitcss link tag.
+ # This is a CSS file that sets the foreground and background colors.
+ # If palette contains slashes, it will be presumed to be an external palette file.
+ # This palette file _should_ follow the same conventions as those found in [4bitcss](https://4bitcss.com).
+ [vbn()]
+ [Alias('Palette','ColorScheme','ColorPalette')]
+ [string[]]
+ $PaletteName,
+
+ # One or more google fonts to include
+ [vbn()]
+ [string[]]
+ $GoogleFont,
+
+ # The absolute path to the page. If set, it will include the og:url meta tag.
+ [vbn()]
+ [Alias('FullUrl','AbsoluteUrl','AbsoluteUri','Permalink','PermaLinkUrl','PermalinkUri')]
+ [uri]
+ $AbsolutePath,
+
+ # The image to use for the page. If set, it will include the og:image meta tag.
+ [vbn()]
+ [uri]
+ $Image,
+
+ # The language of the page. If set, it will include the lang attribute.
+ [vbn()]
+ [cultureinfo]
+ $Language = [cultureinfo]::CurrentUICulture,
+
+ # The date the page was published. If set, it will include the article:published_time meta tag.
+ [vbn()]
+ [Alias('PublishDate','Date')]
+ [DateTime]
+ $PublishTime,
+
+ # The analytics ID. If set, it will include the Google Analytics tag.
+ [vbn()]
+ [string]
+ $AnalyticsID,
+
+ # The viewport. By default, it is set to 'width=device-width'.
+ [vbn()]
+ [string]
+ $Viewport = 'width=device-width',
+
+ # The width of the page. By default, it is set to '100%'.
+ [vbn()]
+ [string]
+ $Width = '100%',
+
+ # The height of the page. By default, it is set to '100%'.
+ [vbn()]
+ [string]
+ $Height = '100%',
+
+ # The font size of the page. By default, it is set to '1.5em'.
+ [vbn()]
+ [string]
+ $FontSize = '1.5em',
+
+ # The font family of the page.
+ # If a -GoogleFont has been provided, this will default to the first value.
+ [vbn()]
+ [string]
+ $FontFamily,
+
+ # The page margin. By default, nothing.
+ [vbn()]
+ [string]
+ $Margin,
+
+ # The page padding. By default, nothing.
+ [vbn()]
+ [string]
+ $Padding,
+
+ # Any additional header information for the page
+ [vbn()]
+ [Alias('PageHeader')]
+ [string]
+ $Head,
+
+ # One or more CSS classes to apply to the body.
+ [vbn()]
+ [Alias('CssClass')]
+ [string[]]
+ $Class
+ )
+
+ begin {
+ filter Escape { [Security.SecurityElement]::Escape($_) }
+ filter EscapeAttribute { [Web.HttpUtility]::HtmlAttributeEncode($_) }
+
+ filter ToFeed {
+ param([string]$FeedType)
+ if ($_ -is [string] -or $_ -is [uri]) {
+ ""
+ } else {
+ if ($_ -is [Collections.IDictionary]) {
+ $_ = [PSCustomObject]$_
+ }
+ $_ | . {
+ param(
+ [vbn()][Alias('Title','DisplayName','FeedName','Name')][string]$FeedTitle,
+ [vbn()][Alias('Url','Link','Feed','FeedUri')][uri]$FeedUrl
+ )
+ if (-not $FeedTitle) { $FeedTitle = $(@($FeedType -split '[\p{P}\+]')[1]) }
+ ""
+ }
+ }
+ }
+ }
+
+
+ process {
+ $safeTitle = $Name | Escape
+
+ $headerTags = @(
+ "$SafeTitle"
+ ""
+ if ($SiteName) {
+ ""
+ }
+ if ($SafeTitle) { "" }
+ if ($PageType) { "" }
+ if ($Description) {
+ ""
+ ""
+ ""
+ }
+ if ($PublishTime) { "" }
+ if ($AbsolutePath) {
+ ""
+ ""
+ if ($AbsolutePath.DnsSafeHost) {
+ ""
+ }
+ }
+ if ($Image) {
+ ""
+ ""
+ ""
+ }
+
+ if ($AnalyticsID) {
+ ""
+ ''
+ ""
+ }
+ if ($GoogleFont) {
+ ""
+ if (-not $PSBoundParameters['FontFamily']) { $FontFamily = $GoogleFont[0] }
+ }
+ if ($PaletteName) {
+ foreach ($NameOfPalette in $PaletteName) {
+ if ($PaletteName -match '[\\/]') {
+ ""
+ } else {
+ $MachineFriendlyName = $NameOfPalette -replace '\s','-' -replace '\p{P}','-' -replace '-+','-' -replace '-$'
+ ""
+ }
+
+ }
+ $Class += "foreground", "background"
+ }
+
+ if ($RSS) {
+ $RSS | ToFeed -FeedType 'application/rss+xml'
+ }
+
+ if ($Atom) {
+ $Atom | ToFeed -FeedType 'application/atom+xml'
+ }
+
+ foreach ($css in $StyleSheet) {
+ if ($css -match '\.css$') {
+ ""
+ } else {
+ ""
+ }
+ }
+
+ $defaultBodyStyle = @(
+ if ($Width) { "width: $Width" }
+ if ($Height) { "height: $Height" }
+ if ($FontSize) { "font-size: $FontSize" }
+ if ($FontFamily) { "font-family: $FontFamily" }
+ if ($Margin) { "margin: $Margin" }
+ if ($Padding) { "padding: $Padding" }
+ ) -join ';'
+
+ if ($defaultBodyStyle) {
+ ""
+ }
+
+ foreach ($js in $JavaScript) {
+ if ($js -notmatch '\n' -and $js -match '\.js$') {
+ ""
+ }
+ elseif ($js -notmatch '^\s{0,}$js"
+ }
+ else {
+ $js
+ }
+ }
+
+ if ($Head) {
+ $Head
+ }
+ ) -join ([Environment]::newLine + (' ' * 4))
+
+
+@"
+
+
+
+ $headerTags
+
+
+$(
+ if ($content) {
+ if ($content -is [Collections.IList]) {
+ $content -join $Separator
+ } else {
+ $content
+ }
+ }
+)
+
+