TALXIS.DevKit.Build.Dataverse.ScriptLibrary 1.5.0

TALXIS.DevKit.Build.Dataverse.ScriptLibrary

MSBuild integration for Dataverse web resource (JavaScript/TypeScript) projects. Automatically runs npm install and npm run build when a TypeScript project is detected, copies the compiled JS output to the build output directory, and exposes metadata targets that allow Solution projects to discover and integrate script libraries as web resources.

Installation

<PackageReference Include="TALXIS.DevKit.Build.Dataverse.ScriptLibrary" Version="0.0.0.1" PrivateAssets="All" />

Or use the SDK approach:

<Project Sdk="TALXIS.DevKit.Build.Sdk/0.0.0.1">
  <PropertyGroup>
    <ProjectType>ScriptLibrary</ProjectType>
  </PropertyGroup>
</Project>

Prerequisites

When RunNodeBuild is true (auto-detected from the presence of package.json in TypeScriptDir):

• Node.js must be available on PATH
• npm must be available on PATH

The build will fail with a descriptive error if either is missing.

How It Works

The package sets ProjectType to ScriptLibrary and disables GenerateAssemblyInfo by default since this is not a traditional .NET assembly project.

Build-time targets

1. CheckScriptLibraryPrereqs -- validates that TypeScriptDir exists, package.json is present, and node/npm are on PATH.
2. BuildTypeScript (runs before Build) -- executes npm install followed by npm run build in TypeScriptDir.
3. CopyScriptLibraryMainToOutput (runs after Build) -- copies the main JS file from TypeScriptDir\build\ to the output directory.

Integration targets

Called by TALXIS.DevKit.Build.Dataverse.Solution via ProjectReference:

• GetProjectType -- returns ScriptLibrary.
• GetScriptLibraryOutputs -- exposes the compiled JS file path for the solution to copy into WebResources/.
• GetSuppressedScriptLibraryReferences -- returns the absolute paths of <ProjectReference> entries marked CompileOnly. Solution uses this to remove those projects from the standalone deployment list (so they don't land in the solution as their own web resources when the consumer only needs their types).

Cross-ScriptLibrary references

When one ScriptLibrary project references another, the relationship is controlled by the ScriptLibraryMode metadata on the <ProjectReference>:

<ItemGroup>
  <ProjectReference Include="..\Shared\Shared.csproj">
    <ScriptLibraryMode>CompileOnly</ScriptLibraryMode>
  </ProjectReference>
</ItemGroup>

CompileOnly removes the referenced project from the Solution's standalone-deployment list automatically.

MSBuild Properties

Related Packages

• Depends on: TALXIS.DevKit.Build.Dataverse.Tasks
• Consumed by: TALXIS.DevKit.Build.Dataverse.Solution projects via ProjectReference