eslint-plugin-jsdoc 63.3.3 → 64.0.1

package/dist/cjs/exportParser.d.ts

@@ -1,40 +0,0 @@
-declare namespace _default {
-    export { isUncommentedExport };
-    export { parse };
-}
-export default _default;
-export type ValueObject = {
-    value: string;
-};
-export type CreatedNode = {
-    type?: string;
-    value?: ValueObject | import("eslint").Rule.Node | import("@typescript-eslint/types").TSESTree.Node;
-    props: {
-        [key: string]: CreatedNode | null;
-    };
-    special?: true;
-    globalVars?: CreatedNode;
-    exported?: boolean;
-    ANONYMOUS_DEFAULT?: import("eslint").Rule.Node;
-};
-export type CreateSymbol = (node: import("eslint").Rule.Node | null, globals: CreatedNode, value: import("eslint").Rule.Node | import("@typescript-eslint/types").TSESTree.Node | null, scope?: CreatedNode | undefined, isGlobal?: boolean | SymbolOptions | undefined) => CreatedNode | null;
-export type SymbolOptions = {
-    simpleIdentifier?: boolean;
-};
-/**
- *
- * @param {import('eslint').Rule.Node} node
- * @param {import('eslint').SourceCode} sourceCode
- * @param {import('./rules/requireJsdoc.js').RequireJsdocOpts} opt
- * @param {import('./iterateJsdoc.js').Settings} settings
- * @returns {boolean}
- */
-declare function isUncommentedExport(node: import("eslint").Rule.Node, sourceCode: import("eslint").SourceCode, opt: import("./rules/requireJsdoc.js").RequireJsdocOpts, settings: import("./iterateJsdoc.js").Settings): boolean;
-/**
- *
- * @param {import('eslint').Rule.Node} ast
- * @param {import('eslint').Rule.Node} node
- * @param {import('./rules/requireJsdoc.js').RequireJsdocOpts} opt
- * @returns {CreatedNode}
- */
-declare function parse(ast: import("eslint").Rule.Node, node: import("eslint").Rule.Node, opt: import("./rules/requireJsdoc.js").RequireJsdocOpts): CreatedNode;

package/dist/cjs/getDefaultTagStructureForMode.d.ts

@@ -1,10 +0,0 @@
-export default getDefaultTagStructureForMode;
-export type TagStructure = Map<string, Map<string, (string | boolean)>>;
-/**
- * @typedef {Map<string, Map<string, (string|boolean)>>} TagStructure
- */
-/**
- * @param {import('./jsdocUtils.js').ParserMode} mode
- * @returns {TagStructure}
- */
-declare function getDefaultTagStructureForMode(mode: import("./jsdocUtils.js").ParserMode): TagStructure;

package/dist/cjs/getJsdocProcessorPlugin.d.cts

@@ -1,5 +0,0 @@
-import { getJsdocProcessorPlugin } from './getJsdocProcessorPlugin.js';
-declare const _default: {
-    getJsdocProcessorPlugin: typeof getJsdocProcessorPlugin;
-};
-export = _default;

package/dist/cjs/getJsdocProcessorPlugin.d.ts

@@ -1,66 +0,0 @@
-export function getJsdocProcessorPlugin(options?: JsdocProcessorOptions): ESLint.Plugin;
-export type Integer = number;
-export type JsdocProcessorOptions = {
-    /**
-     * Require captions for example tags
-     */
-    captionRequired?: boolean | undefined;
-    /**
-     * See docs
-     */
-    paddedIndent?: number | undefined;
-    /**
-     * See docs
-     */
-    checkDefaults?: boolean | undefined;
-    /**
-     * See docs
-     */
-    checkParams?: boolean | undefined;
-    /**
-     * See docs
-     */
-    checkExamples?: boolean | undefined;
-    /**
-     * See docs
-     */
-    checkProperties?: boolean | undefined;
-    /**
-     * See docs
-     */
-    matchingFileName?: string | undefined;
-    /**
-     * See docs
-     */
-    matchingFileNameDefaults?: string | undefined;
-    /**
-     * See docs
-     */
-    matchingFileNameParams?: string | undefined;
-    /**
-     * See docs
-     */
-    matchingFileNameProperties?: string | undefined;
-    /**
-     * See docs
-     */
-    exampleCodeRegex?: string | RegExp | undefined;
-    /**
-     * See docs
-     */
-    rejectExampleCodeRegex?: string | RegExp | undefined;
-    /**
-     * See docs
-     */
-    allowedLanguagesToProcess?: string[] | undefined;
-    /**
-     * See docs
-     */
-    sourceType?: "module" | "script" | undefined;
-    /**
-     * See docs
-     */
-    parser?: Linter.ESTreeParser | Linter.NonESTreeParser | undefined;
-};
-import type { ESLint } from 'eslint';
-import type { Linter } from 'eslint';

