@savvy-web/rslib-builder 0.8.0 → 0.9.0

package/index.d.ts

@@ -56,9 +56,12 @@ import ts from 'typescript';
 
 /**
  * Options for API model generation.
- * When enabled, generates an `<unscopedPackageName>.api.json` file using API Extractor.
+ * Generates an `<unscopedPackageName>.api.json` file using API Extractor.
  *
  * @remarks
+ * API model generation is enabled by default. To disable, set `apiModel: false`.
+ * Providing an options object implicitly enables API model generation.
+ *
  * API models are only generated for the main "index" entry point (the "." export).
  * Additional entry points like "./hooks" or "./utils" do not generate separate API models.
  * This prevents multiple conflicting API models and ensures a single source of truth
@@ -67,11 +70,6 @@ import ts from 'typescript';
  * @public
  */
 export declare interface ApiModelOptions {
-    /**
-     * Whether to enable API model generation.
-     * @defaultValue false
-     */
-    enabled?: boolean;
     /**
      * Filename for the generated API model file.
      * @defaultValue `<unscopedPackageName>.api.json` (e.g., `rslib-builder.api.json`)
@@ -94,7 +92,6 @@ export declare interface ApiModelOptions {
      * import type { ApiModelOptions } from '@savvy-web/rslib-builder';
      *
      * const apiModel: ApiModelOptions = {
-     *   enabled: true,
      *   localPaths: ['../docs-site/lib/packages/my-package'],
      * };
      * ```
@@ -114,7 +111,6 @@ export declare interface ApiModelOptions {
      * import type { ApiModelOptions } from '@savvy-web/rslib-builder';
      *
      * const apiModel: ApiModelOptions = {
-     *   enabled: true,
      *   tsdoc: {
      *     tagDefinitions: [{ tagName: '@error', syntaxKind: 'inline' }],
      *   },
@@ -132,11 +128,12 @@ export declare interface ApiModelOptions {
      * A forgotten export occurs when a public API references a declaration
      * that isn't exported from the entry point.
      *
-     * - `"include"` (default): Log a warning, include in the API model
+     * - `"include"`: Log a warning, include in the API model
      * - `"error"`: Fail the build with details about the forgotten exports
      * - `"ignore"`: Turn off detection — suppress all messages
      *
-     * @defaultValue "include"
+     * @defaultValue `"error"` in CI environments (`CI` or `GITHUB_ACTIONS` env vars),
+     *               `"include"` otherwise
      */
     forgottenExports?: "include" | "error" | "ignore";
 }
