Microsoft Fabric Community Conference 2025, March 31 - April 2, Las Vegas, Nevada. Use code MSCUST for a $150 discount.
Register nowThe Power BI DataViz World Championships are on! With four chances to enter, you could win a spot in the LIVE Grand Finale in Las Vegas. Show off your skills.
Hi all,
I just wanted to gather some feedback from the team and from any other devs who would like to respond. All the Microsoft documentation and samples about adding D3 typed definition files to a custom visual project use the typings utility. Here is what the instructions are on the Power BI Visuals repo in GitHub:
# First, install D3 v3.5.5 because Power BI does not yet support D3 v4
npm install d3@3.5.5 --save
# Next, install typings utility
npm install typings -g
# Next, install typings files for D3
typings install --save --global dt~d3 <- Error as it attempts install D3 v4 typings file
# In the GitHub issues list for the repo, I found that workaround that works
typings install --save --global dt~d3#0.0.0+20160907005744
While the typings utility works these days, looking forward it seems like this utility is being phased out in general node.js and npm development and developers are now standardizing on using the regular npm install command to install typed definition files from the Definitely Typed project.
Here the steps that I am using to create a new custom visual project with support for D3 programming.
pbiviz new barchart
cd barchart
npm install d3@3 --save
npm install @types/d3@3 --save
Once you have one that, modify the externalJS setting in pbiviz.json file
"externalJS": [
"node_modules/d3/d3.js"
]
Then update the files section of the tsconfig.json file.
"files": [
".api/v1.5.0/PowerBI-visuals.d.ts",
"src/visual.ts",
"node_modules/@types/d3/index.d.ts"
]
It use to take me a while to configure all this and now it takes less than a minute. I am able to also add any other JS library and the PowerBI utility libraries for things like formatting in the same fashion.
So here are my two questions for everyone.
Thanks for any feedback you can provide.
Ted
Solved! Go to Solution.
Hello @TedPattison,
Thanks for your feedback.
The powerbi-visuals-tools (PBIVIZ) <1.5.0 doesn't support @types packages due to using TypeScript 1.8.x.
We've have updated TypeScript version in PBIVIZ tools and it's 2.1.6 now.
In other words, there's no risk to use @types with the latest version of PBIVIZ tools.
We've already been using @types since PBIVIZ 1.5.0 release. We're going to update our documentation soon.
Ignat Vilesov,
Software Engineer
Microsoft Power BI Custom Visuals
Hello @TedPattison,
Thanks for your feedback.
The powerbi-visuals-tools (PBIVIZ) <1.5.0 doesn't support @types packages due to using TypeScript 1.8.x.
We've have updated TypeScript version in PBIVIZ tools and it's 2.1.6 now.
In other words, there's no risk to use @types with the latest version of PBIVIZ tools.
We've already been using @types since PBIVIZ 1.5.0 release. We're going to update our documentation soon.
Ignat Vilesov,
Software Engineer
Microsoft Power BI Custom Visuals