package/dist/cjs/index-cjs.d.ts

@@ -1,26 +0,0 @@
-export default index;
-export type ConfigGroups = "recommended" | "stylistic" | "contents" | "logical" | "requirements";
-export type ConfigVariants = "" | "-typescript" | "-typescript-flavor";
-export type ErrorLevelVariants = "" | "-error";
-export type FlatConfigNames = `flat/${ConfigGroups}${ConfigVariants}${ErrorLevelVariants}` | "flat/recommended-tsdoc" | "flat/recommended-tsdoc-error";
-/**
- * @typedef {"recommended" | "stylistic" | "contents" | "logical" | "requirements"} ConfigGroups
- * @typedef {"" | "-typescript" | "-typescript-flavor"} ConfigVariants
- * @typedef {"" | "-error"} ErrorLevelVariants
- * @typedef {`flat/${ConfigGroups}${ConfigVariants}${ErrorLevelVariants}` |
- *   "flat/recommended-tsdoc" | "flat/recommended-tsdoc-error"} FlatConfigNames
- * @type {import('eslint').ESLint.Plugin & {
- *   configs: Record<
- *      FlatConfigNames,
- *       import('eslint').Linter.Config
- *     > &
- *     Record<
- *       "examples"|"default-expressions"|"examples-and-default-expressions",
- *       import('eslint').Linter.Config[]
- *     > &
- *     Record<"flat/recommended-mixed", import('eslint').Linter.Config[]>
- * }}
- */
-declare const index: import("eslint").ESLint.Plugin & {
-    configs: Record<FlatConfigNames, import("eslint").Linter.Config> & Record<"examples" | "default-expressions" | "examples-and-default-expressions", import("eslint").Linter.Config[]> & Record<"flat/recommended-mixed", import("eslint").Linter.Config[]>;
-};

package/dist/cjs/index.cjs.d.cts

@@ -1,2 +0,0 @@
-import items from './index-cjs.js';
-export = items;

package/dist/cjs/iterateJsdoc.d.cts

@@ -1,7 +0,0 @@
-import iterateJsdoc, { getSettings, parseComment } from './iterateJsdoc.js';
-declare const _default: {
-    default: typeof iterateJsdoc;
-    getSettings: typeof getSettings;
-    parseComment: typeof parseComment;
-};
-export = _default;

package/dist/cjs/iterateJsdoc.d.ts

