Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

typedoc-plugin-custom-validation

RebeccaStevens1.2kBSD-3-Clause2.0.2

typedoc-plugin

readme

typedoc-plugin-custom-validation

npm version CI Coverage Status\ code style: prettier GitHub Discussions BSD 3 Clause license Commitizen friendly semantic-release

Any donations would be much appreciated. 😄

Installation

# Install with npm
npm install -D typedoc-plugin-custom-validation

# Install with pnpm
pnpm add -D typedoc-plugin-custom-validation

# Install with yarn
yarn add -D typedoc-plugin-custom-validation

Usage

All options are configured in the customValidation option.

byKind

This option is for specifying requirements for each kind of node.

Example: Require all functions to have a summary and have an @example tag.

{
  "plugin": ["typedoc-plugin-custom-validation"],
  "customValidation": {
    "byKind": [
      {
        "kinds": "Function",
        "summary": true,
        "tags": ["example"]
      }
    ]
  }
}

My Tags Don't Exists?

Due to the way typedoc works, some tags may be move to other nodes than the one they were defined on.

For example, @param tags are removed from the Function node they are defined on and its content is put onto the corresponding Parameter node. You can require parameters to be documented with:

{
  "plugin": ["typedoc-plugin-custom-validation"],
  "customValidation": {
    "byKind": [
      {
        "kinds": "Parameter",
        "summary": true
      }
    ]
  }
}

changelog

Changelog

All notable changes to this project will be documented in this file. Dates are displayed in UTC.

2.0.2 (2024-11-13)

Bug Fixes

  • remove warning when there is no docs (5d47f7b)

2.0.1 (2024-11-13)

Bug Fixes

2.0.0 (2024-11-13)

Features

  • update for newer typedoc version (111b1eb)

BREAKING CHANGES

  • update for newer typedoc version

1.1.1 (2023-03-11)

Bug Fixes

1.1.0 (2023-03-06)

Features

  • add ability to specify what type of a kind should be tested (#2) (dc06331)

1.0.0 (2023-03-02)

Features