@kazupon/eslint-config 0.32.0 → 0.33.0

package/dist/index.d.ts

@@ -8,17 +8,36 @@ import { StylisticCustomizeOptions } from "@stylistic/eslint-plugin";
 
 /**
 * define eslint configurations
+*
 * @param {Awaitable<Linter.Config | Linter.Config[]>[]} configs eslint flat configurations
 * @returns {FlatConfigComposer} eslint flat configuration composer
 */
 declare function defineConfig(...configs: Awaitable<Linter.Config | Linter.Config[]>[]): FlatConfigComposer;
 //#endregion
 //#region src/types/overrides.d.ts
+/**
+* Overrides configuration options
+*/
 interface OverridesOptions<Rules = Linter.Config["rules"]> {
+  /**
+  * Override files
+  */
   files?: Linter.Config["files"];
+  /**
+  * Override ignores
+  */
   ignores?: Linter.Config["ignores"];
+  /**
+  * Override rules
+  */
   rules?: Rules;
+  /**
+  * Override parser options
+  */
   parserOptions?: ESLint.Environment["parserOptions"];
+  /**
+  * Override language options
+  */
   settings?: Linter.Config["settings"];
 }
 //#endregion
@@ -107,6 +126,7 @@ type KazuponNoTagComments = [] | [{
 // ----- @kazupon/prefer-scope-on-tag-comment -----
 type KazuponPreferScopeOnTagComment = [] | [{
   tags?: [string, ...(string)[]];
+  directives?: [string, ...(string)[]];
 }];
 //#endregion
 //#region src/types/gens/css.d.ts
@@ -2616,6 +2636,7 @@ type AccessorPairs = [] | [{
   getWithoutSet?: boolean;
   setWithoutGet?: boolean;
   enforceForClassMembers?: boolean;
+  enforceForTSTypes?: boolean;
 }];
 // ----- array-bracket-newline -----
 type ArrayBracketNewline = [] | [(("always" | "never" | "consistent") | {
@@ -2805,7 +2826,9 @@ type GetterReturn = [] | [{
   allowImplicit?: boolean;
 }];
 // ----- grouped-accessor-pairs -----
-type GroupedAccessorPairs = [] | [("anyOrder" | "getBeforeSet" | "setBeforeGet")];
+type GroupedAccessorPairs = [] | [("anyOrder" | "getBeforeSet" | "setBeforeGet")] | [("anyOrder" | "getBeforeSet" | "setBeforeGet"), {
+  enforceForTSTypes?: boolean;
+}];
 // ----- handle-callback-err -----
 type HandleCallbackErr = [] | [string];
 // ----- id-blacklist -----
@@ -3757,6 +3780,7 @@ type NoUnusedVars = [] | [(("all" | "local") | {
   caughtErrorsIgnorePattern?: string;
   destructuredArrayIgnorePattern?: string;
   ignoreClassWithStaticInitBlock?: boolean;
+  ignoreUsingDeclarations?: boolean;
   reportUsedIgnorePattern?: boolean;
 })];
 // ----- no-use-before-define -----
@@ -5406,7 +5430,7 @@ interface MarkdownRules {
   * Disallow data rows in a GitHub Flavored Markdown table from having more cells than the header row
   * @see https://github.com/eslint/markdown/blob/main/docs/rules/table-column-count.md
   */
-  "markdown/table-column-count"?: Linter.RuleEntry<[]>;
+  "markdown/table-column-count"?: Linter.RuleEntry<MarkdownTableColumnCount>;
 }
 /* ======= Declarations ======= */
 // ----- markdown/fenced-code-language -----
@@ -5446,6 +5470,10 @@ type MarkdownNoUnusedDefinitions = [] | [{
   allowDefinitions?: string[];
   allowFootnoteDefinitions?: string[];
 }];
+// ----- markdown/table-column-count -----
+type MarkdownTableColumnCount = [] | [{
+  checkMissingCells?: boolean;
+}];
 //#endregion
 //#region src/types/gens/prettier.d.ts
 /* eslint-disable */
@@ -15661,6 +15689,7 @@ interface CommentsOptions {
 /**
 * configure comments preset for the below plugins
 * - `@eslint-community/eslint-plugin-eslint-comments`
+*
 * @param {CommentsOptions} options {@link CommentsOptions | comments preset options}
 * @returns {Promise<Linter.Config[]>} resolved eslint flat configurations
 */
@@ -15673,12 +15702,14 @@ declare function comments(options?: CommentsOptions): Promise<Linter.Config[]>;
 interface CssOptions {
   /**
   * whether to enable strict mode
+  *
   * @see https://github.com/eslint/css?tab=readme-ov-file#tolerant-mode
   * @default false
   */
   tolerant?: boolean;
   /**
   * whether to enable custom syntax
+  *
   * @description if 'tailwind', it will enable [Tailwind Syntax](https://github.com/eslint/css?tab=readme-ov-file#configuring-tailwind-syntax), otherwise it will enable [custom syntax](https://github.com/eslint/css?tab=readme-ov-file#configuring-custom-syntax)
   * @default false
   */
@@ -15686,11 +15717,12 @@ interface CssOptions {
   * TODO: If this issue is resolved, we should define more strict types for customSyntax
   * https://github.com/eslint/css/issues/56
   */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- NOTE(kazupon): `customSyntax` can be any object
   customSyntax?: false | "tailwind" | Record<string, any>;
 }
 /**
 * `@eslint/css` and overrides configuration options
+*
 * @param {CssOptions & OverridesOptions} options
 *  eslint css configuration options
 * @returns {Promise<Linter.Config[]>}
@@ -15705,6 +15737,7 @@ declare function css(options?: CssOptions & OverridesOptions<CssRules>): Promise
 interface HtmlOptions {
   /**
   * whether to enable template engine syntax
+  *
   * @default undefined
   */
   templateEngineSyntax?: "erb" | "handlebar" | "twig" | {
@@ -15712,18 +15745,21 @@ interface HtmlOptions {
   };
   /**
   * whether to enable frontmatter in html files
+  *
   * @see https://html-eslint.org/docs/integrating-template-engine#skip-frontmatter
   * @default false
   */
   frontmatter?: boolean;
   /**
   * whether to disable stylistic rules for prettier, if set `true`
+  *
   * @default false
   */
   prettier?: boolean;
 }
 /**
 * `@html-eslint/eslint-plugin` and overrides configuration options
+*
 * @param {HtmlOptions & OverridesOptions} options eslint configuration options for HTML
 * @returns {Promise<Linter.Config[]>}
 * eslint flat configurations with `@html-eslint/eslint-plugin` and overrides
@@ -15737,17 +15773,20 @@ declare function html(options?: HtmlOptions & OverridesOptions<HtmlRules>): Prom
 interface ImportsOptions {
   /**
   * use typescript
+  *
   * @default false
   */
   typescript?: boolean;
   /**
   * use `eslint-plugin-module-interop`
+  *
   * @default true
   */
   interop?: boolean;
 }
 /**
 * `eslint-plugin-import-x`, `eslint-plugin-unused-imports` and overrides configuration options
+*
 * @description if you want to use this preset, you need to put after `javascript` and `typescript` presets**
 * @param {ImportsOptions & OverridesOptions} options
 *  import configuration options
@@ -15760,10 +15799,11 @@ declare function imports(options?: ImportsOptions & OverridesOptions<ImportsRule
 /**
 * JavaScript configuration options
 */
-// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type -- NOTE(kazupon): This is a placeholder for future options
 interface JavaScriptOptions {}
 /**
 * `@eslint/js` and overrides configuration options
+*
 * @param {JavaScriptOptions & OverridesOptions} options eslint configuration options for JavaScript
 * @returns {Promise<Linter.Config[]>} eslint flat configurations with `@eslint/js` and overrides
 */
@@ -15776,21 +15816,27 @@ declare function javascript(options?: JavaScriptOptions & OverridesOptions<Javas
 interface JsDocumentOptions {
   /**
   * If you want to use TypeScript, you need to set `syntax`, else if you want to use JavaScript and TypeScript flavor in comments, you need to set `flavor`.
+  *
   * @see https://github.com/gajus/eslint-plugin-jsdoc?tab=readme-ov-file#configuration
+  *
   * @default undefined
   */
   typescript?: "syntax" | "flavor";
   /**
   * If you wish to have all linting issues reported as failing errors, you can set this to `true`.
+  *
   * @see https://github.com/gajus/eslint-plugin-jsdoc?tab=readme-ov-file#configuration
+  *
   * @default false
   */
   error?: boolean;
 }
 /**
 * `eslint-plugin-jsdoc` and overrides configuration options
+*
 * @param {JsDocOptions & OverridesOptions} options
 * eslint configuration options for JavaScript
+*
 * @returns {Promise<Linter.Config[]>}
 * eslint flat configurations with `eslint-plugin-jsdoc` and overrides
 */
@@ -15803,24 +15849,28 @@ declare function jsdoc(options?: JsDocumentOptions & OverridesOptions<JsdocRules
 interface JsoncOptions {
   /**
   * whether to enable config `'flat/recommended-with-json'`of `eslint-plugin-jsonc`.
+  *
   * @see https://ota-meshi.github.io/eslint-plugin-jsonc/user-guide/#usage
   * @default false
   */
   json?: boolean;
   /**
   * whether to enable config `'flat/recommended-with-jsonc'`of `eslint-plugin-jsonc`.
+  *
   * @see https://ota-meshi.github.io/eslint-plugin-jsonc/user-guide/#usage
   * @default false
   */
   jsonc?: boolean;
   /**
   * whether to enable config `'flat/recommended-with-json5'`of `eslint-plugin-jsonc`.
+  *
   * @see https://ota-meshi.github.io/eslint-plugin-jsonc/user-guide/#usage
   * @default false
   */
   json5?: boolean;
   /**
   * whether to enable config `'flat/prettier'`of `eslint-plugin-jsonc`.
+  *
   * @see https://ota-meshi.github.io/eslint-plugin-jsonc/user-guide/#usage
   * @default false
   */
@@ -15828,6 +15878,7 @@ interface JsoncOptions {
 }
 /**
 * `eslint-plugin-jsonc` and overrides configuration options
+*
 * @param {JsoncOptions & OverridesOptions} options
 *  eslint jsonc configuration options for json, jsonc, json5
 * @returns {Promise<Linter.Config[]>}
@@ -15842,12 +15893,14 @@ declare function jsonc(options?: JsoncOptions & OverridesOptions<JsoncRules>): P
 interface MarkdownOptions {
   /**
   * makrdown language
+  *
   * @see https://github.com/eslint/markdown?tab=readme-ov-file#languages
   * @default 'gfm'
   */
   language?: "commonmark" | "gfm";
   /**
   * enable fenced code blocks
+  *
   * @see https://github.com/eslint/markdown/blob/main/docs/processors/markdown.md
   * @default true
   */
@@ -15879,6 +15932,7 @@ interface MarkdownOptions {
 // }
 /**
 * `@eslint/markdown` and overrides configuration options
+*
 * @param {MarkdownOptions & OverridesOptions} options
 *  eslint unicorn configuration options
 * @returns {Promise<Linter.Config[]>}
@@ -15892,10 +15946,11 @@ declare const md: typeof markdown;
 /**
 * Prettier configuration options
 */
-// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type -- NOTE(kazupon): This is a placeholder for future options
 interface PrettierOptions {}
 /**
 * `eslint-config-prettier` and overrides configuration options
+*
 * @param {PrettierOptions & OverridesOptions} options
 * eslint configuration options for Prettier
 * @returns {Promise<Linter.Config[]>}
@@ -15907,10 +15962,11 @@ declare function prettier(options?: PrettierOptions & OverridesOptions<PrettierR
 /**
 * eslint promise configuration options
 */
-// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type -- NOTE(kazupon): This is a placeholder for future options
 interface PromiseOptions {}
 /**
 * `eslint-plugin-promise` and overrides configuration options
+*
 * @param {PromiseOptions & OverridesOptions} options
 *  eslint promise configuration options
 * @returns {Promise<Linter.Config[]>}
@@ -15925,6 +15981,7 @@ declare function promise(options?: PromiseOptions & OverridesOptions<PromiseRule
 interface TypeScriptOptions {
   /**
   * Additional extensions for files.
+  *
   * @see https://typescript-eslint.io/packages/parser/#extrafileextensions
   */
   extraFileExtensions?: string[];
@@ -15933,7 +15990,10 @@ interface TypeScriptOptions {
   */
   parserOptions?: TypeScriptParserOptions;
 }
+/* eslint-disable jsdoc/require-jsdoc -- NOTE(kazupon): reference above URL */
 /**
+* TypeScript parser options
+*
 * @see https://typescript-eslint.io/packages/parser/#configuration
 */
 interface TypeScriptParserOptions {
@@ -15962,14 +16022,18 @@ interface TypeScriptParserOptions {
   warnOnUnsupportedTypeScriptVersion?: boolean;
 }
 /**
+* TypeScript project service options
+*
 * @see https://typescript-eslint.io/packages/parser/#projectservice
 */
 interface TypeScriptProjectServiceOptions {
   allowDefaultProject?: string[];
   defaultProject?: string;
 }
+/* eslint-enable jsdoc/require-jsdoc */
 /**
 * `typescript-eslint` and overrides configuration options
+*
 * @param {TypeScriptOptions & OverridesOptions} options
 * eslint configuration options for TypeScript
 * @returns {Promise<Linter.FlatConfig[]>}
@@ -15984,17 +16048,20 @@ declare function typescript(options?: TypeScriptOptions & OverridesOptions<Types
 interface ReactOptions {
   /**
   * use TypeScript
+  *
   * @default true
   */
   typescript?: boolean;
   /**
   * enable `eslint-plugin-react-refresh` recommended rules
+  *
   * @default false
   */
   refresh?: boolean;
 }
 /**
 * `eslint-plugin-react` and overrides configuration options
+*
 * @param {ReactOptions & OverridesOptions} options
 *  eslint react configuration options for regular expressions
 * @returns {Promise<Linter.Config[]>}
@@ -16006,10 +16073,11 @@ declare function react(options?: ReactOptions & TypeScriptOptions & OverridesOpt
 /**
 * eslint regexp configuration options
 */
-// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type -- NOTE(kazupon): This is a placeholder for future options
 interface RegexpOptions {}
 /**
 * `eslint-plugin-regexp` and overrides configuration options
+*
 * @param {RegexpOptions & OverridesOptions} options
 *  eslint regexp configuration options for regular expressions
 * @returns {Promise<Linter.Config[]>}
@@ -16024,12 +16092,14 @@ declare function regexp(options?: RegexpOptions & OverridesOptions<RegexpRules>)
 interface StylisticOptions {
   /**
   * stylistic customize options
+  *
   * @see https://eslint.style/guide/config-presets#configuration-factory
   */
   customize?: StylisticCustomizeOptions;
 }
 /**
 * `@stylistic/eslint-plugin` and overrides configuration options
+*
 * @param {StylisticOptions & OverridesOptions} options
 *  stylistic eslint plugin configuration options
 * @returns {Promise<Linter.Config[]>}
@@ -16044,17 +16114,20 @@ declare function stylistic(options?: StylisticOptions & OverridesOptions<Stylist
 interface SvelteScriptOptions {
   /**
   * use TypeScript in `template` block
+  *
   * @default false
   */
   typescript?: boolean;
   /**
   * `svelte.config.js` configuration
+  *
   * @default {}
   */
   svelteConfig?: Record<string, unknown>;
 }
 /**
 * `eslint-plugin-svelte` and overrides configuration options
+*
 * @param {SvelteScriptOptions & TypeScriptOptions & OverridesOptions} options
 * eslint configuration options for Vue
 * @returns {Promise<Linter.Config[]>}
@@ -16066,10 +16139,11 @@ declare function svelte(options?: SvelteScriptOptions & TypeScriptOptions & Over
 /**
 * eslint toml configuration options
 */
-// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type -- NOTE(kazupon): This is a placeholder for future options
 interface TomlOptions {}
 /**
 * `eslint-plugin-yml` and overrides configuration options
+*
 * @param {YmlOptions & OverridesOptions} options
 *  eslint yml configuration options for yml, yaml
 * @returns {Promise<Linter.Config[]>}
@@ -16084,12 +16158,14 @@ declare function toml(options?: TomlOptions & OverridesOptions<TomlRules>): Prom
 interface UnicornOptions {
   /**
   * use TypeScript
+  *
   * @default true
   */
   typescript?: boolean;
 }
 /**
 * `eslint-plugin-unicorn` and overrides configuration options
+*
 * @param {UnicornOptions & OverridesOptions} options
 *  eslint unicorn configuration options
 * @returns {Promise<Linter.Config[]>}
@@ -16104,6 +16180,7 @@ declare function unicorn(options?: UnicornOptions & OverridesOptions<UnicornRule
 interface VitestOptions {
   /**
   * use type testing
+  *
   * @description about type testing, see https://vitest.dev/guide/testing-types,
   * and about eslint config, see https://github.com/vitest-dev/eslint-plugin-vitest?tab=readme-ov-file#enabling-with-type-testing
   * @default false
@@ -16112,6 +16189,7 @@ interface VitestOptions {
 }
 /**
 * `@vitest/eslint-plugin` and overrides configuration options
+*
 * @param {VitestOptions & OverridesOptions} options
 *  eslint vitest configuration options
 * @returns {Promise<Linter.Config[]>}
@@ -16126,26 +16204,31 @@ declare function vitest(options?: VitestOptions & OverridesOptions<VitestRules>)
 interface VueScriptOptions {
   /**
   * use TypeScript in `template` block
+  *
   * @default false
   */
   typescript?: boolean;
   /**
   * enable `eslint-plugin-vue-composable` rules
+  *
   * @default false
   */
   composable?: boolean;
   /**
   * enable `eslint-plugin-vue-scoped-css` rules
+  *
   * @default false
   */
   scopedCss?: boolean;
   /**
   * enable `eslint-plugin-vue-eslint-plugin-vuejs-accessibility` rules
+  *
   * @default false
   */
   a11y?: boolean;
   /**
   * enable `@intlify/eslint-plugin-vue-i18n` rules
+  *
   * @default false
   */
   i18n?: VueI18nOptions;
@@ -16156,11 +16239,18 @@ interface VueScriptOptions {
 * see https://eslint-plugin-vue-i18n.intlify.dev/started.html#settings-vue-i18n
 */
 interface VueI18nOptions {
+  /**
+  * A directory path to the locale files
+  */
   localeDir?: string;
+  /**
+  * The version of the intlify message syntax to use
+  */
   messageSyntaxVersion?: string;
 }
 /**
 * `eslint-plugin-vue`, `eslint-plugin-vue-composable`, `eslint-plugin-vue-eslint-plugin-vuejs-accessibility` and overrides configuration options
+*
 * @param {VueScriptOptions & TypeScriptOptions & OverridesOptions} options
 * eslint configuration options for Vue
 * @returns {Promise<Linter.Config[]>}
@@ -16175,6 +16265,7 @@ declare function vue(options?: VueScriptOptions & TypeScriptOptions & OverridesO
 interface YmlOptions {
   /**
   * whether to enable config `'flat/prettier'`of `eslint-plugin-jsonc`.
+  *
   * @see https://ota-meshi.github.io/eslint-plugin-yml/user-guide/#configuration
   * @default false
   */
@@ -16182,6 +16273,7 @@ interface YmlOptions {
 }
 /**
 * `eslint-plugin-yml` and overrides configuration options
+*
 * @param {YmlOptions & OverridesOptions} options
 *  eslint yml configuration options for yml, yaml
 * @returns {Promise<Linter.Config[]>}

package/dist/index.js

@@ -7,6 +7,7 @@ import { mergeProcessors, processorPassThrough } from "eslint-merge-processors";
 //#region src/config.ts
 /**
 * define eslint configurations
+*
 * @param {Awaitable<Linter.Config | Linter.Config[]>[]} configs eslint flat configurations
 * @returns {FlatConfigComposer} eslint flat configuration composer
 */
@@ -58,6 +59,7 @@ const GLOB_TESTS_TYPE = [`**/*.test-d.${GLOB_SRC_EXT}`, `**/*.spec-d.${GLOB_SRC_
 //#region src/utils.ts
 /**
 * load eslint plugin
+*
 * @param {string} name plugin name
 * @returns {Promise<T>} loaded plugin
 */
@@ -70,7 +72,9 @@ async function loadPlugin(name) {
 }
 /**
 * get TypeScript parser
+*
 * @description get the parser, which is `typescript-eslint` parser
+*
 * @returns {Promise<typeof import('typescript-eslint')['parser']>} TypeScript parser
 */
 async function getTypeScriptParser() {
@@ -79,6 +83,7 @@ async function getTypeScriptParser() {
 }
 /**
 * get glob source files
+*
 * @param {boolean} useTypeScript use TypeScript, default `false`
 * @returns {string[]} files
 */
@@ -95,6 +100,7 @@ function getGlobSourceFiles(useTypeScript = false) {
 /**
 * configure comments preset for the below plugins
 * - `@eslint-community/eslint-plugin-eslint-comments`
+*
 * @param {CommentsOptions} options {@link CommentsOptions | comments preset options}
 * @returns {Promise<Linter.Config[]>} resolved eslint flat configurations
 */
@@ -109,7 +115,8 @@ async function comments(options = {}) {
 		plugins: { "@eslint-community/eslint-comments": comments$1 },
 		rules: {
 			...comments$1.configs.recommended.rules,
-			...directives.rules
+			...directives.rules,
+			"@eslint-community/eslint-comments/require-description": ["error", { ignore: ["eslint-enable"] }]
 		}
 	}, ...kazupon.configs.comment.map((config) => ({
 		...config,
@@ -125,6 +132,7 @@ async function comments(options = {}) {
 //#region src/configs/css.ts
 /**
 * `@eslint/css` and overrides configuration options
+*
 * @param {CssOptions & OverridesOptions} options
 *  eslint css configuration options
 * @returns {Promise<Linter.Config[]>}
@@ -160,6 +168,7 @@ async function css(options = {}) {
 //#region src/configs/html.ts
 /**
 * `@html-eslint/eslint-plugin` and overrides configuration options
+*
 * @param {HtmlOptions & OverridesOptions} options eslint configuration options for HTML
 * @returns {Promise<Linter.Config[]>}
 * eslint flat configurations with `@html-eslint/eslint-plugin` and overrides
@@ -205,6 +214,7 @@ async function html(options = {}) {
 }
 /**
 * Resolve template engine syntax for html-eslint parser
+*
 * @param {HtmlOptions['templateEngineSyntax']} syntax - template engine syntax
 * @param {typeof import('@html-eslint/eslint-plugin').configs['flat/recommended']['languageOptions']['parser']} parser - html-eslint parser
 * @returns {{ [syntax: string]: string } | undefined} resolved template engine syntax, or undefined if no syntax is provided
@@ -229,6 +239,7 @@ const IMPORTS_FILES = [
 ];
 /**
 * `eslint-plugin-import-x`, `eslint-plugin-unused-imports` and overrides configuration options
+*
 * @description if you want to use this preset, you need to put after `javascript` and `typescript` presets**
 * @param {ImportsOptions & OverridesOptions} options
 *  import configuration options
@@ -292,6 +303,7 @@ async function imports(options = {}) {
 //#region src/configs/javascript.ts
 /**
 * `@eslint/js` and overrides configuration options
+*
 * @param {JavaScriptOptions & OverridesOptions} options eslint configuration options for JavaScript
 * @returns {Promise<Linter.Config[]>} eslint flat configurations with `@eslint/js` and overrides
 */
@@ -330,8 +342,10 @@ async function javascript(options = {}) {
 //#region src/configs/jsdoc.ts
 /**
 * `eslint-plugin-jsdoc` and overrides configuration options
+*
 * @param {JsDocOptions & OverridesOptions} options
 * eslint configuration options for JavaScript
+*
 * @returns {Promise<Linter.Config[]>}
 * eslint flat configurations with `eslint-plugin-jsdoc` and overrides
 */
@@ -346,11 +360,54 @@ async function jsdoc(options = {}) {
 		return preset;
 	}
 	return [{
-		ignores: [GLOB_MARKDOWN],
+		files: [GLOB_SRC],
 		...jsdoc$1.configs[`flat/${resolvePreset()}`]
 	}, {
 		name: "@kazupon/jsdoc",
-		rules: { ...overrideRules }
+		files: [GLOB_SRC],
+		plugins: { jsdoc: jsdoc$1 },
+		rules: {
+			"jsdoc/require-jsdoc": ["error", {
+				publicOnly: true,
+				require: {
+					ArrowFunctionExpression: true,
+					ClassDeclaration: true,
+					ClassExpression: true,
+					FunctionDeclaration: true,
+					FunctionExpression: true,
+					MethodDefinition: true
+				},
+				contexts: [
+					"TSInterfaceDeclaration",
+					"TSTypeAliasDeclaration",
+					"TSPropertySignature",
+					"TSMethodSignature"
+				]
+			}],
+			"jsdoc/require-description": ["error", { contexts: [
+				"ArrowFunctionExpression",
+				"ClassDeclaration",
+				"ClassExpression",
+				"FunctionDeclaration",
+				"FunctionExpression",
+				"MethodDefinition",
+				"PropertyDefinition",
+				"VariableDeclaration",
+				"TSInterfaceDeclaration",
+				"TSTypeAliasDeclaration",
+				"TSPropertySignature",
+				"TSMethodSignature"
+			] }],
+			"jsdoc/tag-lines": [
+				"error",
+				"any",
+				{
+					startLines: 1,
+					applyToEndTag: false
+				}
+			],
+			...overrideRules
+		}
 	}];
 }
 
@@ -358,6 +415,7 @@ async function jsdoc(options = {}) {
 //#region src/configs/jsonc.ts
 /**
 * `eslint-plugin-jsonc` and overrides configuration options
+*
 * @param {JsoncOptions & OverridesOptions} options
 *  eslint jsonc configuration options for json, jsonc, json5
 * @returns {Promise<Linter.Config[]>}
@@ -403,6 +461,7 @@ async function jsonc(options = {}) {
 }
 /**
 * jsonc sort configurations
+*
 * @returns {Linter.Config[]} jsonc sort configurations
 */
 function jsoncSort() {
@@ -485,6 +544,7 @@ function jsoncSort() {
 //#region src/configs/markdown.ts
 /**
 * `@eslint/markdown` and overrides configuration options
+*
 * @param {MarkdownOptions & OverridesOptions} options
 *  eslint unicorn configuration options
 * @returns {Promise<Linter.Config[]>}
@@ -535,6 +595,7 @@ const md = markdown;
 //#region src/configs/prettier.ts
 /**
 * `eslint-config-prettier` and overrides configuration options
+*
 * @param {PrettierOptions & OverridesOptions} options
 * eslint configuration options for Prettier
 * @returns {Promise<Linter.Config[]>}
@@ -556,6 +617,7 @@ async function prettier(options = {}) {
 //#region src/configs/promise.ts
 /**
 * `eslint-plugin-promise` and overrides configuration options
+*
 * @param {PromiseOptions & OverridesOptions} options
 *  eslint promise configuration options
 * @returns {Promise<Linter.Config[]>}
@@ -577,6 +639,7 @@ async function promise(options = {}) {
 //#region src/configs/react.ts
 /**
 * `eslint-plugin-react` and overrides configuration options
+*
 * @param {ReactOptions & OverridesOptions} options
 *  eslint react configuration options for regular expressions
 * @returns {Promise<Linter.Config[]>}
@@ -625,6 +688,7 @@ async function react(options = {}) {
 //#region src/configs/regexp.ts
 /**
 * `eslint-plugin-regexp` and overrides configuration options
+*
 * @param {RegexpOptions & OverridesOptions} options
 *  eslint regexp configuration options for regular expressions
 * @returns {Promise<Linter.Config[]>}
@@ -647,6 +711,7 @@ async function regexp(options = {}) {
 //#region src/configs/stylistic.ts
 /**
 * `@stylistic/eslint-plugin` and overrides configuration options
+*
 * @param {StylisticOptions & OverridesOptions} options
 *  stylistic eslint plugin configuration options
 * @returns {Promise<Linter.Config[]>}
@@ -692,6 +757,7 @@ async function stylistic(options = {}) {
 //#region src/configs/svelte.ts
 /**
 * `eslint-plugin-svelte` and overrides configuration options
+*
 * @param {SvelteScriptOptions & TypeScriptOptions & OverridesOptions} options
 * eslint configuration options for Vue
 * @returns {Promise<Linter.Config[]>}
@@ -728,6 +794,7 @@ async function svelte(options = {}) {
 //#region src/configs/toml.ts
 /**
 * `eslint-plugin-yml` and overrides configuration options
+*
 * @param {YmlOptions & OverridesOptions} options
 *  eslint yml configuration options for yml, yaml
 * @returns {Promise<Linter.Config[]>}
@@ -758,6 +825,7 @@ async function toml(options = {}) {
 //#region src/configs/typescript.ts
 /**
 * `typescript-eslint` and overrides configuration options
+*
 * @param {TypeScriptOptions & OverridesOptions} options
 * eslint configuration options for TypeScript
 * @returns {Promise<Linter.FlatConfig[]>}
@@ -820,6 +888,13 @@ async function typescript(options = {}) {
 					varsIgnorePattern: "^_",
 					ignoreRestSiblings: true
 				}],
+				"@typescript-eslint/ban-ts-comment": ["error", {
+					minimumDescriptionLength: 10,
+					"ts-check": false,
+					"ts-expect-error": "allow-with-description",
+					"ts-ignore": "allow-with-description",
+					"ts-nocheck": "allow-with-description"
+				}],
 				...overrideRules
 			}
 		}
@@ -830,6 +905,7 @@ async function typescript(options = {}) {
 //#region src/configs/unicorn.ts
 /**
 * `eslint-plugin-unicorn` and overrides configuration options
+*
 * @param {UnicornOptions & OverridesOptions} options
 *  eslint unicorn configuration options
 * @returns {Promise<Linter.Config[]>}
@@ -853,6 +929,7 @@ async function unicorn(options = {}) {
 //#region src/configs/vitest.ts
 /**
 * `@vitest/eslint-plugin` and overrides configuration options
+*
 * @param {VitestOptions & OverridesOptions} options
 *  eslint vitest configuration options
 * @returns {Promise<Linter.Config[]>}
@@ -887,6 +964,7 @@ async function vitest(options = {}) {
 //#region src/configs/vue.ts
 /**
 * `eslint-plugin-vue`, `eslint-plugin-vue-composable`, `eslint-plugin-vue-eslint-plugin-vuejs-accessibility` and overrides configuration options
+*
 * @param {VueScriptOptions & TypeScriptOptions & OverridesOptions} options
 * eslint configuration options for Vue
 * @returns {Promise<Linter.Config[]>}
@@ -965,6 +1043,7 @@ async function vue(options = {}) {
 //#region src/configs/yml.ts
 /**
 * `eslint-plugin-yml` and overrides configuration options
+*
 * @param {YmlOptions & OverridesOptions} options
 *  eslint yml configuration options for yml, yaml
 * @returns {Promise<Linter.Config[]>}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kazupon/eslint-config",
   "description": "ESLint config for @kazupon",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "author": {
     "email": "kawakazu80@gmail.com",
     "name": "kazuya kawaguchi"
@@ -50,8 +50,8 @@
   },
   "dependencies": {
     "@eslint-community/eslint-plugin-eslint-comments": "^4.5.0",
-    "@eslint/js": "^9.31.0",
-    "@kazupon/eslint-plugin": "^0.4.0",
+    "@eslint/js": "^9.32.0",
+    "@kazupon/eslint-plugin": "^0.5.0",
     "@kazupon/jts-utils": "^0.6.0",
     "@stylistic/eslint-plugin": "^4.4.1",
     "eslint-flat-config-utils": "^2.1.0",
@@ -174,19 +174,19 @@
   "devDependencies": {
     "@eslint/compat": "^1.3.1",
     "@eslint/css": "^0.9.0",
-    "@eslint/markdown": "^7.0.0",
-    "@html-eslint/eslint-plugin": "^0.43.0",
+    "@eslint/markdown": "^7.1.0",
+    "@html-eslint/eslint-plugin": "^0.43.1",
     "@intlify/eslint-plugin-vue-i18n": "^4.0.1",
     "@kazupon/prettier-config": "^0.1.1",
     "@types/eslint": "^9.6.1",
     "@types/node": "^22.16.5",
     "@vitest/eslint-plugin": "^1.3.4",
-    "bumpp": "^10.2.0",
-    "eslint": "^9.31.0",
+    "bumpp": "^10.2.1",
+    "eslint": "^9.32.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jsdoc": "^51.0.0",
+    "eslint-plugin-jsdoc": "^52.0.0",
     "eslint-plugin-jsonc": "^2.20.1",
     "eslint-plugin-module-interop": "^0.3.1",
     "eslint-plugin-promise": "^7.2.1",
@@ -203,13 +203,13 @@
     "eslint-plugin-vue-scoped-css": "^2.11.0",
     "eslint-plugin-vuejs-accessibility": "^2.4.1",
     "eslint-plugin-yml": "^1.18.0",
-    "eslint-typegen": "^2.2.1",
+    "eslint-typegen": "^2.3.0",
     "gh-changelogen": "^0.2.8",
-    "jiti": "^2.4.2",
+    "jiti": "^2.5.1",
     "knip": "^5.62.0",
     "lint-staged": "^16.1.2",
     "prettier": "^3.6.2",
-    "svelte": "^5.36.13",
+    "svelte": "^5.37.1",
     "tsdown": "^0.13.0",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.38.0",