Auto set TypeScript HTMLElementTagNameMap for lit-element
Last updated 5 months ago by mgenware .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install auto-lit-tag-name-map 
SYNC missed versions from official npm registry.


MEAN Module Build Status npm version Node.js Version

Auto set TypeScript HTMLElementTagNameMap for lit-element.


auto-lit-tag-name-map has two modes:

Default mode

  • Pros:
    • Uses TypeScript AST to parse and write source code. Can handle all edge cases (e.g. declare global not declared, HTMLElementTagNameMap not declared, HTMLElementTagNameMap declared but does not contain the right custom element tags, etc).
  • Cons:
    • TypeScript compiler emit API does not preserve empty lines between classes or functions. issue.
    • Prettier does not add lines if they were removed. issue.

Safe mode

  • Pros:
    • To address the issue above, safe mode only uses TypeScript AST to analyze files, once it encounters an edge case mentioned above, it simply ignores the target file. Therefore, it can only handle one situation where there is no declare global declared in target file. In this case, it constructs a declare global block with HTMLElementTagNameMap inside and appends the block of code to the end of the target file.
  • Cons:
    • Cannot handle edge cases mentioned above.


In both modes, auto-lit-tag-name-map will avoid rewriting files that look good. It's also recommended to use prettier (pass a prettier config file path via --prettier CLI option) to format rewritten files.


  $ npx auto-lit-tag-name-map@1 "<glob>" [options]

  <glob> Glob search patterns (always quote the glob to avoid misinterpretation by the shell).

  --prettier   Prettier config file used to format the files to be rewritten.
  --dry-run    Do not rewrite any file, but show a list of files to be rewritten.
  --safe-mode  Enable safe mode, see repo for details.

  $ npx auto-lit-tag-name-map@1 "./src/components/**/*.ts" --safe-mode --prettier ./.prettierrc.js

Current Tags

  • 1.1.1                                ...           latest (5 months ago)

6 Versions

  • 1.1.1                                ...           5 months ago
  • 1.1.0                                ...           5 months ago
  • 1.0.2                                ...           5 months ago
  • 1.0.1                                ...           5 months ago
  • 1.0.0                                ...           5 months ago
  • 0.0.1                                ...           5 months ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (6)
Dev Dependencies (11)
Dependents (0)

Copyright 2014 - 2016 © |