@@ -1,495 +0,0 @@
-/**
- * @param {JsdocVisitor} iterator
- * @param {RuleConfig} ruleConfig
- * @returns {import('eslint').Rule.RuleModule}
- */
-export default function iterateJsdoc(iterator: JsdocVisitor, ruleConfig: RuleConfig): import("eslint").Rule.RuleModule;
-export { parseComment } from "@es-joy/jsdoccomment";
-export type Integer = number;
-export type JsdocBlockWithInline = import("@es-joy/jsdoccomment").JsdocBlockWithInline;
-export type ContextObject = {
-    disallowName?: string;
-    allowName?: string;
-    context?: string;
-    comment?: string;
-    tags?: string[];
-    replacement?: string;
-    minimum?: Integer;
-    message?: string;
-    forceRequireReturn?: boolean;
-};
-export type Context = string | ContextObject;
-export type CheckJsdoc = (info: {
-    lastIndex?: Integer;
-    isFunctionContext?: boolean;
-    selector?: string;
-    comment?: string;
-}, handler: null | ((jsdoc: import("@es-joy/jsdoccomment").JsdocBlockWithInline) => boolean | undefined), node: import("eslint").Rule.Node) => void;
-export type ForEachPreferredTag = (tagName: string, arrayHandler: (matchingJsdocTag: import("@es-joy/jsdoccomment").JsdocTagWithInline, targetTagName: string) => void, skipReportingBlockedTag?: boolean | undefined) => void;
-export type ReportSettings = (message: string) => void;
-export type ParseClosureTemplateTag = (tag: import("comment-parser").Spec) => string[];
-export type GetPreferredTagNameObject = (cfg: {
-    tagName: string;
-}) => string | false | {
-    message: string;
-    replacement?: string | undefined;
-} | {
-    blocked: true;
-    tagName: string;
-};
-export type BasicUtils = {
-    forEachPreferredTag: ForEachPreferredTag;
-    reportSettings: ReportSettings;
-    parseClosureTemplateTag: ParseClosureTemplateTag;
-    getPreferredTagNameObject: GetPreferredTagNameObject;
-    pathDoesNotBeginWith: import("./jsdocUtils.js").PathDoesNotBeginWith;
-    isNameOrNamepathDefiningTag: IsNamepathX;
-    isNamepathReferencingTag: IsNamepathX;
-    isNamepathOrUrlReferencingTag: IsNamepathX;
-    tagMightHaveNameOrNamepath: IsNamepathX;
-    tagMightHaveName: IsNamepathX;
-};
-export type IsIteratingFunction = () => boolean;
-export type IsVirtualFunction = () => boolean;
-export type Stringify = (tagBlock: import("comment-parser").Block, specRewire?: boolean | undefined) => string;
-export type ReportJSDoc = (msg: string, tag?: import("comment-parser").Spec | {
-    line: Integer;
-    column?: Integer;
-} | null | undefined, handler?: ((fixer: import("eslint").Rule.RuleFixer) => import("eslint").Rule.Fix | void) | null | undefined, specRewire?: boolean | undefined, data?: undefined | {
-    [key: string]: string;
-}) => any;
-export type GetRegexFromString = (str: string, requiredFlags?: string | undefined) => RegExp;
-export type GetTagDescription = (tg: import("comment-parser").Spec, returnArray?: boolean | undefined) => string[] | string;
-export type SetTagDescription = (tg: import("comment-parser").Spec, matcher: RegExp, setter: (description: string) => string) => Integer;
-export type GetDescription = () => {
-    description: string;
-    descriptions: string[];
-    lastDescriptionLine: Integer;
-};
-export type SetBlockDescription = (setter: (info: {
-    delimiter: string;
-    postDelimiter: string;
-    start: string;
-}, seedTokens: (tokens?: Partial<import("comment-parser").Tokens>) => import("comment-parser").Tokens, descLines: string[], postDelims: string[]) => import("comment-parser").Line[]) => void;
-export type SetDescriptionLines = (matcher: RegExp, setter: (description: string) => string) => Integer;
-export type ChangeTag = (tag: import("comment-parser").Spec, ...tokens: Partial<import("comment-parser").Tokens>[]) => void;
-export type SetTag = (tag: import("comment-parser").Spec & {
-    line: Integer;
-}, tokens?: Partial<import("comment-parser").Tokens> | undefined) => void;
-export type RemoveTag = (tagIndex: Integer, cfg?: {
-    removeEmptyBlock?: boolean;
-    tagSourceOffset?: Integer;
-} | undefined) => void;
-export type AddTag = (targetTagName: string, number?: number | undefined, tokens?: Partial<import("comment-parser").Tokens> | undefined) => void;
-export type GetFirstLine = () => Integer | undefined;
-export type SeedTokens = (tokens?: Partial<import("comment-parser").Tokens> | undefined) => import("comment-parser").Tokens;
-/**
- * Sets tokens to empty string.
- */
-export type EmptyTokens = (tokens: import("comment-parser").Tokens) => void;
-export type AddLine = (sourceIndex: Integer, tokens: Partial<import("comment-parser").Tokens>) => void;
-export type AddLines = (tagIndex: Integer, tagSourceOffset: Integer, numLines: Integer) => void;
-export type MakeMultiline = () => void;
-export type GetFunctionParameterNames = (useDefaultObjectProperties?: boolean | undefined, ignoreInterfacedParameters?: boolean | undefined) => import("./jsdocUtils.js").ParamNameInfo[];
-export type HasParams = () => Integer;
-export type IsGenerator = () => boolean;
-export type IsConstructor = () => boolean;
-export type GetJsdocTagsDeep = (tagName: string) => false | {
-    idx: Integer;
-    name: string;
-    type: string;
-}[];
-export type GetPreferredTagName = (cfg: {
-    tagName: string;
-    skipReportingBlockedTag?: boolean;
-    allowObjectReturn?: boolean;
-    defaultMessage?: string;
-}) => string | undefined | false | {
-    message: string;
-    replacement?: string | undefined;
-} | {
-    blocked: true;
-    tagName: string;
-};
-export type IsValidTag = (name: string, definedTags: string[]) => boolean;
-export type HasATag = (names: string[]) => boolean;
-export type HasTag = (name: string) => boolean;
-export type ComparePaths = (name: string) => (otherPathName: string) => boolean;
-export type DropPathSegmentQuotes = (name: string) => string;
-export type AvoidDocs = (exemptSpecialMethods?: boolean | undefined) => boolean;
-export type TagMightHaveNamePositionTypePosition = (tagName: string, otherModeMaps?: import("./getDefaultTagStructureForMode.js").TagStructure[] | undefined) => boolean | {
-    otherMode: true;
-};
-export type TagMustHave = (tagName: string, otherModeMaps: import("./getDefaultTagStructureForMode.js").TagStructure[]) => boolean | {
-    otherMode: false;
-};
-export type TagMissingRequiredTypeOrNamepath = (tag: import("comment-parser").Spec, otherModeMaps: import("./getDefaultTagStructureForMode.js").TagStructure[]) => boolean | {
-    otherMode: false;
-};
-export type IsNamepathX = (tagName: string) => boolean;
-export type GetTagStructureForMode = (mde: import("./jsdocUtils.js").ParserMode) => import("./getDefaultTagStructureForMode.js").TagStructure;
-export type MayBeUndefinedTypeTag = (tag: import("comment-parser").Spec) => boolean;
-export type HasValueOrExecutorHasNonEmptyResolveValue = (anyPromiseAsReturn: boolean, allBranches?: boolean | undefined) => boolean;
-export type HasYieldValue = () => boolean;
-export type HasYieldReturnValue = () => boolean;
-export type HasThrowValue = () => boolean;
-export type IsAsync = () => boolean | undefined;
-export type GetTags = (tagName: string) => import("comment-parser").Spec[];
-export type GetPresentTags = (tagList: string[]) => import("@es-joy/jsdoccomment").JsdocTagWithInline[];
-export type FilterTags = (filter: (tag: import("@es-joy/jsdoccomment").JsdocTagWithInline) => boolean) => import("@es-joy/jsdoccomment").JsdocTagWithInline[];
-export type FilterAllTags = (filter: (tag: (import("comment-parser").Spec | import("@es-joy/jsdoccomment").JsdocInlineTagNoType)) => boolean) => (import("comment-parser").Spec | import("@es-joy/jsdoccomment").JsdocInlineTagNoType)[];
-export type getInlineTags = () => (import("comment-parser").Spec | (import("@es-joy/jsdoccomment").JsdocInlineTagNoType & {
-    line?: number | undefined;
-    column?: number | undefined;
-}))[];
-export type GetTagsByType = (tags: import("comment-parser").Spec[]) => {
-    tagsWithNames: import("comment-parser").Spec[];
-    tagsWithoutNames: import("comment-parser").Spec[];
-};
-export type HasOptionTag = (tagName: string) => boolean;
-export type GetClassNode = () => Node | null;
-export type GetClassJsdoc = () => null | JsdocBlockWithInline;
-export type ClassHasTag = (tagName: string) => boolean;
-export type FindContext = (contexts: Context[], comment: string | undefined) => {
-    foundContext: Context | undefined;
-    contextStr: string;
-};
-export type Utils = BasicUtils & {
-    isIteratingFunction: IsIteratingFunction;
-    isIteratingFunctionOrVariable: IsIteratingFunction;
-    isVirtualFunction: IsVirtualFunction;
-    stringify: Stringify;
-    reportJSDoc: ReportJSDoc;
-    getRegexFromString: GetRegexFromString;
-    getTagDescription: GetTagDescription;
-    setTagDescription: SetTagDescription;
-    getDescription: GetDescription;
-    setBlockDescription: SetBlockDescription;
-    setDescriptionLines: SetDescriptionLines;
-    changeTag: ChangeTag;
-    setTag: SetTag;
-    removeTag: RemoveTag;
-    addTag: AddTag;
-    getFirstLine: GetFirstLine;
-    seedTokens: SeedTokens;
-    emptyTokens: EmptyTokens;
-    addLine: AddLine;
-    addLines: AddLines;
-    makeMultiline: MakeMultiline;
-    flattenRoots: import("./jsdocUtils.js").FlattenRoots;
-    getFunctionParameterNames: GetFunctionParameterNames;
-    hasParams: HasParams;
-    isGenerator: IsGenerator;
-    isConstructor: IsConstructor;
-    getJsdocTagsDeep: GetJsdocTagsDeep;
-    getPreferredTagName: GetPreferredTagName;
-    isValidTag: IsValidTag;
-    hasATag: HasATag;
-    hasTag: HasTag;
-    comparePaths: ComparePaths;
-    dropPathSegmentQuotes: DropPathSegmentQuotes;
-    avoidDocs: AvoidDocs;
-    tagMightHaveNamePosition: TagMightHaveNamePositionTypePosition;
-    tagMightHaveTypePosition: TagMightHaveNamePositionTypePosition;
-    tagMustHaveNamePosition: TagMustHave;
-    tagMustHaveTypePosition: TagMustHave;
-    tagMissingRequiredTypeOrNamepath: TagMissingRequiredTypeOrNamepath;
-    isNameOrNamepathDefiningTag: IsNamepathX;
-    isNamepathReferencingTag: IsNamepathX;
-    isNamepathOrUrlReferencingTag: IsNamepathX;
-    tagMightHaveNameOrNamepath: IsNamepathX;
-    tagMightHaveName: IsNamepathX;
-    tagMightHaveNamepath: IsNamepathX;
-    getTagStructureForMode: GetTagStructureForMode;
-    mayBeUndefinedTypeTag: MayBeUndefinedTypeTag;
-    hasValueOrExecutorHasNonEmptyResolveValue: HasValueOrExecutorHasNonEmptyResolveValue;
-    hasYieldValue: HasYieldValue;
-    hasYieldReturnValue: HasYieldReturnValue;
-    hasThrowValue: HasThrowValue;
-    isAsync: IsAsync;
-    getTags: GetTags;
-    getPresentTags: GetPresentTags;
-    filterTags: FilterTags;
-    filterAllTags: FilterAllTags;
-    getInlineTags: getInlineTags;
-    getTagsByType: GetTagsByType;
-    hasOptionTag: HasOptionTag;
-    getClassNode: GetClassNode;
-    getClassJsdoc: GetClassJsdoc;
-    classHasTag: ClassHasTag;
-    findContext: FindContext;
-};
-/**
- * Should use ESLint rule's typing.
- */
-export type EslintRuleMeta = import("eslint").Rule.RuleMetaData;
-/**
- * A plain object for tracking state as needed by rules across iterations.
- */
-export type StateObject = {
-    globalTags: boolean;
-    hasDuplicates: {
-        [key: string]: boolean;
-    };
-    selectorMap: {
-        [selector: string]: {
-            [comment: string]: Integer;
-        };
-    };
-    hasTag: {
-        [key: string]: boolean;
-    };
-    hasNonComment: number;
-    hasNonCommentBeforeTag: {
-        [key: string]: boolean | number;
-    };
-    foundTypedefValues: string[];
-};
-/**
- * The Node AST as supplied by the parser.
- */
-export type Node = import("eslint").Rule.Node;
-export type Report = (message: string, fix?: import("@eslint/core").RuleFixer | null | undefined, jsdocLoc?: {
-    line?: Integer;
-    column?: Integer;
-} | (import("comment-parser").Spec & {
-    line?: Integer;
-}) | null | undefined, data?: undefined | {
-    [key: string]: string;
-}) => void;
-export type PreferredTypes = {
-    [key: string]: false | string | {
-        message: string;
-        replacement?: false | string;
-        skipRootChecking?: boolean;
-        unifyParentAndChildTypeChecks?: boolean;
-    };
-};
-export type StructuredTags = {
-    [key: string]: {
-        name?: "text" | "name-defining" | "namepath-defining" | "namepath-referencing" | false;
-        type?: boolean | string[];
-        required?: ("name" | "type" | "typeOrNameRequired")[];
-    };
-};
-/**
- * Settings from ESLint types.
- */
-export type Settings = {
-    maxLines: Integer;
-    minLines: Integer;
-    tagNamePreference: import("./jsdocUtils.js").TagNamePreference;
-    mode: import("./jsdocUtils.js").ParserMode;
-    preferredTypes: PreferredTypes;
-    structuredTags: StructuredTags;
-    contexts?: Context[];
-    augmentsExtendsReplacesDocs?: boolean;
-    ignoreReplacesDocs?: boolean;
-    implementsReplacesDocs?: boolean;
-    overrideReplacesDocs?: boolean;
-    ignoreInternal?: boolean;
-    ignorePrivate?: boolean;
-    exemptDestructuredRootsFromChecks?: boolean;
-    skipInvokedExpressionsForCommentFinding?: boolean;
-};
-export type JSDocSettings = {
-    settings?: {
-        jsdoc?: {
-            ignorePrivate: boolean;
-            ignoreInternal: boolean;
-            maxLines: Integer;
-            minLines: Integer;
-            tagNamePreference: import("./jsdocUtils.js").TagNamePreference;
-            preferredTypes: PreferredTypes;
-            structuredTags: StructuredTags;
-            overrideReplacesDocs: boolean;
-            ignoreReplacesDocs: boolean;
-            implementsReplacesDocs: boolean;
-            augmentsExtendsReplacesDocs: boolean;
-            exemptDestructuredRootsFromChecks: boolean;
-            skipInvokedExpressionsForCommentFinding: boolean;
-            mode: import("./jsdocUtils.js").ParserMode;
-            contexts: Context[];
-        };
-    };
-};
-/**
- * Create the report function
- */
-export type MakeReport = (context: import("eslint").Rule.RuleContext, commentNode: import("estree").Node) => Report;
-export type JsdocVisitorBasic = (arg: {
-    context: import("eslint").Rule.RuleContext;
-    sourceCode: import("eslint").SourceCode;
-    indent?: string;
-    info?: {
-        comment?: string | undefined;
-        lastIndex?: Integer | undefined;
-    };
-    state?: StateObject;
-    globalState?: Map<string, Map<string, string>>;
-    jsdoc?: JsdocBlockWithInline;
-    jsdocNode?: import("eslint").Rule.Node & {
-        range: [number, number];
-    };
-    node?: Node;
-    allComments?: import("estree").Node[];
-    report?: Report;
-    makeReport?: MakeReport;
-    settings: Settings;
-    utils: BasicUtils;
-}) => void;
-export type JsdocVisitor = (arg: {
-    context: import("eslint").Rule.RuleContext;
-    sourceCode: import("eslint").SourceCode;
-    indent: string;
-    info: {
-        comment?: string | undefined;
-        lastIndex?: Integer | undefined;
-    };
-    state: StateObject;
-    globalState: Map<string, Map<string, string>>;
-    jsdoc: JsdocBlockWithInline;
-    jsdocNode: import("eslint").Rule.Node & {
-        range: [number, number];
-    };
-    node: Node | null;
-    allComments?: import("estree").Node[];
-    report: Report;
-    makeReport?: MakeReport;
-    settings: Settings;
-    utils: Utils;
-}) => void;
-export type NonCommentArgs = {
-    node: Node;
-    state: StateObject;
-};
-export type RuleConfig = {
-    /**
-     * ESLint rule meta
-     */
-    meta: EslintRuleMeta;
-    /**
-     * Any default contexts
-     */
-    contextDefaults?: jsdocUtils.DefaultContexts | undefined;
-    /**
-     * Whether to force a `contexts` check
-     */
-    contextSelected?: true | undefined;
-    /**
-     * Modify the rule's context object
-     */
-    modifyContext?: ((context: import("eslint").Rule.RuleContext) => import("eslint").Rule.RuleContext) | undefined;
-    /**
-     * Whether to iterate all JSDoc blocks by default
-     * regardless of context
-     */
-    iterateAllJsdocs?: true | undefined;
-    /**
-     * Whether to check `@private` blocks (normally exempted)
-     */
-    checkPrivate?: true | undefined;
-    /**
-     * Whether to check `@internal` blocks (normally exempted)
-     */
-    checkInternal?: true | undefined;
-    /**
-     * Whether to iterates over all JSDoc blocks regardless of attachment
-     */
-    checkFile?: true | undefined;
-    /**
-     * Whether to avoid relying on settings for global contexts
-     */
-    nonGlobalSettings?: true | undefined;
-    /**
-     * Whether to disable the tracking of visited comment nodes (as
-     * non-tracked may conduct further actions)
-     */
-    noTracking?: true | undefined;
-    /**
-     * Whether the rule expects contexts to be based on a match option
-     */
-    matchContext?: true | undefined;
-    /**
-     * Handler to be executed upon exiting iteration of program AST
-     */
-    exit?: ((args: {
-        context: import("eslint").Rule.RuleContext;
-        state: StateObject;
-        settings: Settings;
-        utils: BasicUtils;
-    }) => void) | undefined;
-    /**
-     * Handler to be executed if rule wishes
-     * to be supplied nodes without comments
-     */
-    nonComment?: ((nca: NonCommentArgs) => void) | undefined;
-};
-/**
- * @typedef {{
- *   [key: string]: false|string|{
- *     message: string,
- *     replacement?: false|string
- *     skipRootChecking?: boolean
- *     unifyParentAndChildTypeChecks?: boolean
- *   }
- * }} PreferredTypes
- */
-/**
- * @typedef {{
- *   [key: string]: {
- *     name?: "text"|"name-defining"|"namepath-defining"|"namepath-referencing"|false,
- *     type?: boolean|string[],
- *     required?: ("name"|"type"|"typeOrNameRequired")[]
- *   }
- * }} StructuredTags
- */
-/**
- * Settings from ESLint types.
- * @typedef {{
- *   maxLines: Integer,
- *   minLines: Integer,
- *   tagNamePreference: import('./jsdocUtils.js').TagNamePreference,
- *   mode: import('./jsdocUtils.js').ParserMode,
- *   preferredTypes: PreferredTypes,
- *   structuredTags: StructuredTags,
- *   contexts?: Context[],
- *   augmentsExtendsReplacesDocs?: boolean,
- *   ignoreReplacesDocs?: boolean,
- *   implementsReplacesDocs?: boolean,
- *   overrideReplacesDocs?: boolean,
- *   ignoreInternal?: boolean,
- *   ignorePrivate?: boolean,
- *   exemptDestructuredRootsFromChecks?: boolean,
- *   skipInvokedExpressionsForCommentFinding?: boolean
- * }} Settings
- */
-/**
- * @typedef {{
- *   settings?: {
- *     jsdoc?: {
- *       ignorePrivate: boolean,
- *       ignoreInternal: boolean,
- *       maxLines: Integer,
- *       minLines: Integer,
- *       tagNamePreference: import('./jsdocUtils.js').TagNamePreference,
- *       preferredTypes: PreferredTypes,
- *       structuredTags: StructuredTags,
- *       overrideReplacesDocs: boolean,
- *       ignoreReplacesDocs: boolean,
- *       implementsReplacesDocs: boolean,
- *       augmentsExtendsReplacesDocs: boolean,
- *       exemptDestructuredRootsFromChecks: boolean,
- *       skipInvokedExpressionsForCommentFinding: boolean,
- *       mode: import('./jsdocUtils.js').ParserMode,
- *       contexts: Context[],
- *     }
- *   }
- * }} JSDocSettings
- */
-/**
- * @param {import('eslint').Rule.RuleContext & JSDocSettings} context
- * @returns {Settings|false}
- */
-export function getSettings(context: import("eslint").Rule.RuleContext & JSDocSettings): Settings | false;
-import * as jsdocUtils from './jsdocUtils.js';