npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

eslint-typegen

v0.3.2

Published

Generate types from ESLint rule schemas automatically, with auto-completion and type-checking for rule options.

Downloads

500,121

Readme

eslint-typegen

npm version npm downloads bundle JSDocs License

Generate types from ESLint rule schemas automatically, with auto-completion and type-checking for rule options.

Btw, if you are using @antfu/eslint-config, you may NOT need to setup this, as the types for rules are already shipped with the package.

Usage

npm i eslint-typegen

In your eslint.config.mjs, wrap the export with typegen function:

// @ts-check
/// <reference path="./eslint-typegen.d.ts" />
import typegen from 'eslint-typegen'

export default typegen(
  [
    // ...your normal eslint flat config
  ]
)

Run ESLint once, an eslint-typegen.d.ts file will be generated to augment ESLint's Linter.RulesRecord types, to provide you with auto-completion and type-checking for your ESLint rules configuration based on the ESLint plugins you are using.

It will caluclate the hash of the plugins meta from your flat config, and only regenerate the types when they changes. If you want to force regenerate the types, you can delete the eslint-typegen.d.ts file and run ESLint again.

Low-level API

You can find low-level APIs in the eslint-typegen/core modules.

import fs from 'node:fs/promises'
import pluginTs from '@typescript-eslint/eslint-plugin'
import pluginN from 'eslint-plugin-n'
import { pluginsToRulesDTS } from 'eslint-typegen/core'

const dts = await pluginsToRulesDTS({
  '@typescript-eslint': pluginTs,
  'n': pluginN,
})

await fs.writeFile('eslint-typegen.d.ts', dts)

This can be useful if you want to have more control over the generation process, or even bundle the types with your config package. For example, here is how @antfu/eslint-config does.

How it works

Thanks to that ESLint requires rules to provide the JSONSchema for options, we could leverage that to generate types with json-schema-to-typescript. With the new flat config allowing you to execute the code with fully resolved configs, we managed to sneak in the type generation process on the fly.

Credits

The initial idea comes from @Shinigami92 via his work on eslint-define-config, thanks to him!

Sponsors

License

MIT License © 2023-PRESENT Anthony Fu