@savvy-web/rslib-builder 0.17.0 → 0.18.0

package/index.d.ts

@@ -135,6 +135,32 @@ export declare interface ApiModelOptions {
      *               `"include"` otherwise
      */
     forgottenExports?: "include" | "error" | "ignore";
+    /**
+     * Declarative rules for suppressing specific API Extractor warning messages.
+     *
+     * @remarks
+     * Each rule matches on `messageId` (exact), `pattern` (RegExp with substring fallback),
+     * or both (AND logic). Suppression is evaluated before `forgottenExports` and TSDoc
+     * warning handling and takes priority over both.
+     *
+     * After each entry, the number of suppressed messages is logged at info level.
+     *
+     * @example
+     * ```typescript
+     * import type { ApiModelOptions } from '@savvy-web/rslib-builder';
+     *
+     * const apiModel: ApiModelOptions = {
+     *   forgottenExports: 'error',
+     *   suppressWarnings: [
+     *     // Suppress forgotten-export for Effect _base symbols
+     *     { messageId: 'ae-forgotten-export', pattern: '_base' },
+     *     // Suppress a specific TSDoc warning category
+     *     { messageId: 'tsdoc-param-tag-missing-hyphen' },
+     *   ],
+     * };
+     * ```
+     */
+    suppressWarnings?: WarningSuppressionRule[];
 }
 
 /**
@@ -3373,4 +3399,29 @@ export declare class TsconfigResolver {
         virtualEntryNames: Set<string>;
     }
 
+    /**
+     * A declarative rule for suppressing a specific API Extractor warning message.
+     *
+     * @remarks
+     * Both `messageId` and `pattern` must match when both are specified (AND logic).
+     * Specify at least one field per rule — a rule with neither field matches all messages.
+     *
+     * `pattern` is first tried as a RegExp. If the string is not a valid regular
+     * expression it falls back to substring matching.
+     *
+     * @public
+     */
+    export declare interface WarningSuppressionRule {
+        /**
+         * Exact match against the message's `messageId` property
+         * (e.g., `"ae-forgotten-export"`, `"tsdoc-param-tag-missing-hyphen"`).
+         */
+        messageId?: string;
+        /**
+         * Pattern matched against the message's `text` property.
+         * Tried as a RegExp first; falls back to case-sensitive substring match.
+         */
+        pattern?: string;
+    }
+
     export { }

package/index.js

@@ -597,6 +597,34 @@ const TSConfigs = {
         }
     }
 };
+function compileRule(rule) {
+    let regex = null;
+    let literal;
+    if (void 0 !== rule.pattern) try {
+        regex = new RegExp(rule.pattern);
+    } catch  {
+        literal = rule.pattern;
+    }
+    return {
+        messageId: rule.messageId,
+        regex,
+        literal
+    };
+}
+function matchesCompiled(rule, messageId, text) {
+    if (void 0 !== rule.messageId && messageId !== rule.messageId) return false;
+    if (null !== rule.regex) return rule.regex.test(text ?? "");
+    if (void 0 !== rule.literal) return (text ?? "").includes(rule.literal);
+    return true;
+}
+function createMessageSuppressor(rules) {
+    const compiled = rules.map(compileRule);
+    return {
+        matches (messageId, text) {
+            return compiled.some((rule)=>matchesCompiled(rule, messageId, text));
+        }
+    };
+}
 class TsconfigResolverError extends Error {
     option;
     value;
@@ -1120,6 +1148,8 @@ async function bundleDtsFiles(options) {
     const tsdocMetadataOption = "object" == typeof apiModel ? apiModel.tsdocMetadata : void 0;
     const tsdocWarnings = tsdocOptions?.warnings ?? (TsDocConfigBuilder.isCI() ? "fail" : "log");
     const forgottenExports = ("object" == typeof apiModel ? apiModel.forgottenExports : void 0) ?? (TsDocConfigBuilder.isCI() ? "error" : "include");
+    const suppressWarnings = "object" == typeof apiModel ? apiModel.suppressWarnings ?? [] : [];
+    const suppressor = createMessageSuppressor(suppressWarnings);
     const tsdocMetadataEnabled = apiModelEnabled && (void 0 === tsdocMetadataOption || true === tsdocMetadataOption || "object" == typeof tsdocMetadataOption && false !== tsdocMetadataOption.enabled);
     const tsdocMetadataFilename = resolveTsdocMetadataFilename(apiModel);
     getApiExtractorPath();
@@ -1196,10 +1226,16 @@ async function bundleDtsFiles(options) {
         const extractorConfig = ExtractorConfig.prepare(prepareOptions);
         const collectedTsdocWarnings = [];
         const collectedForgottenExports = [];
+        const suppressedMessages = [];
         const extractorResult = Extractor.invoke(extractorConfig, {
             localBuild: true,
             showVerboseMessages: false,
             messageCallback: (message)=>{
+                if (suppressor.matches(message.messageId, message.text)) {
+                    message.logLevel = ExtractorLogLevel.None;
+                    suppressedMessages.push(`[${message.messageId ?? "unknown"}] ${message.text ?? ""}`);
+                    return;
+                }
                 if (message.text?.includes("Analysis will use the bundled TypeScript version") || message.text?.includes("The target project appears to use TypeScript")) {
                     message.logLevel = ExtractorLogLevel.None;
                     return;
@@ -1244,6 +1280,10 @@ async function bundleDtsFiles(options) {
             }
         });
         if (!extractorResult.succeeded) throw new Error(`API Extractor failed for entry "${entryName}"`);
+        if (suppressedMessages.length > 0) {
+            const list = suppressedMessages.map((t)=>`  ${picocolors.dim(t)}`).join("\n");
+            core_logger.info(`Suppressed ${suppressedMessages.length} API Extractor message${1 === suppressedMessages.length ? "" : "s"} for entry "${entryName}":\n${list}`);
+        }
         const formatWarning = (warning)=>{
             const location = warning.sourceFilePath ? `${picocolors.cyan(relative(cwd, warning.sourceFilePath))}${warning.sourceFileLine ? `:${warning.sourceFileLine}` : ""}${warning.sourceFileColumn ? `:${warning.sourceFileColumn}` : ""}` : null;
             return location ? `${location}: ${picocolors.yellow(warning.text)}` : picocolors.yellow(warning.text);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@savvy-web/rslib-builder",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "private": false,
   "description": "RSlib-based build system for Node.js libraries with automatic package.json transformation, TypeScript declaration bundling, and multi-target support",
   "keywords": [