cancel
Showing results for 
Search instead for 
Did you mean: 
Reply
TedPattison
Microsoft
Microsoft

Using typing utility versus npm install @types

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.

  1. Has anyone else tried moving away from the typings utility?
  2. Does anyone see any potential problems with me using (and telling others to use) the npm install @types approach instead of using the typings utility?

Thanks for any feedback you can provide.

 

Ted

1 ACCEPTED SOLUTION
v-viig
Community Champion
Community Champion

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

pbicvsupport@microsoft.com

View solution in original post

1 REPLY 1
v-viig
Community Champion
Community Champion

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

pbicvsupport@microsoft.com

View solution in original post

Helpful resources

Announcements
PBI User Groups

Welcome to the User Group Public Preview

Check out new user group experience and if you are a leader please create your group

March Update

Check it Out!

Click here to read more about the March 2021 Updates!

secondImage

The largest Power BI virtual conference

100+ sessions, 100+ speakers, Product managers, MVPs, and experts. All about Power BI. Attend online or watch the recordings.

secondImage

Experience what’s next for Power BI

See the latest Power BI innovations, updates, and demos from the Microsoft Business Applications Launch Event.

Top Solution Authors
Top Kudoed Authors