/**
 * @module @nhtio/eslint-config/helpers/jsdocTags
 */
import type { FlatConfig } from '@typescript-eslint/utils/ts-eslint';
/**
 * Returns a partial ESLint flat config block that extends the allowed JSDoc tag list
 * beyond the built-in TypeDoc/TSDoc set.
 *
 * Use this when your project uses custom TypeDoc tags (e.g. `@myCustomTag`) that are
 * not part of the standard TypeDoc tag vocabulary. Add the returned config to your
 * `configure()` call to suppress `jsdoc/check-tag-names` false positives.
 *
 * @example
 * ```ts
 * import { configure, withCustomJsdocTags } from '@nhtio/eslint-config'
 * export default configure(withCustomJsdocTags(['myCustomTag', 'internal']))
 * ```
 *
 * @param tags - Array of custom tag names to allow (without the leading `@`)
 * @returns A partial ESLint flat config block that overrides `jsdoc/check-tag-names`
 */
export declare function withCustomJsdocTags(tags: string[]): FlatConfig.Config;