You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
In #55739 there was an addition to ts. createSourceFile which allowed to opt into parsing JSDocs, which until then had been opt-in by default. This API, however, was not added to the ts.transpileModule where the Azure SDK for JavaScript currently uses to create samples.
π Motivating Example
We currently use the TypeScript compiler to parse our TypeScript files to convert them to JavaScript such as the following:
Upgrading to 5.3 from 5.2 caused us to lose our JSDoc comments as opting into JSDoc parsing is hard coded in this case to not include them. The ideal solution would be to do the following to add the jsDocParsingMode to the TranspileOptions such as the tollowing:
What do you want to use this for? This is used as part of our workflow convert our existing samples from TypeScript to JavaScript and retain all of our JSDocs from TypeScript to apply to JavaScript.
What shortcomings exist with current approaches? With 5.3, we no longer have the ability to read these comments through the ts.transpileModule method as it is hard coded to ts.JSDocParsingMode.ParseNone
What workarounds are you using in the meantime? None as we cannot upgrade to TypeScript 5.3 unless this option is introduced.
The text was updated successfully, but these errors were encountered:
Note to maintainers: the thing that makes this relevant to ts.tranpileModule is the fact that custom transformers can be passed in, which see the parse tree. It was probably omitted from this API because the basic usage is just text in, text out.
Reading the above implies that the JSDoc was actually removed from the output JS code; my intention was that it was safe to pass ParseNone here because that would mean that we skipped actually parsing the nodes themselves and they'd just be regular comments that were output like non-jsdoc comments. Is that not the case? Or are you actually using transformers somehow in the above? (You didn't say one way or the other.)
The issue isn't about emit at all; Azure is doing some fancy stuff with reading JSDoc nodes in transformers. (This issue was filed at my request after offline discussion)
π Search Terms
transpileModule jsDocParsingMode
β Viability Checklist
β Suggestion
In #55739 there was an addition to
ts. createSourceFile
which allowed to opt into parsing JSDocs, which until then had been opt-in by default. This API, however, was not added to thets.transpileModule
where the Azure SDK for JavaScript currently uses to create samples.π Motivating Example
We currently use the TypeScript compiler to parse our TypeScript files to convert them to JavaScript such as the following:
Upgrading to 5.3 from 5.2 caused us to lose our JSDoc comments as opting into JSDoc parsing is hard coded in this case to not include them. The ideal solution would be to do the following to add the
jsDocParsingMode
to theTranspileOptions
such as the tollowing:π» Use Cases
ts.transpileModule
method as it is hard coded tots.JSDocParsingMode.ParseNone
The text was updated successfully, but these errors were encountered: