@api-extractor-tools/eslint-plugin 0.1.0-alpha.0

package/dist/utils/config-loader.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Utilities for discovering and loading API Extractor configuration.
+ * @internal
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findApiExtractorConfig = findApiExtractorConfig;
+exports.loadApiExtractorConfig = loadApiExtractorConfig;
+exports.getMessageLogLevel = getMessageLogLevel;
+exports.resolveConfig = resolveConfig;
+exports.logLevelToSeverity = logLevelToSeverity;
+exports.clearConfigCache = clearConfigCache;
+const fs = require("fs");
+const path = require("path");
+/**
+ * Default message configuration when no api-extractor.json is found.
+ */
+const DEFAULT_MESSAGES_CONFIG = {
+    extractorMessageReporting: {
+        default: { logLevel: 'warning' },
+        'ae-missing-release-tag': { logLevel: 'warning' },
+    },
+};
+/**
+ * Cache for loaded configurations to avoid repeated file reads.
+ */
+const configCache = new Map();
+/**
+ * Searches upward from the given directory to find api-extractor.json.
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Path to api-extractor.json if found, undefined otherwise
+ */
+function findApiExtractorConfig(startDir) {
+    let currentDir = path.resolve(startDir);
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        const configPath = path.join(currentDir, 'api-extractor.json');
+        if (fs.existsSync(configPath)) {
+            return configPath;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    return undefined;
+}
+/**
+ * Loads and parses an api-extractor.json file.
+ *
+ * @param configPath - Path to the api-extractor.json file
+ * @returns Parsed configuration or null if file cannot be read
+ */
+function loadApiExtractorConfig(configPath) {
+    // Check cache first
+    const cached = configCache.get(configPath);
+    if (cached !== undefined) {
+        return cached;
+    }
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        // Remove comments (api-extractor.json supports JSON with comments)
+        const jsonContent = content.replace(/\/\/.*$|\/\*[\s\S]*?\*\//gm, '');
+        const config = JSON.parse(jsonContent);
+        // Handle extends
+        if (config.extends) {
+            const baseConfigPath = path.resolve(path.dirname(configPath), config.extends);
+            const baseConfig = loadApiExtractorConfig(baseConfigPath);
+            if (baseConfig) {
+                // Merge base config with current config
+                const merged = mergeConfigs(baseConfig, config);
+                configCache.set(configPath, merged);
+                return merged;
+            }
+        }
+        configCache.set(configPath, config);
+        return config;
+    }
+    catch {
+        configCache.set(configPath, null);
+        return null;
+    }
+}
+/**
+ * Merges two API Extractor configurations, with the override taking precedence.
+ */
+function mergeConfigs(base, override) {
+    return {
+        ...base,
+        ...override,
+        messages: {
+            compilerMessageReporting: {
+                ...base.messages?.compilerMessageReporting,
+                ...override.messages?.compilerMessageReporting,
+            },
+            extractorMessageReporting: {
+                ...base.messages?.extractorMessageReporting,
+                ...override.messages?.extractorMessageReporting,
+            },
+            tsdocMessageReporting: {
+                ...base.messages?.tsdocMessageReporting,
+                ...override.messages?.tsdocMessageReporting,
+            },
+        },
+    };
+}
+/**
+ * Gets the log level for a specific message ID from the configuration.
+ *
+ * @param config - API Extractor configuration
+ * @param messageId - The message ID (e.g., 'ae-missing-release-tag')
+ * @returns The configured log level, or 'warning' as default
+ */
+function getMessageLogLevel(config, messageId) {
+    if (!config?.messages?.extractorMessageReporting) {
+        return (DEFAULT_MESSAGES_CONFIG.extractorMessageReporting?.default?.logLevel ??
+            'warning');
+    }
+    const reporting = config.messages.extractorMessageReporting;
+    const messageConfig = reporting[messageId];
+    if (messageConfig?.logLevel) {
+        return messageConfig.logLevel;
+    }
+    return reporting.default?.logLevel ?? 'warning';
+}
+/**
+ * Resolves configuration for a file, using auto-discovery or explicit path.
+ *
+ * @param filePath - Path to the file being linted
+ * @param explicitConfigPath - Optional explicit path to api-extractor.json
+ * @returns The resolved configuration or null
+ */
+function resolveConfig(filePath, explicitConfigPath) {
+    if (explicitConfigPath) {
+        return loadApiExtractorConfig(explicitConfigPath);
+    }
+    const discovered = findApiExtractorConfig(path.dirname(filePath));
+    if (discovered) {
+        return loadApiExtractorConfig(discovered);
+    }
+    return null;
+}
+/**
+ * Maps API Extractor log level to ESLint severity.
+ *
+ * @param logLevel - API Extractor log level
+ * @returns ESLint severity (0 = off, 1 = warn, 2 = error)
+ */
+function logLevelToSeverity(logLevel) {
+    switch (logLevel) {
+        case 'error':
+            return 2;
+        case 'warning':
+            return 1;
+        case 'none':
+            return 0;
+    }
+}
+/**
+ * Clears the configuration cache. Useful for testing.
+ */
+function clearConfigCache() {
+    configCache.clear();
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/utils/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"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"}

package/dist/utils/entry-point.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Utilities for resolving package.json entry points.
+ * @internal
+ */
+import type { ResolvedEntryPoints } from '../types';
+/**
+ * Represents the relevant fields from package.json.
+ */
+interface PackageJson {
+    main?: string;
+    types?: string;
+    typings?: string;
+    module?: string;
+    exports?: PackageExports;
+}
+/**
+ * Package.json exports field can be complex.
+ */
+type PackageExports = string | {
+    [key: string]: PackageExports | string | undefined;
+} | undefined;
+/**
+ * Finds the nearest package.json by searching upward from a directory.
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Path to package.json if found, undefined otherwise
+ */
+export declare function findPackageJson(startDir: string): string | undefined;
+/**
+ * Loads and parses a package.json file.
+ *
+ * @param pkgPath - Path to the package.json file
+ * @returns Parsed package.json or null if file cannot be read
+ */
+export declare function loadPackageJson(pkgPath: string): PackageJson | null;
+/**
+ * Resolves all entry points from a package.json.
+ *
+ * @param pkgPath - Path to the package.json file
+ * @returns Resolved entry points with absolute paths
+ */
+export declare function resolveEntryPoints(pkgPath: string): ResolvedEntryPoints;
+/**
+ * Checks if a file is a package entry point.
+ *
+ * @param filePath - Absolute path to the file being checked
+ * @param pkgPath - Path to the package.json
+ * @returns True if the file is an entry point
+ */
+export declare function isEntryPoint(filePath: string, pkgPath: string): boolean;
+/**
+ * Clears the package.json cache. Useful for testing.
+ */
+export declare function clearPackageJsonCache(): void;
+export {};
+//# sourceMappingURL=entry-point.d.ts.map

package/dist/utils/entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-point.d.ts","sourceRoot":"","sources":["../../src/utils/entry-point.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAEnD;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED;;GAEG;AACH,KAAK,cAAc,GACf,MAAM,GACN;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,GACtD,SAAS,CAAA;AAOb;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAapE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAenE;AAuBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CA6BvE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CA6DvE;AAsCD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/utils/entry-point.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * Utilities for resolving package.json entry points.
+ * @internal
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPackageJson = findPackageJson;
+exports.loadPackageJson = loadPackageJson;
+exports.resolveEntryPoints = resolveEntryPoints;
+exports.isEntryPoint = isEntryPoint;
+exports.clearPackageJsonCache = clearPackageJsonCache;
+const fs = require("fs");
+const path = require("path");
+/**
+ * Cache for package.json lookups.
+ */
+const packageJsonCache = new Map();
+/**
+ * Finds the nearest package.json by searching upward from a directory.
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Path to package.json if found, undefined otherwise
+ */
+function findPackageJson(startDir) {
+    let currentDir = path.resolve(startDir);
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        const pkgPath = path.join(currentDir, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            return pkgPath;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    return undefined;
+}
+/**
+ * Loads and parses a package.json file.
+ *
+ * @param pkgPath - Path to the package.json file
+ * @returns Parsed package.json or null if file cannot be read
+ */
+function loadPackageJson(pkgPath) {
+    const cached = packageJsonCache.get(pkgPath);
+    if (cached !== undefined) {
+        return cached;
+    }
+    try {
+        const content = fs.readFileSync(pkgPath, 'utf-8');
+        const pkg = JSON.parse(content);
+        packageJsonCache.set(pkgPath, pkg);
+        return pkg;
+    }
+    catch {
+        packageJsonCache.set(pkgPath, null);
+        return null;
+    }
+}
+/**
+ * Extracts all entry point paths from package.json exports field.
+ *
+ * @param exports - The exports field value
+ * @param results - Array to collect results
+ */
+function extractExportPaths(exports, results) {
+    if (typeof exports === 'string') {
+        results.push(exports);
+        return;
+    }
+    if (exports && typeof exports === 'object') {
+        for (const value of Object.values(exports)) {
+            if (value !== undefined) {
+                extractExportPaths(value, results);
+            }
+        }
+    }
+}
+/**
+ * Resolves all entry points from a package.json.
+ *
+ * @param pkgPath - Path to the package.json file
+ * @returns Resolved entry points with absolute paths
+ */
+function resolveEntryPoints(pkgPath) {
+    const pkg = loadPackageJson(pkgPath);
+    const pkgDir = path.dirname(pkgPath);
+    const result = { exports: [] };
+    if (!pkg) {
+        return result;
+    }
+    // Resolve main entry point
+    if (pkg.main) {
+        result.main = path.resolve(pkgDir, pkg.main);
+    }
+    // Resolve types entry point
+    if (pkg.types) {
+        result.types = path.resolve(pkgDir, pkg.types);
+    }
+    else if (pkg.typings) {
+        result.types = path.resolve(pkgDir, pkg.typings);
+    }
+    // Resolve exports
+    if (pkg.exports) {
+        const exportPaths = [];
+        extractExportPaths(pkg.exports, exportPaths);
+        result.exports = exportPaths.map((p) => path.resolve(pkgDir, p));
+    }
+    return result;
+}
+/**
+ * Checks if a file is a package entry point.
+ *
+ * @param filePath - Absolute path to the file being checked
+ * @param pkgPath - Path to the package.json
+ * @returns True if the file is an entry point
+ */
+function isEntryPoint(filePath, pkgPath) {
+    const entryPoints = resolveEntryPoints(pkgPath);
+    const absoluteFilePath = path.resolve(filePath);
+    // Check main
+    if (entryPoints.main &&
+        normalizeForComparison(entryPoints.main) ===
+            normalizeForComparison(absoluteFilePath)) {
+        return true;
+    }
+    // Check types
+    if (entryPoints.types &&
+        normalizeForComparison(entryPoints.types) ===
+            normalizeForComparison(absoluteFilePath)) {
+        return true;
+    }
+    // Check exports
+    for (const exportPath of entryPoints.exports) {
+        if (normalizeForComparison(exportPath) ===
+            normalizeForComparison(absoluteFilePath)) {
+            return true;
+        }
+    }
+    // Also check if the TypeScript source file corresponds to the entry point
+    // e.g., src/index.ts -> dist/index.js
+    const sourceEquivalents = getSourceEquivalents(absoluteFilePath);
+    for (const sourcePath of sourceEquivalents) {
+        if (entryPoints.main &&
+            normalizeForComparison(entryPoints.main) ===
+                normalizeForComparison(sourcePath)) {
+            return true;
+        }
+        if (entryPoints.types &&
+            normalizeForComparison(entryPoints.types) ===
+                normalizeForComparison(sourcePath)) {
+            return true;
+        }
+        for (const exportPath of entryPoints.exports) {
+            if (normalizeForComparison(exportPath) ===
+                normalizeForComparison(sourcePath)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Normalizes a path for comparison by removing extension variations.
+ */
+function normalizeForComparison(filePath) {
+    // Remove common extensions and normalize
+    return filePath
+        .replace(/\.(js|ts|mjs|cjs|mts|cts|d\.ts|d\.mts|d\.cts)$/, '')
+        .replace(/\/index$/, '');
+}
+/**
+ * Gets potential source file equivalents for a dist file.
+ */
+function getSourceEquivalents(filePath) {
+    const equivalents = [];
+    const dir = path.dirname(filePath);
+    const base = path.basename(filePath).replace(/\.(ts|tsx|js|jsx|mjs|cjs)$/, '');
+    // Try common source directory patterns
+    const sourcePatterns = [
+        dir.replace('/dist/', '/src/').replace('\\dist\\', '\\src\\'),
+        dir.replace('/build/', '/src/').replace('\\build\\', '\\src\\'),
+        dir.replace('/lib/', '/src/').replace('\\lib\\', '\\src\\'),
+    ];
+    for (const sourceDir of sourcePatterns) {
+        if (sourceDir !== dir) {
+            equivalents.push(path.join(sourceDir, `${base}.ts`));
+            equivalents.push(path.join(sourceDir, `${base}.tsx`));
+            equivalents.push(path.join(sourceDir, `${base}.js`));
+        }
+    }
+    return equivalents;
+}
+/**
+ * Clears the package.json cache. Useful for testing.
+ */
+function clearPackageJsonCache() {
+    packageJsonCache.clear();
+}
+//# sourceMappingURL=entry-point.js.map

package/dist/utils/entry-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-point.js","sourceRoot":"","sources":["../../src/utils/entry-point.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Utility module exports.
+ * @internal
+ */
+export { resolveConfig, getMessageLogLevel } from './config-loader';
+export { parseTSDocComment, extractReleaseTag, hasOverrideTag, hasPackageDocumentation, getLeadingTSDocComment, findAllTSDocComments, } from './tsdoc-parser';
+export { findPackageJson, isEntryPoint } from './entry-point';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEnE,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA"}

package/dist/utils/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Utility module exports.
+ * @internal
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEntryPoint = exports.findPackageJson = exports.findAllTSDocComments = exports.getLeadingTSDocComment = exports.hasPackageDocumentation = exports.hasOverrideTag = exports.extractReleaseTag = exports.parseTSDocComment = exports.getMessageLogLevel = exports.resolveConfig = void 0;
+var config_loader_1 = require("./config-loader");
+Object.defineProperty(exports, "resolveConfig", { enumerable: true, get: function () { return config_loader_1.resolveConfig; } });
+Object.defineProperty(exports, "getMessageLogLevel", { enumerable: true, get: function () { return config_loader_1.getMessageLogLevel; } });
+var tsdoc_parser_1 = require("./tsdoc-parser");
+Object.defineProperty(exports, "parseTSDocComment", { enumerable: true, get: function () { return tsdoc_parser_1.parseTSDocComment; } });
+Object.defineProperty(exports, "extractReleaseTag", { enumerable: true, get: function () { return tsdoc_parser_1.extractReleaseTag; } });
+Object.defineProperty(exports, "hasOverrideTag", { enumerable: true, get: function () { return tsdoc_parser_1.hasOverrideTag; } });
+Object.defineProperty(exports, "hasPackageDocumentation", { enumerable: true, get: function () { return tsdoc_parser_1.hasPackageDocumentation; } });
+Object.defineProperty(exports, "getLeadingTSDocComment", { enumerable: true, get: function () { return tsdoc_parser_1.getLeadingTSDocComment; } });
+Object.defineProperty(exports, "findAllTSDocComments", { enumerable: true, get: function () { return tsdoc_parser_1.findAllTSDocComments; } });
+var entry_point_1 = require("./entry-point");
+Object.defineProperty(exports, "findPackageJson", { enumerable: true, get: function () { return entry_point_1.findPackageJson; } });
+Object.defineProperty(exports, "isEntryPoint", { enumerable: true, get: function () { return entry_point_1.isEntryPoint; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,iDAAmE;AAA1D,8GAAA,aAAa,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAE1C,+CAOuB;AANrB,iHAAA,iBAAiB,OAAA;AACjB,iHAAA,iBAAiB,OAAA;AACjB,8GAAA,cAAc,OAAA;AACd,uHAAA,uBAAuB,OAAA;AACvB,sHAAA,sBAAsB,OAAA;AACtB,oHAAA,oBAAoB,OAAA;AAGtB,6CAA6D;AAApD,8GAAA,eAAe,OAAA;AAAE,2GAAA,YAAY,OAAA"}

package/dist/utils/tsdoc-parser.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Utilities for parsing TSDoc comments.
+ * @internal
+ */
+import { ParserContext, DocComment } from '@microsoft/tsdoc';
+import type { TSESTree } from '@typescript-eslint/utils';
+import type { ReleaseTag } from '../types';
+/**
+ * Parses a TSDoc comment string.
+ *
+ * @param commentText - The full comment text including delimiters
+ * @returns Parser context with the parsed doc comment
+ */
+export declare function parseTSDocComment(commentText: string): ParserContext;
+/**
+ * Extracts a release tag from a parsed TSDoc comment.
+ *
+ * @param docComment - The parsed doc comment
+ * @returns The release tag if found, undefined otherwise
+ */
+export declare function extractReleaseTag(docComment: DocComment): ReleaseTag | undefined;
+/**
+ * Checks if a TSDoc comment has the @override tag.
+ *
+ * @param docComment - The parsed doc comment
+ * @returns True if @override tag is present
+ */
+export declare function hasOverrideTag(docComment: DocComment): boolean;
+/**
+ * Checks if a TSDoc comment has the @packageDocumentation tag.
+ *
+ * @param docComment - The parsed doc comment
+ * @returns True if @packageDocumentation tag is present
+ */
+export declare function hasPackageDocumentation(docComment: DocComment): boolean;
+/**
+ * Gets the leading comment for a node, if it's a TSDoc comment.
+ *
+ * @param sourceCode - ESLint source code object
+ * @param node - The AST node to check
+ * @returns The comment text if a TSDoc comment exists, undefined otherwise
+ */
+export declare function getLeadingTSDocComment(sourceCode: {
+    getCommentsBefore: (node: TSESTree.Node) => TSESTree.Comment[];
+}, node: TSESTree.Node): string | undefined;
+/**
+ * Finds all TSDoc comments in a source file.
+ *
+ * @param sourceCode - ESLint source code object
+ * @returns Array of comment objects with their parsed content
+ */
+export declare function findAllTSDocComments(sourceCode: {
+    getAllComments: () => TSESTree.Comment[];
+}): Array<{
+    comment: TSESTree.Comment;
+    parsed: ParserContext;
+}>;
+//# sourceMappingURL=tsdoc-parser.d.ts.map

package/dist/utils/tsdoc-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsdoc-parser.d.ts","sourceRoot":"","sources":["../../src/utils/tsdoc-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAIL,aAAa,EACb,UAAU,EACX,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAqB1C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAIpE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,GACrB,UAAU,GAAG,SAAS,CAexB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEvE;AAWD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE;IACV,iBAAiB,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAA;CAC/D,EACD,IAAI,EAAE,QAAQ,CAAC,IAAI,GAClB,MAAM,GAAG,SAAS,CAyBpB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE;IAC/C,cAAc,EAAE,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAA;CACzC,GAAG,KAAK,CAAC;IAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC,CAe9D"}

package/dist/utils/tsdoc-parser.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * Utilities for parsing TSDoc comments.
+ * @internal
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTSDocComment = parseTSDocComment;
+exports.extractReleaseTag = extractReleaseTag;
+exports.hasOverrideTag = hasOverrideTag;
+exports.hasPackageDocumentation = hasPackageDocumentation;
+exports.getLeadingTSDocComment = getLeadingTSDocComment;
+exports.findAllTSDocComments = findAllTSDocComments;
+const tsdoc_1 = require("@microsoft/tsdoc");
+/**
+ * TSDoc parser instance configured for API Extractor compatibility.
+ */
+let parserInstance;
+/**
+ * Gets or creates a TSDoc parser instance.
+ */
+function getParser() {
+    if (!parserInstance) {
+        const config = new tsdoc_1.TSDocConfiguration();
+        // API Extractor's custom tags are defined via tsdoc.json extends
+        // For our purposes, the default configuration suffices as we're
+        // checking for standard modifier tags
+        parserInstance = new tsdoc_1.TSDocParser(config);
+    }
+    return parserInstance;
+}
+/**
+ * Parses a TSDoc comment string.
+ *
+ * @param commentText - The full comment text including delimiters
+ * @returns Parser context with the parsed doc comment
+ */
+function parseTSDocComment(commentText) {
+    const parser = getParser();
+    const textRange = tsdoc_1.TextRange.fromString(commentText);
+    return parser.parseRange(textRange);
+}
+/**
+ * Extracts a release tag from a parsed TSDoc comment.
+ *
+ * @param docComment - The parsed doc comment
+ * @returns The release tag if found, undefined otherwise
+ */
+function extractReleaseTag(docComment) {
+    // Check for modifier tags
+    if (docComment.modifierTagSet.isPublic()) {
+        return 'public';
+    }
+    if (docComment.modifierTagSet.isBeta()) {
+        return 'beta';
+    }
+    if (docComment.modifierTagSet.isAlpha()) {
+        return 'alpha';
+    }
+    if (docComment.modifierTagSet.isInternal()) {
+        return 'internal';
+    }
+    return undefined;
+}
+/**
+ * Checks if a TSDoc comment has the @override tag.
+ *
+ * @param docComment - The parsed doc comment
+ * @returns True if @override tag is present
+ */
+function hasOverrideTag(docComment) {
+    return docComment.modifierTagSet.isOverride();
+}
+/**
+ * Checks if a TSDoc comment has the @packageDocumentation tag.
+ *
+ * @param docComment - The parsed doc comment
+ * @returns True if @packageDocumentation tag is present
+ */
+function hasPackageDocumentation(docComment) {
+    return docComment.modifierTagSet.isPackageDocumentation();
+}
+/**
+ * Checks if a comment is a block comment (TSDoc style).
+ */
+function isBlockComment(comment) {
+    // TSESTree.Comment.type is 'Line' | 'Block' - comparing to string literal
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-enum-comparison
+    return comment.type === 'Block';
+}
+/**
+ * Gets the leading comment for a node, if it's a TSDoc comment.
+ *
+ * @param sourceCode - ESLint source code object
+ * @param node - The AST node to check
+ * @returns The comment text if a TSDoc comment exists, undefined otherwise
+ */
+function getLeadingTSDocComment(sourceCode, node) {
+    const comments = sourceCode.getCommentsBefore(node);
+    if (comments.length === 0) {
+        return undefined;
+    }
+    // Get the last comment before the node (closest to it)
+    const lastComment = comments[comments.length - 1];
+    if (!lastComment) {
+        return undefined;
+    }
+    // TSDoc comments must be block comments starting with /**
+    if (!isBlockComment(lastComment)) {
+        return undefined;
+    }
+    // Check if it's a TSDoc comment (starts with *)
+    const value = lastComment.value;
+    if (!value.startsWith('*')) {
+        return undefined;
+    }
+    // Reconstruct the full comment
+    return `/*${value}*/`;
+}
+/**
+ * Finds all TSDoc comments in a source file.
+ *
+ * @param sourceCode - ESLint source code object
+ * @returns Array of comment objects with their parsed content
+ */
+function findAllTSDocComments(sourceCode) {
+    const results = [];
+    for (const comment of sourceCode.getAllComments()) {
+        if (!isBlockComment(comment) || !comment.value.startsWith('*')) {
+            continue;
+        }
+        const commentText = `/*${comment.value}*/`;
+        const parsed = parseTSDocComment(commentText);
+        results.push({ comment, parsed });
+    }
+    return results;
+}
+//# sourceMappingURL=tsdoc-parser.js.map