Changelog

    • 100% test coverage / all functionality verified in detail.

    • Full support for any file format that Typescript supports including React. You may now leverage esm-d-ts to create bundled declarations for Typescript source code.

    • esm-d-ts 0.3.0 supports Typescript 5.5 - 5.9.x. A forthcoming 0.4.0 release will support Typescript 6.x.

    • Added plugin support for alternate file formats that support ES Modules. The first plugin available adds support for Svelte 4 components (.svelte files). For more information on Svelte component support please see: @typhonjs-build-test/esm-d-ts-plugin-svelte. Eventually, additional 1st party support may be added for alternate file formats / frameworks that can be transpiled to ESM. Presently, 1st party plugins simply need to be installed as additional developer dependencies and load automatically. You may also provide custom 3rd party plugins via new plugins configuration option.

    • Added bundleDTS convenience function and new bundle command from the CLI which allows easy bundling of existing well formatted module based Typescript declarations.

    • Added emitCTS option to output additional '.d.cts' file for strict Typescript adherence for packages that are dual ESM / CJS. When referencing require as an export condition in an dual ESM / CJS package the types referenced must be .d.cts for the require condition for strict Typescript adherence.

    • Added importsLocal support from @typhonjs-build-test/rollup-plugin-pkg-imports allowing #import sub-paths to be replaced / remapped to actual sub-path package paths.

    • Added a TS AST transformer to support import types in @implements JSDoc tags. This allows you to reference an interface from a class and have it properly converted to implements <INTERFACE> in the declarations generated.
    • Added transformer "meta-transformer" to reduce the boilerplate of creating custom TS AST transformers.
    • Added a new internal AST transformer that corrects the output of the TS compiler for setter accessor parameter names. The TS compiler for ESM will rename setter accessor parameter names to arg regardless of the value set in the source file. If there is a JSDoc comment associated with a setter the first @param tag name will be set to the AST node param name. Downstream tooling such as TypeDoc 0.25.7+ validates comment / @param name against the type declaration name; this change fixes that mismatch.

    • Added @module / @packageDocumentation comment pass-through to generated DTS when this comment type appears in the main entry point source file. This is helpful when generating docs from the DTS file.

    • Introduces optional postprocessing of the generated bundled Typescript declaration.

      • First post processor is for @inheritDoc support.

    • Added outputPostprocess configuration option to separately output postprocessing to an alternate filepath for easier debugging / comparison.

    • Support for .mjs source files.
      • Caveat: when using import types you must specify the .mjs extension like: @param {import('./AFile.mjs').ASymbol}
    • Initial beta release

    Settings

    Member Visibility

    On This Page

    Changelog