@@ -1108,7 +1105,6 @@ export declare type LiteralUnion<LiteralType, BaseType extends Primitive> = Lite
  * export default NodeLibraryBuilder.create({
  *   externals: ['@rslib/core', '@rsbuild/core'],
  *   dtsBundledPackages: ['picocolors'],
- *   apiModel: true,
  *   transform({ target, pkg }) {
  *     if (target === 'npm') {
  *       delete pkg.devDependencies;
@@ -1140,7 +1136,14 @@ export declare class NodeLibraryBuilder {
      * These defaults are merged with user-provided options in {@link NodeLibraryBuilder.mergeOptions}.
      * Arrays are deep-copied to prevent mutation of this object.
      */
-    static readonly DEFAULT_OPTIONS: NodeLibraryBuilderOptions;
+    static readonly DEFAULT_OPTIONS: {
+        plugins: never[];
+        define: {};
+        copyPatterns: never[];
+        targets: ("dev" | "npm")[];
+        externals: never[];
+        apiModel: true;
+    };
     /**
      * Merges user-provided options with default options.
      *
@@ -1316,74 +1319,39 @@ export declare interface NodeLibraryBuilderOptions {
     transform?: TransformPackageJsonFn;
     /**
      * Options for API model generation.
-     * When enabled, generates an `<unscopedPackageName>.api.json` file in the dist directory.
+     * Generates an `<unscopedPackageName>.api.json` file in the dist directory.
      * Only applies when target is "npm".
      *
      * @remarks
-     * The generated API model file contains the full API documentation
-     * in a machine-readable format for use by documentation generators.
+     * API model generation is **enabled by default**. The generated file contains
+     * full API documentation in a machine-readable format for documentation generators.
      * The file is emitted to dist but excluded from npm publish (added as negated pattern in `files` array).
      *
+     * @defaultValue true
+     *
      * @example
-     * Enable API model generation with defaults:
+     * Disable API model generation:
      * ```typescript
      * import { NodeLibraryBuilder } from '@savvy-web/rslib-builder';
      *
      * export default NodeLibraryBuilder.create({
-     *   apiModel: true,
+     *   apiModel: false,
      * });
      * ```
      *
      * @example
-     * Enable with custom filename:
+     * Customize with options (implicitly enabled):
      * ```typescript
      * import { NodeLibraryBuilder } from '@savvy-web/rslib-builder';
      *
      * export default NodeLibraryBuilder.create({
      *   apiModel: {
-     *     enabled: true,
      *     filename: 'my-package.api.json',
      *   },
      * });
      * ```
      */
     apiModel?: ApiModelOptions | boolean;
-    /**
-     * Options for TSDoc lint validation.
-     * When enabled, validates TSDoc comments before the build starts.
-     *
-     * @remarks
-     * Uses ESLint with `eslint-plugin-tsdoc` to validate TSDoc syntax.
-     * By default, throws errors in CI environments and logs errors locally.
-     * The generated `tsdoc.json` config is persisted locally for IDE integration.
-     *
-     * @example
-     * Enable with defaults (throws in CI, errors locally):
-     * ```typescript
-     * import { NodeLibraryBuilder } from '@savvy-web/rslib-builder';
-     *
-     * export default NodeLibraryBuilder.create({
-     *   tsdocLint: true,
-     * });
-     * ```
-     *
-     * @example
-     * Enable with custom configuration:
-     * ```typescript
-     * import { NodeLibraryBuilder } from '@savvy-web/rslib-builder';
-     *
-     * export default NodeLibraryBuilder.create({
-     *   tsdocLint: {
-     *     tsdoc: {
-     *       tagDefinitions: [{ tagName: '@error', syntaxKind: 'block' }],
-     *     },
-     *     onError: 'throw',
-     *     persistConfig: true,
-     *   },
-     * });
-     * ```
-     */
-    tsdocLint?: TsDocLintPluginOptions | boolean;
 }
 
 /**
@@ -2567,9 +2535,14 @@ export declare class TsconfigResolver {
          *
          * In CI environments (`CI` or `GITHUB_ACTIONS` env vars set to "true"),
          * this method validates the existing file instead of writing, throwing
-         * an error if the config is out of date.
+         * an error if the config is out of date. Set `skipCIValidation` to true
+         * to skip this validation (useful when `persistConfig: false`).
+         *
+         * @param options - TSDoc configuration options
+         * @param outputDir - Directory to write the config file
+         * @param skipCIValidation - Skip CI validation even in CI environments
          */
-        static writeConfigFile(options: TsDocOptions | undefined, outputDir: string): Promise<string>;
+        static writeConfigFile(options: TsDocOptions | undefined, outputDir: string, skipCIValidation?: boolean): Promise<string>;
         /** Converts TSDocTagSyntaxKind enum to string format. */
         private static syntaxKindToString;
     }
@@ -2586,6 +2559,54 @@ export declare class TsconfigResolver {
      */
     export declare type TsDocLintErrorBehavior = "warn" | "error" | "throw";
 
+    /**
+     * Options for TSDoc lint validation (subset of TsDocLintPluginOptions).
+     * TSDoc configuration is inherited from the parent TsDocOptions.
+     *
+     * @public
+     */
+    export declare interface TsDocLintOptions {
+        /**
+         * Override automatic file discovery with explicit file paths or glob patterns.
+         *
+         * @remarks
+         * By default, uses import graph analysis to discover files from your package's exports.
+         * This ensures only public API files are linted.
+         *
+         * @example
+         * ```typescript
+         * lint: {
+         *   include: ["src/**\/*.ts", "!**\/*.test.ts"],
+         * }
+         * ```
+         */
+        include?: string[];
+        /**
+         * How to handle TSDoc lint errors.
+         * - `"warn"`: Log warnings but continue the build
+         * - `"error"`: Log errors but continue the build
+         * - `"throw"`: Fail the build with an error
+         *
+         * @defaultValue `"throw"` in CI environments, `"error"` locally
+         */
+        onError?: TsDocLintErrorBehavior;
+        /**
+         * Persist tsdoc.json to disk for tool integration (ESLint, IDEs).
+         * - `true`: Write to project root as "tsdoc.json" (or validate in CI)
+         * - `PathLike`: Write to specified path (or validate in CI)
+         * - `false`: Clean up after linting (not recommended)
+         *
+         * @remarks
+         * In CI environments (`CI` or `GITHUB_ACTIONS` env vars set to "true"),
+         * the config file is validated instead of written. If the existing file
+         * doesn't match the expected configuration, the build fails with an error
+         * instructing the developer to regenerate the file locally.
+         *
+         * @defaultValue `true`
+         */
+        persistConfig?: boolean | PathLike;
+    }
+
     /**
      * Creates a plugin to validate TSDoc comments before build using ESLint with eslint-plugin-tsdoc.
      *
@@ -2815,21 +2836,6 @@ export declare class TsconfigResolver {
          * ```
          */
         supportForTags?: Record<string, boolean>;
-        /**
-         * Persist tsdoc.json to disk for tool integration (ESLint, IDEs).
-         * - `true`: Write to project root as "tsdoc.json" (or validate in CI)
-         * - `PathLike`: Write to specified path (or validate in CI)
-         * - `false`: Clean up after API Extractor (not recommended)
-         *
-         * @remarks
-         * In CI environments (`CI` or `GITHUB_ACTIONS` env vars set to "true"),
-         * the config file is validated instead of written. If the existing file
-         * doesn't match the expected configuration, the build fails with an error
-         * instructing the developer to regenerate the file locally.
-         *
-         * @defaultValue `true`
-         */
-        persistConfig?: boolean | PathLike;
         /**
          * How to handle TSDoc validation warnings from API Extractor.
          * - `"log"`: Show warnings in the console but continue the build
@@ -2849,6 +2855,42 @@ export declare class TsconfigResolver {
          *               `"log"` otherwise
          */
         warnings?: "log" | "fail" | "none";
+        /**
+         * TSDoc lint validation options.
+         * Validates TSDoc comments before the build starts using ESLint.
+         *
+         * @remarks
+         * Lint validation is **enabled by default**. Set to `false` to disable.
+         * When enabled, it uses the parent TSDoc configuration (tagDefinitions, groups, etc.)
+         * for validation rules.
+         *
+         * @defaultValue true
+         *
+         * @example
+         * Disable lint validation:
+         * ```typescript
+         * apiModel: {
+         *   tsdoc: {
+         *     lint: false,
+         *   },
+         * }
+         * ```
+         *
+         * @example
+         * Customize lint behavior:
+         * ```typescript
+         * apiModel: {
+         *   tsdoc: {
+         *     tagDefinitions: [{ tagName: '@error', syntaxKind: 'inline' }],
+         *     lint: {
+         *       onError: 'throw',
+         *       include: ['src/**\/*.ts'],
+         *     },
+         *   },
+         * }
+         * ```
+         */
+        lint?: TsDocLintOptions | boolean;
     }
 
     /**

package/index.js

@@ -205,9 +205,9 @@ const AutoEntryPlugin = (options)=>{
                 try {
                     const packageJsonContent = await readFile(assetPath, "utf-8");
                     const packageJson = JSON.parse(packageJsonContent);
-                    const { entries } = extractEntriesFromPackageJson(packageJson, {
-                        exportsAsIndexes: options?.exportsAsIndexes
-                    });
+                    const { entries } = extractEntriesFromPackageJson(packageJson, options?.exportsAsIndexes != null ? {
+                        exportsAsIndexes: options.exportsAsIndexes
+                    } : void 0);
                     if (options?.exportsAsIndexes && packageJson.exports) {
                         const exports = packageJson.exports;
                         if ("object" == typeof exports && !Array.isArray(exports)) for (const pkgExportKey of Object.keys(exports)){
@@ -255,7 +255,7 @@ const AutoEntryPlugin = (options)=>{
         }
     };
 };
-var lib_namespaceObject = JSON.parse('{"$schema":"https://json.schemastore.org/tsconfig.json","compilerOptions":{"allowSyntheticDefaultImports":true,"composite":true,"declaration":true,"declarationDir":"${configDir}/dist","declarationMap":false,"emitDeclarationOnly":false,"esModuleInterop":true,"explainFiles":false,"forceConsistentCasingInFileNames":true,"incremental":true,"isolatedDeclarations":false,"isolatedModules":true,"jsx":"preserve","lib":["esnext"],"module":"nodenext","moduleResolution":"nodenext","outDir":"${configDir}/dist","resolveJsonModule":true,"rootDir":"${configDir}","skipLibCheck":true,"sourceMap":false,"strict":true,"strictNullChecks":true,"target":"es2023","tsBuildInfoFile":"${configDir}/dist/.tsbuildinfo.lib","typeRoots":["${configDir}/node_modules/@types","${configDir}/types"],"verbatimModuleSyntax":true},"exclude":["${configDir}/node_modules","${configDir}/dist/**/*"],"include":["${configDir}/types/*.ts","${configDir}/package.json","${configDir}/*.ts","${configDir}/*.cts","${configDir}/*.mts","${configDir}/src/**/*.ts","${configDir}/src/**/*.tsx","${configDir}/src/**/*.cts","${configDir}/src/**/*.mts","${configDir}/lib/**/*.ts","${configDir}/lib/**/*.tsx","${configDir}/lib/**/*.cts","${configDir}/lib/**/*.mts","${configDir}/public/**/*.json"]}');
+var lib_namespaceObject = JSON.parse('{"$schema":"https://json.schemastore.org/tsconfig.json","compilerOptions":{"allowSyntheticDefaultImports":true,"composite":true,"declaration":true,"declarationDir":"${configDir}/dist","declarationMap":false,"emitDeclarationOnly":false,"esModuleInterop":true,"explainFiles":false,"forceConsistentCasingInFileNames":true,"incremental":true,"isolatedDeclarations":false,"isolatedModules":true,"exactOptionalPropertyTypes":true,"jsx":"preserve","lib":["esnext"],"module":"nodenext","moduleResolution":"nodenext","outDir":"${configDir}/dist","resolveJsonModule":true,"rootDir":"${configDir}","skipLibCheck":true,"sourceMap":false,"strict":true,"strictNullChecks":true,"target":"es2023","tsBuildInfoFile":"${configDir}/dist/.tsbuildinfo.lib","typeRoots":["${configDir}/node_modules/@types","${configDir}/types"],"verbatimModuleSyntax":true},"exclude":["${configDir}/node_modules","${configDir}/dist/**/*"],"include":["${configDir}/types/*.ts","${configDir}/package.json","${configDir}/*.ts","${configDir}/*.cts","${configDir}/*.mts","${configDir}/src/**/*.ts","${configDir}/src/**/*.tsx","${configDir}/src/**/*.cts","${configDir}/src/**/*.mts","${configDir}/lib/**/*.ts","${configDir}/lib/**/*.tsx","${configDir}/lib/**/*.cts","${configDir}/lib/**/*.mts","${configDir}/public/**/*.json"]}');
 const requireCJS = createRequire(import.meta.url);
 const jsonImports = new Map([
     [
@@ -320,28 +320,43 @@ class LibraryTSConfigFile extends TSConfigFile {
                 outDir: "dist",
                 tsBuildInfoFile: `${process.cwd()}/dist/.tsbuildinfo.${target}.bundle`
             },
-            include
+            ...void 0 !== include && include.length > 0 ? {
+                include
+            } : {}
         };
     }
-    writeBundleTempConfig(target) {
+    writeBundleTempConfig(_target) {
         const cwd = process.cwd();
-        const config = this.bundle(target);
-        const toAbsolute = (path)=>{
-            if (path.startsWith("../") || ".." === path) return path.replace(/^((\.\.\/)+\.\.?|\.\.\/*)$/, cwd).replace(/^(\.\.\/)+/, `${cwd}/`);
-            return path;
-        };
+        const baseConfig = this.config;
         const absoluteConfig = {
-            ...config,
+            $schema: "https://json.schemastore.org/tsconfig.json",
             compilerOptions: {
-                ...config.compilerOptions,
+                ...baseConfig.compilerOptions,
+                composite: false,
+                incremental: false,
+                tsBuildInfoFile: void 0,
                 rootDir: cwd,
+                outDir: join(cwd, "dist"),
+                declarationDir: join(cwd, "dist"),
+                typeRoots: [
+                    join(cwd, "node_modules/@types"),
+                    join(cwd, "types")
+                ],
                 declarationMap: true,
-                emitDeclarationOnly: false,
-                declarationDir: config.compilerOptions?.declarationDir ? toAbsolute(config.compilerOptions.declarationDir) : void 0,
-                typeRoots: config.compilerOptions?.typeRoots?.map(toAbsolute)
+                emitDeclarationOnly: false
             },
-            include: config.include?.map(toAbsolute),
-            exclude: config.exclude?.map(toAbsolute)
+            include: [
+                join(cwd, "src/**/*.ts"),
+                join(cwd, "src/**/*.mts"),
+                join(cwd, "src/**/*.tsx"),
+                join(cwd, "src/**/*.json"),
+                join(cwd, "types/*.ts"),
+                join(cwd, "package.json")
+            ],
+            exclude: [
+                join(cwd, "node_modules"),
+                join(cwd, "dist/**/*")
+            ]
         };
         const tmpFile = requireCJS("tmp").fileSync({
             prefix: "tsconfig-bundle-",
@@ -365,8 +380,8 @@ class TsconfigResolverError extends Error {
     constructor(message, option, value){
         super(message);
         this.name = "TsconfigResolverError";
-        this.option = option;
-        this.value = value;
+        if (void 0 !== option) this.option = option;
+        if (void 0 !== value) this.value = value;
     }
 }
 const TSCONFIG_SCHEMA_URL = "https://json.schemastore.org/tsconfig";
@@ -786,9 +801,9 @@ class TsDocConfigBuilder {
             strict: true
         })) throw new Error(`tsdoc.json is out of date. Run the build locally to regenerate it, then commit the changes.\nExpected:\n${JSON.stringify(expectedConfig, null, 2)}\n\nActual:\n${JSON.stringify(existingConfig, null, 2)}`);
     }
-    static async writeConfigFile(options = {}, outputDir) {
+    static async writeConfigFile(options = {}, outputDir, skipCIValidation = false) {
         const configPath = join(outputDir, "tsdoc.json");
-        if (TsDocConfigBuilder.isCI()) {
+        if (TsDocConfigBuilder.isCI() && !skipCIValidation) {
             await TsDocConfigBuilder.validateConfigFile(options, configPath);
             return configPath;
         }
@@ -869,25 +884,27 @@ async function bundleDtsFiles(options) {
     const bundledFiles = new Map();
     let apiModelPath;
     let tsdocMetadataPath;
-    const apiModelEnabled = true === apiModel || "object" == typeof apiModel && (void 0 === apiModel.enabled || true === apiModel.enabled);
+    const apiModelEnabled = true === apiModel || "object" == typeof apiModel;
     const apiModelFilename = "object" == typeof apiModel && apiModel.filename ? apiModel.filename : "api.json";
     const tsdocOptions = "object" == typeof apiModel ? apiModel.tsdoc : void 0;
     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) ?? "include";
+    const forgottenExports = ("object" == typeof apiModel ? apiModel.forgottenExports : void 0) ?? (TsDocConfigBuilder.isCI() ? "error" : "include");
     const tsdocMetadataEnabled = apiModelEnabled && (void 0 === tsdocMetadataOption || true === tsdocMetadataOption || "object" == typeof tsdocMetadataOption && false !== tsdocMetadataOption.enabled);
     const tsdocMetadataFilename = "object" == typeof tsdocMetadataOption && tsdocMetadataOption.filename ? tsdocMetadataOption.filename : "tsdoc-metadata.json";
     getApiExtractorPath();
-    const persistConfig = tsdocOptions?.persistConfig;
+    const lintConfig = "object" == typeof tsdocOptions?.lint ? tsdocOptions.lint : void 0;
+    const persistConfig = lintConfig?.persistConfig;
     const tsdocConfigOutputPath = TsDocConfigBuilder.getConfigPath(persistConfig, cwd);
+    const skipCIValidation = false === persistConfig;
     let tsdocConfigPath;
     let tsdocConfigFile;
     if (apiModelEnabled) {
-        tsdocConfigPath = await TsDocConfigBuilder.writeConfigFile(tsdocOptions ?? {}, dirname(tsdocConfigOutputPath));
+        tsdocConfigPath = await TsDocConfigBuilder.writeConfigFile(tsdocOptions ?? {}, dirname(tsdocConfigOutputPath), skipCIValidation);
         const { TSDocConfigFile } = await import("@microsoft/tsdoc-config");
         tsdocConfigFile = TSDocConfigFile.loadForFolder(dirname(tsdocConfigPath));
     }
-    const { Extractor, ExtractorConfig } = await import("@microsoft/api-extractor");
+    const { Extractor, ExtractorConfig, ExtractorMessage, ExtractorLogLevel } = await import("@microsoft/api-extractor");
     for (const [entryName, sourcePath] of entryPoints){
         const normalizedSourcePath = sourcePath.replace(/^\.\//, "");
         const dtsFileName = normalizedSourcePath.replace(/\.(tsx?|jsx?)$/, ".d.ts");
@@ -910,7 +927,7 @@ async function bundleDtsFiles(options) {
         const tempApiModelPath = generateApiModel ? join(tempOutputDir, apiModelFilename) : void 0;
         const generateTsdocMetadata = tsdocMetadataEnabled && "index" === entryName;
         const tempTsdocMetadataPath = generateTsdocMetadata ? join(tempOutputDir, tsdocMetadataFilename) : void 0;
-        const extractorConfig = ExtractorConfig.prepare({
+        const prepareOptions = {
             configObject: {
                 projectFolder: cwd,
                 mainEntryPointFilePath: tempDtsPath,
@@ -922,20 +939,29 @@ async function bundleDtsFiles(options) {
                     enabled: true,
                     untrimmedFilePath: tempBundledPath
                 },
-                docModel: generateApiModel ? {
-                    enabled: true,
-                    apiJsonFilePath: tempApiModelPath
-                } : void 0,
-                tsdocMetadata: generateTsdocMetadata ? {
-                    enabled: true,
-                    tsdocMetadataFilePath: tempTsdocMetadataPath
-                } : void 0,
+                ...generateApiModel && {
+                    docModel: {
+                        enabled: true,
+                        ...tempApiModelPath && {
+                            apiJsonFilePath: tempApiModelPath
+                        }
+                    }
+                },
+                ...generateTsdocMetadata && {
+                    tsdocMetadata: {
+                        enabled: true,
+                        ...tempTsdocMetadataPath && {
+                            tsdocMetadataFilePath: tempTsdocMetadataPath
+                        }
+                    }
+                },
                 bundledPackages: bundledPackages
             },
             packageJsonFullPath: join(cwd, "package.json"),
-            configObjectFullPath: void 0,
-            tsdocConfigFile: tsdocConfigFile
-        });
+            configObjectFullPath: void 0
+        };
+        if (tsdocConfigFile) prepareOptions.tsdocConfigFile = tsdocConfigFile;
+        const extractorConfig = ExtractorConfig.prepare(prepareOptions);
         const collectedTsdocWarnings = [];
         const collectedForgottenExports = [];
         const extractorResult = Extractor.invoke(extractorConfig, {
@@ -943,33 +969,45 @@ async function bundleDtsFiles(options) {
             showVerboseMessages: false,
             messageCallback: (message)=>{
                 if (message.text?.includes("Analysis will use the bundled TypeScript version") || message.text?.includes("The target project appears to use TypeScript")) {
-                    message.logLevel = "none";
+                    message.logLevel = ExtractorLogLevel.None;
                     return;
                 }
                 if (message.text?.includes("You have changed the public API signature")) {
-                    message.logLevel = "none";
+                    message.logLevel = ExtractorLogLevel.None;
                     return;
                 }
                 const isTsdocMessage = message.messageId?.startsWith("tsdoc-");
-                if (isTsdocMessage && message.text) if ("none" === tsdocWarnings) message.logLevel = "none";
+                if (isTsdocMessage && message.text) if ("none" === tsdocWarnings) message.logLevel = ExtractorLogLevel.None;
                 else {
                     collectedTsdocWarnings.push({
                         text: message.text,
-                        sourceFilePath: message.sourceFilePath,
-                        sourceFileLine: message.sourceFileLine,
-                        sourceFileColumn: message.sourceFileColumn
+                        ...null != message.sourceFilePath && {
+                            sourceFilePath: message.sourceFilePath
+                        },
+                        ...null != message.sourceFileLine && {
+                            sourceFileLine: message.sourceFileLine
+                        },
+                        ...null != message.sourceFileColumn && {
+                            sourceFileColumn: message.sourceFileColumn
+                        }
                     });
-                    message.logLevel = "none";
+                    message.logLevel = ExtractorLogLevel.None;
                 }
-                if ("ae-forgotten-export" === message.messageId && message.text) if ("ignore" === forgottenExports) message.logLevel = "none";
+                if ("ae-forgotten-export" === message.messageId && message.text) if ("ignore" === forgottenExports) message.logLevel = ExtractorLogLevel.None;
                 else {
                     collectedForgottenExports.push({
                         text: message.text,
-                        sourceFilePath: message.sourceFilePath,
-                        sourceFileLine: message.sourceFileLine,
-                        sourceFileColumn: message.sourceFileColumn
+                        ...null != message.sourceFilePath && {
+                            sourceFilePath: message.sourceFilePath
+                        },
+                        ...null != message.sourceFileLine && {
+                            sourceFileLine: message.sourceFileLine
+                        },
+                        ...null != message.sourceFileColumn && {
+                            sourceFileColumn: message.sourceFileColumn
+                        }
                     });
-                    message.logLevel = "none";
+                    message.logLevel = ExtractorLogLevel.None;
                 }
             }
         });
@@ -1009,9 +1047,15 @@ async function bundleDtsFiles(options) {
     }
     return {
         bundledFiles,
-        apiModelPath,
-        tsdocMetadataPath,
-        tsdocConfigPath
+        ...apiModelPath && {
+            apiModelPath
+        },
+        ...tsdocMetadataPath && {
+            tsdocMetadataPath
+        },
+        ...tsdocConfigPath && {
+            tsdocConfigPath
+        }
     };
 }
 function stripSourceMapComment(content) {
@@ -1045,8 +1089,12 @@ function runTsgo(options) {
     const args = generateTsgoArgs({
         configPath,
         declarationDir,
-        rootDir,
-        tsBuildInfoFile
+        ...rootDir && {
+            rootDir
+        },
+        ...tsBuildInfoFile && {
+            tsBuildInfoFile
+        }
     });
     return new Promise((resolve)=>{
         const child = spawn(tsgoBinPath, args, {
@@ -1098,17 +1146,16 @@ function runTsgo(options) {
                 const log = createEnvLogger("dts");
                 const cwd = api.context.rootPath;
                 try {
-                    let configTsconfigPath = options.tsconfigPath || config.source?.tsconfigPath;
-                    if (!configTsconfigPath && options.buildTarget) {
+                    let configTsconfigPath = options.tsconfigPath;
+                    if (options.buildTarget) {
                         const originalCwd = process.cwd();
                         try {
                             process.chdir(cwd);
                             configTsconfigPath = TSConfigs.node.ecma.lib.writeBundleTempConfig(options.buildTarget);
-                            log.global.info(`Using tsconfig: ${configTsconfigPath}`);
                         } finally{
                             process.chdir(originalCwd);
                         }
-                    }
+                    } else if (!configTsconfigPath) configTsconfigPath = config.source?.tsconfigPath;
                     state.tsconfigPath = findTsConfig(cwd, configTsconfigPath);
                     if (!state.tsconfigPath) {
                         const error = new Error(`Failed to resolve tsconfig file ${picocolors.cyan(`"${config.source?.tsconfigPath ?? "tsconfig.json"}"`)} from ${picocolors.cyan(cwd)}. Please ensure that the file exists.`);
@@ -1137,8 +1184,12 @@ function runTsgo(options) {
                     const { success, output } = await runTsgo({
                         configPath: state.tsconfigPath,
                         declarationDir: tempDtsDir,
-                        rootDir: state.parsedConfig.options.rootDir,
-                        tsBuildInfoFile: state.parsedConfig.options.tsBuildInfoFile,
+                        ...state.parsedConfig.options.rootDir && {
+                            rootDir: state.parsedConfig.options.rootDir
+                        },
+                        ...state.parsedConfig.options.tsBuildInfoFile && {
+                            tsBuildInfoFile: state.parsedConfig.options.tsBuildInfoFile
+                        },
                         name: envId
                     });
                     if (!success) {
@@ -1218,9 +1269,15 @@ function runTsgo(options) {
                                 tsconfigPath: state.tsconfigPath,
                                 bundledPackages: options.bundledPackages || [],
                                 entryPoints,
-                                banner: options.banner,
-                                footer: options.footer,
-                                apiModel: options.apiModel
+                                ...options.banner && {
+                                    banner: options.banner
+                                },
+                                ...options.footer && {
+                                    footer: options.footer
+                                },
+                                ...void 0 !== options.apiModel && {
+                                    apiModel: options.apiModel
+                                }
                             });
                             let emittedCount = 0;
                             for (const [entryName, tempBundledPath] of bundledFiles){
@@ -1742,7 +1799,10 @@ function applyRslibTransformations(packageJson, originalPackageJson, processTSEx
         private: isPrivate
     };
     if (processedManifest.exports) processedManifest.exports = transformPackageExports(processedManifest.exports, processTSExports, void 0, entrypoints, exportToOutputMap, bundle ?? false);
-    if (processedManifest.bin) processedManifest.bin = transformPackageBin(processedManifest.bin, processTSExports);
+    if (processedManifest.bin) {
+        const transformedBin = transformPackageBin(processedManifest.bin, processTSExports);
+        if (transformedBin) processedManifest.bin = transformedBin;
+    }
     if (originalPackageJson.typesVersions) {
         const transformedTypesVersions = {};
         for (const [version, paths] of Object.entries(originalPackageJson.typesVersions)){
@@ -2091,7 +2151,8 @@ async function runTsDocLint(options, cwd) {
     const persistConfig = options.persistConfig;
     const shouldPersist = TsDocConfigBuilder.shouldPersist(persistConfig);
     const tsdocConfigOutputPath = TsDocConfigBuilder.getConfigPath(persistConfig, cwd);
-    const tsdocConfigPath = await TsDocConfigBuilder.writeConfigFile(tsdocOptions, dirname(tsdocConfigOutputPath));
+    const skipCIValidation = false === persistConfig;
+    const tsdocConfigPath = await TsDocConfigBuilder.writeConfigFile(tsdocOptions, dirname(tsdocConfigOutputPath), skipCIValidation);
     const eslintModule = await import("eslint");
     const tsParserModule = await import("@typescript-eslint/parser");
     const tsdocPluginModule = await import("eslint-plugin-tsdoc");
@@ -2105,8 +2166,12 @@ async function runTsDocLint(options, cwd) {
             warningCount: 0,
             messages: []
         },
-        tsdocConfigPath: shouldPersist ? tsdocConfigPath : void 0,
-        discoveryErrors: discovery.errors
+        ...shouldPersist && {
+            tsdocConfigPath
+        },
+        ...discovery.errors.length > 0 && {
+            discoveryErrors: discovery.errors
+        }
     };
     let eslintConfig;
     let filesToLint;
@@ -2189,8 +2254,12 @@ async function runTsDocLint(options, cwd) {
             warningCount,
             messages
         },
-        tsdocConfigPath: shouldPersist ? tsdocConfigPath : void 0,
-        discoveryErrors: discovery.errors.length > 0 ? discovery.errors : void 0
+        ...shouldPersist && {
+            tsdocConfigPath
+        },
+        ...discovery.errors.length > 0 && {
+            discoveryErrors: discovery.errors
+        }
     };
 }
 async function cleanupTsDocConfig(configPath) {
@@ -2239,7 +2308,6 @@ const TsDocLintPlugin = (options = {})=>{
         "npm"
     ];
     static DEFAULT_OPTIONS = {
-        entry: void 0,
         plugins: [],
         define: {},
         copyPatterns: [],
@@ -2247,25 +2315,42 @@ const TsDocLintPlugin = (options = {})=>{
             "dev",
             "npm"
         ],
-        tsconfigPath: void 0,
         externals: [],
-        dtsBundledPackages: void 0,
-        transformFiles: void 0,
-        tsdocLint: void 0
+        apiModel: true
     };
     static mergeOptions(options = {}) {
-        const merged = {
-            ...NodeLibraryBuilder.DEFAULT_OPTIONS,
-            ...options,
-            copyPatterns: [
-                ...options.copyPatterns ?? NodeLibraryBuilder.DEFAULT_OPTIONS.copyPatterns
-            ]
-        };
-        if (existsSync(join(process.cwd(), "public"))) merged.copyPatterns.unshift({
+        const copyPatterns = [
+            ...options.copyPatterns ?? NodeLibraryBuilder.DEFAULT_OPTIONS.copyPatterns
+        ];
+        if (existsSync(join(process.cwd(), "public"))) copyPatterns.unshift({
             from: "./public",
             to: "./",
             context: process.cwd()
         });
+        const merged = {
+            copyPatterns,
+            plugins: options.plugins ?? NodeLibraryBuilder.DEFAULT_OPTIONS.plugins,
+            define: options.define ?? NodeLibraryBuilder.DEFAULT_OPTIONS.define,
+            tsconfigPath: options.tsconfigPath,
+            targets: options.targets ?? NodeLibraryBuilder.DEFAULT_OPTIONS.targets,
+            externals: options.externals ?? NodeLibraryBuilder.DEFAULT_OPTIONS.externals,
+            apiModel: options.apiModel ?? NodeLibraryBuilder.DEFAULT_OPTIONS.apiModel,
+            ...void 0 !== options.entry && {
+                entry: options.entry
+            },
+            ...void 0 !== options.exportsAsIndexes && {
+                exportsAsIndexes: options.exportsAsIndexes
+            },
+            ...void 0 !== options.dtsBundledPackages && {
+                dtsBundledPackages: options.dtsBundledPackages
+            },
+            ...void 0 !== options.transformFiles && {
+                transformFiles: options.transformFiles
+            },
+            ...void 0 !== options.transform && {
+                transform: options.transform
+            }
+        };
         return merged;
     }
     static create(options = {}) {
@@ -2280,14 +2365,23 @@ const TsDocLintPlugin = (options = {})=>{
         const options = NodeLibraryBuilder.mergeOptions(opts);
         const VERSION = await packageJsonVersion();
         const plugins = [];
-        if (options.tsdocLint) {
-            const lintOptions = true === options.tsdocLint ? {} : options.tsdocLint;
-            if (!lintOptions.tsdoc && "object" == typeof options.apiModel && options.apiModel.tsdoc) lintOptions.tsdoc = options.apiModel.tsdoc;
+        const apiModelConfig = "object" == typeof options.apiModel ? options.apiModel : {};
+        const tsdocConfig = apiModelConfig.tsdoc;
+        const lintConfig = tsdocConfig?.lint;
+        const lintEnabled = false !== options.apiModel && false !== lintConfig;
+        if (lintEnabled) {
+            const { lint: _lint, ...tsdocWithoutLint } = tsdocConfig ?? {};
+            const lintOptions = {
+                ...tsdocConfig && Object.keys(tsdocWithoutLint).length > 0 && {
+                    tsdoc: tsdocWithoutLint
+                },
+                ..."object" == typeof lintConfig ? lintConfig : {}
+            };
             plugins.push(TsDocLintPlugin(lintOptions));
         }
-        if (!options.entry) plugins.push(AutoEntryPlugin({
+        if (!options.entry) plugins.push(AutoEntryPlugin(null != options.exportsAsIndexes ? {
             exportsAsIndexes: options.exportsAsIndexes
-        }));
+        } : void 0));
         const userTransform = options.transform;
         const transformFn = userTransform ? (pkg)=>userTransform({
                 target,
@@ -2297,23 +2391,33 @@ const TsDocLintPlugin = (options = {})=>{
             forcePrivate: "dev" === target,
             bundle: true,
             target,
-            transform: transformFn
+            ...transformFn && {
+                transform: transformFn
+            }
         }));
         plugins.push(FilesArrayPlugin({
             target,
-            transformFiles: options.transformFiles
+            ...options.transformFiles && {
+                transformFiles: options.transformFiles
+            }
         }));
         if (options.plugins) plugins.push(...options.plugins);
         const outputDir = `dist/${target}`;
         const entry = options.entry;
         const apiModelForTarget = "npm" === target ? options.apiModel : void 0;
         plugins.push(DtsPlugin({
-            tsconfigPath: options.tsconfigPath,
+            ...options.tsconfigPath && {
+                tsconfigPath: options.tsconfigPath
+            },
             abortOnError: true,
             bundle: true,
-            bundledPackages: options.dtsBundledPackages,
+            ...options.dtsBundledPackages && {
+                bundledPackages: options.dtsBundledPackages
+            },
             buildTarget: target,
-            apiModel: apiModelForTarget
+            ...void 0 !== apiModelForTarget && {
+                apiModel: apiModelForTarget
+            }
         }));
         const lib = {
             id: target,
@@ -2329,7 +2433,9 @@ const TsDocLintPlugin = (options = {})=>{
                 copy: {
                     patterns: options.copyPatterns
                 },
-                externals: options.externals && options.externals.length > 0 ? options.externals : void 0
+                ...options.externals && options.externals.length > 0 && {
+                    externals: options.externals
+                }
             },
             format: "esm",
             experiments: {
@@ -2338,8 +2444,12 @@ const TsDocLintPlugin = (options = {})=>{
             bundle: true,
             plugins,
             source: {
-                tsconfigPath: options.tsconfigPath,
-                entry,
+                ...options.tsconfigPath && {
+                    tsconfigPath: options.tsconfigPath
+                },
+                ...entry && {
+                    entry
+                },
                 define: {
                     "process.env.__PACKAGE_VERSION__": JSON.stringify(VERSION),
                     ...options.define
@@ -2350,8 +2460,10 @@ const TsDocLintPlugin = (options = {})=>{
             lib: [
                 lib
             ],
-            source: {
-                tsconfigPath: options.tsconfigPath
+            ...options.tsconfigPath && {
+                source: {
+                    tsconfigPath: options.tsconfigPath
+                }
             },
             performance: {
                 buildCache: {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/rslib-builder",
-	"version": "0.8.0",
+	"version": "0.9.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": [
@@ -50,7 +50,7 @@
 		"deep-equal": "^2.2.3",
 		"eslint": "^9.39.2",
 		"eslint-plugin-tsdoc": "^0.5.0",
-		"glob": "^13.0.0",
+		"glob": "^13.0.1",
 		"picocolors": "^1.1.1",
 		"sort-package-json": "^3.6.1",
 		"tmp": "^0.2.5",

package/tsconfig/ecma/lib.json

@@ -13,6 +13,7 @@
 		"incremental": true,
 		"isolatedDeclarations": false,
 		"isolatedModules": true,
+		"exactOptionalPropertyTypes": true,
 		"jsx": "preserve",
 		"lib": ["esnext"],
 		"module": "nodenext",