@savvy-web/rslib-builder 0.4.0 → 0.6.0

package/README.md

@@ -50,12 +50,6 @@ Install the required peer dependencies:
 pnpm add -D @rslib/core @microsoft/api-extractor @typescript/native-preview
 ```
 
-For TSDoc validation (optional):
-
-```bash
-pnpm add -D eslint @typescript-eslint/parser eslint-plugin-tsdoc
-```
-
 ## Quick Start
 
 Extend the provided tsconfig for optimal settings:

package/index.d.ts

@@ -40,9 +40,7 @@
  */
 
 import type { ConfigParams } from '@rslib/core';
-import type { PackageJson } from 'type-fest';
 import type { PathLike } from 'node:fs';
-import type { RawCopyPattern } from '@rspack/binding';
 import type { RsbuildPlugin } from '@rsbuild/core';
 import type { RslibConfig } from '@rslib/core';
 import type { SourceConfig } from '@rsbuild/core';
@@ -121,6 +119,18 @@ export declare interface ApiModelOptions {
      * @defaultValue true (enabled when apiModel is enabled)
      */
     tsdocMetadata?: TsDocMetadataOptions | boolean;
+    /**
+     * Controls handling of API Extractor's "forgotten export" messages.
+     * 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
+     * - `"error"`: Fail the build with details about the forgotten exports
+     * - `"ignore"`: Turn off detection — suppress all messages
+     *
+     * @defaultValue "include"
+     */
+    forgottenExports?: "include" | "error" | "ignore";
 }
 
 /**
@@ -228,6 +238,52 @@ export declare interface AutoEntryPluginOptions {
  */
 export declare type BuildTarget = "dev" | "npm";
 
+/**
+ * Configuration for copying files during the build process.
+ *
+ * @remarks
+ * This interface mirrors rspack's copy pattern configuration and is passed directly
+ * to the rspack CopyPlugin. All properties except `from` are optional.
+ *
+ * @example
+ * ```typescript
+ * // Copy a directory
+ * { from: "./public", to: "./", context: process.cwd() }
+ *
+ * // Copy specific files
+ * { from: "**\/*.json", to: "./config" }
+ * ```
+ *
+ * @public
+ */
+export declare interface CopyPatternConfig {
+    /** Source path or glob pattern to copy from */
+    from: string;
+    /** Destination path (relative to output directory) */
+    to?: string;
+    /** Base directory for resolving `from` path */
+    context?: string;
+    /** Type of destination: "dir", "file", or "template" */
+    toType?: "dir" | "file" | "template";
+    /** If true, does not emit an error if the source is missing */
+    noErrorOnMissing?: boolean;
+    /** Glob options for pattern matching */
+    globOptions?: {
+        /** Patterns to ignore */
+        ignore?: string[];
+        /** Whether to match dotfiles */
+        dot?: boolean;
+    };
+    /** Filter function to include/exclude files */
+    filter?: (filepath: string) => boolean | Promise<boolean>;
+    /** Transform function to modify file contents */
+    transform?: {
+        transformer: (input: Buffer, absoluteFilename: string) => string | Buffer | Promise<string> | Promise<Buffer>;
+    } | ((input: Buffer, absoluteFilename: string) => string | Buffer | Promise<string> | Promise<Buffer>);
+    /** Priority for conflicting files (higher = higher priority) */
+    priority?: number;
+}
+
 /**
  * Plugin to generate TypeScript declaration files using tsgo and emit them through Rslib's asset pipeline.
  *
@@ -827,6 +883,71 @@ export declare interface ImportGraphResult {
     errors: ImportGraphError[];
 }
 
+/**
+ * Matches a JSON array.
+ *
+ * @public
+ */
+export declare type JsonArray = JsonValue[] | readonly JsonValue[];
+
+/**
+ * Matches a JSON object.
+ *
+ * @remarks
+ * This type can be useful to enforce some input to be JSON-compatible or as a
+ * super-type to be extended from.
+ *
+ * @public
+ */
+export declare type JsonObject = {
+    [Key in string]: JsonValue;
+};
+
+/**
+ * Package.json type definitions.
+ *
+ * @remarks
+ * This is a local copy of type-fest's PackageJson types with TSDoc fixes.
+ * Original source: https://github.com/sindresorhus/type-fest
+ *
+ * TSDoc fixes applied:
+ * - Added deprecation messages to `@deprecated` tags
+ * - Fixed code fence formatting in `packageManager` docs
+ *
+ */
+/**
+ * Matches any valid JSON primitive value.
+ *
+ * @public
+ */
+export declare type JsonPrimitive = string | number | boolean | null;
+
+/**
+ * Matches any valid JSON value.
+ *
+ * @public
+ */
+export declare type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+
+/**
+ * Allows creating a union type by combining primitive types and literal types
+ * without sacrificing auto-completion in IDEs for the literal type part of the union.
+ *
+ * @remarks
+ * Currently, when a union type of a primitive type is combined with literal types,
+ * TypeScript loses all information about the combined literals. Thus, when such
+ * type is used in an IDE with autocompletion, no suggestions are made for the
+ * declared literals.
+ *
+ * This type is a workaround for Microsoft/TypeScript#29729.
+ *
+ * @typeParam LiteralType - The literal type(s) to include
+ * @typeParam BaseType - The base primitive type
+ *
+ * @public
+ */
+export declare type LiteralUnion<LiteralType, BaseType extends Primitive> = LiteralType | (BaseType & Record<never, never>);
+
 /**
  * Builder for Node.js ESM libraries using RSlib.
  *
@@ -929,7 +1050,7 @@ export declare interface NodeLibraryBuilderOptions {
      * ```
      */
     exportsAsIndexes?: boolean;
-    copyPatterns: (string | (Pick<RawCopyPattern, "from"> & Partial<Omit<RawCopyPattern, "from">>))[];
+    copyPatterns: (string | CopyPatternConfig)[];
     /** Additional plugins */
     plugins: RsbuildPlugin[];
     define: SourceConfig["define"];
@@ -1103,6 +1224,433 @@ export declare interface NodeLibraryBuilderOptions {
     tsdocLint?: TsDocLintPluginOptions | boolean;
 }
 
+/**
+ * PackageJson namespace containing all sub-types.
+ *
+ * @public
+ */
+export declare namespace PackageJson {
+    /**
+     * A person who has been involved in creating or maintaining the package.
+     */
+    export type Person = string | {
+        name: string;
+        url?: string;
+        email?: string;
+    };
+    /**
+     * Location for reporting bugs.
+     */
+    export type BugsLocation = string | {
+        /** The URL to the package's issue tracker. */
+        url?: string;
+        /** The email address to which issues should be reported. */
+        email?: string;
+    };
+    /**
+     * Directory locations within the package.
+     */
+    export interface DirectoryLocations {
+        [directoryType: string]: JsonValue | undefined;
+        /** Location for executable scripts. Sugar to generate entries in the `bin` property by walking the folder. */
+        bin?: string;
+        /** Location for Markdown files. */
+        doc?: string;
+        /** Location for example scripts. */
+        example?: string;
+        /** Location for the bulk of the library. */
+        lib?: string;
+        /** Location for man pages. Sugar to generate a `man` array by walking the folder. */
+        man?: string;
+        /** Location for test files. */
+        test?: string;
+    }
+    /**
+     * Script commands that are run at various times in the lifecycle of the package.
+     */
+    export type Scripts = {
+        /** Run before the package is published (Also run on local `npm install` without any arguments). */
+        prepublish?: string;
+        /** Run both before the package is packed and published, and on local `npm install` without any arguments. */
+        prepare?: string;
+        /** Run before the package is prepared and packed, only on `npm publish`. */
+        prepublishOnly?: string;
+        /** Run before a tarball is packed (on `npm pack`, `npm publish`, and when installing git dependencies). */
+        prepack?: string;
+        /** Run after the tarball has been generated and moved to its final destination. */
+        postpack?: string;
+        /** Run after the package is published. */
+        publish?: string;
+        /** Run after the package is published. */
+        postpublish?: string;
+        /** Run before the package is installed. */
+        preinstall?: string;
+        /** Run after the package is installed. */
+        install?: string;
+        /** Run after the package is installed and after `install`. */
+        postinstall?: string;
+        /** Run before the package is uninstalled and before `uninstall`. */
+        preuninstall?: string;
+        /** Run before the package is uninstalled. */
+        uninstall?: string;
+        /** Run after the package is uninstalled. */
+        postuninstall?: string;
+        /** Run before bump the package version and before `version`. */
+        preversion?: string;
+        /** Run before bump the package version. */
+        version?: string;
+        /** Run after bump the package version. */
+        postversion?: string;
+        /** Run with the `npm test` command, before `test`. */
+        pretest?: string;
+        /** Run with the `npm test` command. */
+        test?: string;
+        /** Run with the `npm test` command, after `test`. */
+        posttest?: string;
+        /** Run with the `npm stop` command, before `stop`. */
+        prestop?: string;
+        /** Run with the `npm stop` command. */
+        stop?: string;
+        /** Run with the `npm stop` command, after `stop`. */
+        poststop?: string;
+        /** Run with the `npm start` command, before `start`. */
+        prestart?: string;
+        /** Run with the `npm start` command. */
+        start?: string;
+        /** Run with the `npm start` command, after `start`. */
+        poststart?: string;
+        /** Run with the `npm restart` command, before `restart`. */
+        prerestart?: string;
+        /** Run with the `npm restart` command. */
+        restart?: string;
+        /** Run with the `npm restart` command, after `restart`. */
+        postrestart?: string;
+    } & Partial<Record<string, string>>;
+    /**
+     * Dependencies of the package. The version range is a string which has one or
+     * more space-separated descriptors.
+     */
+    export type Dependency = Partial<Record<string, string>>;
+    /**
+     * Recursive map describing selective dependency version overrides supported by npm.
+     */
+    export type DependencyOverrides = {
+        [packageName in string]: string | undefined | DependencyOverrides;
+    };
+    /**
+     * Specifies requirements for development environment components.
+     */
+    export interface DevEngineDependency {
+        name: string;
+        version?: string;
+        onFail?: "ignore" | "warn" | "error" | "download";
+    }
+    /**
+     * A mapping of conditions and the paths to which they resolve.
+     */
+    export interface ExportConditions {
+        [condition: string]: Exports;
+    }
+    /**
+     * Entry points of a module, optionally with conditions and subpath exports.
+     */
+    export type Exports = null | string | Array<string | ExportConditions> | ExportConditions;
+    /**
+     * Import map entries of a module, optionally with conditions and subpath imports.
+     */
+    export interface Imports {
+        [key: `#${string}`]: Exports;
+    }
+    /**
+     * Non-standard entry point fields used by various bundlers.
+     */
+    export interface NonStandardEntryPoints {
+        /** An ECMAScript module ID that is the primary entry point to the program. */
+        module?: string;
+        /** A module ID with untranspiled code that is the primary entry point to the program. */
+        esnext?: string | {
+            [moduleName: string]: string | undefined;
+            main?: string;
+            browser?: string;
+        };
+        /** A hint to JavaScript bundlers or component tools when packaging modules for client side use. */
+        browser?: string | Partial<Record<string, string | false>>;
+        /**
+         * Denote which files in your project are "pure" and therefore safe for Webpack to prune if unused.
+         *
+         * @see {@link https://webpack.js.org/guides/tree-shaking/ | Webpack Tree Shaking}
+         */
+        sideEffects?: boolean | string[];
+    }
+    /**
+     * TypeScript-specific configuration fields.
+     */
+    export interface TypeScriptConfiguration {
+        /** Location of the bundled TypeScript declaration file. */
+        types?: string;
+        /** Version selection map of TypeScript. */
+        typesVersions?: Partial<Record<string, Partial<Record<string, string[]>>>>;
+        /** Location of the bundled TypeScript declaration file. Alias of `types`. */
+        typings?: string;
+    }
+    /**
+     * An alternative configuration for workspaces.
+     */
+    export interface WorkspaceConfig {
+        /** An array of workspace pattern strings which contain the workspace packages. */
+        packages?: WorkspacePattern[];
+        /**
+         * Designed to solve the problem of packages which break when their `node_modules`
+         * are moved to the root workspace directory - a process known as hoisting.
+         *
+         * @see {@link https://classic.yarnpkg.com/blog/2018/02/15/nohoist/ | Yarn nohoist}
+         */
+        nohoist?: WorkspacePattern[];
+    }
+    /**
+     * A workspace pattern points to a directory or group of directories which
+     * contain packages that should be included in the workspace installation process.
+     *
+     * @example
+     * `docs` - Include the docs directory and install its dependencies.
+     *
+     * @example
+     * `packages/*` - Include all nested directories within the packages directory.
+     */
+    export type WorkspacePattern = string;
+    /**
+     * Yarn-specific configuration fields.
+     */
+    export interface YarnConfiguration {
+        /**
+         * If your package only allows one version of a given dependency, and you'd like
+         * to enforce the same behavior as `yarn install --flat` on the command-line,
+         * set this to `true`.
+         */
+        flat?: boolean;
+        /** Selective version resolutions. Allows the definition of custom package versions inside dependencies. */
+        resolutions?: Dependency;
+    }
+    /**
+     * JSPM-specific configuration fields.
+     */
+    export interface JSPMConfiguration {
+        /** JSPM configuration. */
+        jspm?: PackageJson;
+    }
+    /**
+     * Publish configuration options.
+     */
+    export interface PublishConfig {
+        /** Additional properties from the npm docs on `publishConfig`. */
+        [additionalProperties: string]: JsonValue | undefined;
+        /**
+         * When publishing scoped packages, the access level defaults to restricted.
+         * If you want your scoped package to be publicly viewable set `--access=public`.
+         */
+        access?: "public" | "restricted";
+        /**
+         * The base URL of the npm registry.
+         *
+         * @defaultValue `'https://registry.npmjs.org/'`
+         */
+        registry?: string;
+        /**
+         * The tag to publish the package under.
+         *
+         * @defaultValue `'latest'`
+         */
+        tag?: string;
+    }
+    /**
+     * Type for npm's `package.json` file containing standard npm properties.
+     *
+     * @see {@link https://docs.npmjs.com/creating-a-package-json-file | npm docs}
+     */
+    export interface PackageJsonStandard {
+        /** The name of the package. */
+        name?: string;
+        /** Package version, parseable by `node-semver`. */
+        version?: string;
+        /** Package description, listed in `npm search`. */
+        description?: string;
+        /** Keywords associated with package, listed in `npm search`. */
+        keywords?: string[];
+        /** The URL to the package's homepage. */
+        homepage?: LiteralUnion<".", string>;
+        /** The URL to the package's issue tracker and/or the email address to which issues should be reported. */
+        bugs?: BugsLocation;
+        /** The license for the package. */
+        license?: string;
+        /** The licenses for the package. */
+        licenses?: Array<{
+            type?: string;
+            url?: string;
+        }>;
+        /** The author of the package. */
+        author?: Person;
+        /** A list of people who contributed to the package. */
+        contributors?: Person[];
+        /** A list of people who maintain the package. */
+        maintainers?: Person[];
+        /** The files included in the package. */
+        files?: string[];
+        /**
+         * Resolution algorithm for importing ".js" files from the package's scope.
+         *
+         * @see {@link https://nodejs.org/api/esm.html#esm_package_json_type_field | Node.js ESM docs}
+         */
+        type?: "module" | "commonjs";
+        /** The module ID that is the primary entry point to the program. */
+        main?: string;
+        /**
+         * Subpath exports to define entry points of the package.
+         *
+         * @see {@link https://nodejs.org/api/packages.html#subpath-exports | Node.js Subpath exports}
+         */
+        exports?: Exports;
+        /**
+         * Subpath imports to define internal package import maps.
+         *
+         * @see {@link https://nodejs.org/api/packages.html#subpath-imports | Node.js Subpath imports}
+         */
+        imports?: Imports;
+        /** The executable files that should be installed into the `PATH`. */
+        bin?: string | Partial<Record<string, string>>;
+        /** Filenames to put in place for the `man` program to find. */
+        man?: string | string[];
+        /** Indicates the structure of the package. */
+        directories?: DirectoryLocations;
+        /** Location for the code repository. */
+        repository?: string | {
+            type: string;
+            url: string;
+            /** Relative path to package.json if it is placed in non-root directory (for monorepos). */
+            directory?: string;
+        };
+        /** Script commands that are run at various times in the lifecycle of the package. */
+        scripts?: Scripts;
+        /** Is used to set configuration parameters used in package scripts that persist across upgrades. */
+        config?: JsonObject;
+        /** The dependencies of the package. */
+        dependencies?: Dependency;
+        /** Additional tooling dependencies that are not required for the package to work. */
+        devDependencies?: Dependency;
+        /** Dependencies that are skipped if they fail to install. */
+        optionalDependencies?: Dependency;
+        /** Dependencies that will usually be required by the package user directly or via another dependency. */
+        peerDependencies?: Dependency;
+        /** Indicate peer dependencies that are optional. */
+        peerDependenciesMeta?: Partial<Record<string, {
+            optional: true;
+        }>>;
+        /** Package names that are bundled when the package is published. */
+        bundledDependencies?: string[];
+        /** Alias of `bundledDependencies`. */
+        bundleDependencies?: string[];
+        /** Overrides is used to support selective version overrides using npm. */
+        overrides?: DependencyOverrides;
+        /** Engines that this package runs on. */
+        engines?: {
+            [EngineName in "npm" | "node" | string]?: string;
+        };
+        /**
+         * Whether to enforce engine requirements strictly.
+         *
+         * @deprecated This field is no longer used by npm. Use the `engine-strict` npm config instead.
+         */
+        engineStrict?: boolean;
+        /** Operating systems the module runs on. */
+        os?: Array<LiteralUnion<"aix" | "darwin" | "freebsd" | "linux" | "openbsd" | "sunos" | "win32" | "!aix" | "!darwin" | "!freebsd" | "!linux" | "!openbsd" | "!sunos" | "!win32", string>>;
+        /** CPU architectures the module runs on. */
+        cpu?: Array<LiteralUnion<"arm" | "arm64" | "ia32" | "mips" | "mipsel" | "ppc" | "ppc64" | "s390" | "s390x" | "x32" | "x64" | "!arm" | "!arm64" | "!ia32" | "!mips" | "!mipsel" | "!ppc" | "!ppc64" | "!s390" | "!s390x" | "!x32" | "!x64", string>>;
+        /** Define the runtime and package manager for developing the current project. */
+        devEngines?: {
+            os?: DevEngineDependency | DevEngineDependency[];
+            cpu?: DevEngineDependency | DevEngineDependency[];
+            libc?: DevEngineDependency | DevEngineDependency[];
+            runtime?: DevEngineDependency | DevEngineDependency[];
+            packageManager?: DevEngineDependency | DevEngineDependency[];
+        };
+        /**
+         * If set to `true`, a warning will be shown if package is installed locally.
+         *
+         * @deprecated This field is no longer used by npm. Use the `bin` field to create CLI tools instead.
+         */
+        preferGlobal?: boolean;
+        /** If set to `true`, then npm will refuse to publish it. */
+        private?: boolean;
+        /** A set of config values that will be used at publish-time. */
+        publishConfig?: PublishConfig;
+        /**
+         * Describes and notifies consumers of a package's monetary support information.
+         *
+         * @see {@link https://github.com/npm/rfcs/blob/main/implemented/0017-add-funding-support.md | npm funding RFC}
+         */
+        funding?: string | {
+            /** The type of funding. */
+            type?: LiteralUnion<"github" | "opencollective" | "patreon" | "individual" | "foundation" | "corporation", string>;
+            /** The URL to the funding page. */
+            url: string;
+        };
+        /**
+         * Used to configure npm workspaces / Yarn workspaces.
+         *
+         * @remarks
+         * Workspaces allow you to manage multiple packages within the same repository
+         * in such a way that you only need to run your install command once in order
+         * to install all of them in a single pass.
+         *
+         * Please note that the top-level `private` property of `package.json` must
+         * be set to `true` in order to use workspaces.
+         *
+         * @see {@link https://docs.npmjs.com/cli/using-npm/workspaces | npm workspaces}
+         * @see {@link https://classic.yarnpkg.com/docs/workspaces/ | Yarn workspaces}
+         */
+        workspaces?: WorkspacePattern[] | WorkspaceConfig;
+    }
+    /**
+     * Type for `package.json` file used by the Node.js runtime.
+     *
+     * @see {@link https://nodejs.org/api/packages.html#nodejs-packagejson-field-definitions | Node.js docs}
+     */
+    export interface NodeJsStandard {
+        /**
+         * Defines which package manager is expected to be used when working on the current project.
+         *
+         * @remarks
+         * It can be set to any of the supported package managers, and will ensure that
+         * your teams use the exact same package manager versions without having to
+         * install anything else other than Node.js.
+         *
+         * This field is currently experimental and needs to be opted-in; check the
+         * Corepack page for details about the procedure.
+         *
+         * @example
+         * ```json
+         * {
+         *   "packageManager": "pnpm@8.0.0"
+         * }
+         * ```
+         *
+         * @see {@link https://nodejs.org/api/corepack.html | Node.js Corepack docs}
+         */
+        packageManager?: string;
+    }
+}
+
+/**
+ * Type for npm's `package.json` file.
+ *
+ * @remarks
+ * Also includes types for fields used by other popular projects, like TypeScript and Yarn.
+ *
+ * @see {@link https://docs.npmjs.com/creating-a-package-json-file | npm docs}
+ *
+ * @public
+ */
+export declare type PackageJson = JsonObject & PackageJson.NodeJsStandard & PackageJson.PackageJsonStandard & PackageJson.NonStandardEntryPoints & PackageJson.TypeScriptConfiguration & PackageJson.YarnConfiguration & PackageJson.JSPMConfiguration;
+
 /**
  * Plugin to transform package.json for distribution.
  *
@@ -1254,11 +1802,20 @@ export declare interface PackageJsonTransformPluginOptions {
     transform?: (pkg: PackageJson) => PackageJson;
 }
 
+/**
+ * Matches any primitive value.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Glossary/Primitive | MDN Primitive}
+ *
+ * @public
+ */
+export declare type Primitive = null | undefined | string | number | boolean | symbol | bigint;
+
 /**
  * Async RSLib configuration function type.
  * @public
  */
-declare type RslibConfigAsyncFn = (env: ConfigParams) => Promise<RslibConfig>;
+export declare type RslibConfigAsyncFn = (env: ConfigParams) => Promise<RslibConfig>;
 
 /**
  * Function to transform package.json during the build process.
@@ -1442,15 +1999,13 @@ export declare type TsDocLintErrorBehavior = "warn" | "error" | "throw";
  * | Local       | `"error"`        | Log and continue |
  * | CI          | `"throw"`        | Fail the build |
  *
- * ## Required Dependencies
+ * ## Dependencies
  *
- * This plugin requires the following optional peer dependencies:
+ * This plugin uses ESLint programmatically with the following packages:
  * - `eslint`
  * - `@typescript-eslint/parser`
  * - `eslint-plugin-tsdoc`
  *
- * Install with: `pnpm add -D eslint @typescript-eslint/parser eslint-plugin-tsdoc`
- *
  * @param options - Plugin configuration options
  * @returns An Rsbuild plugin that validates TSDoc comments before the build
  *
@@ -1663,6 +2218,11 @@ export declare interface TsDocOptions {
      * TSDoc warnings include unknown tags, malformed syntax, and other
      * documentation issues detected by API Extractor during processing.
      *
+     * **Important:** This setting only applies to first-party warnings (from your
+     * project's source code). Third-party warnings from dependencies in
+     * `node_modules/` are always logged but never fail the build, since they
+     * cannot be fixed by the consuming project.
+     *
      * @defaultValue `"fail"` in CI environments (`CI` or `GITHUB_ACTIONS` env vars),
      *               `"log"` otherwise
      */

package/index.js

@@ -265,7 +265,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":true,"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,"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([
     [
@@ -528,6 +528,7 @@ async function bundleDtsFiles(options) {
     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 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();
@@ -568,6 +569,7 @@ async function bundleDtsFiles(options) {
             configObject: {
                 projectFolder: cwd,
                 mainEntryPointFilePath: tempDtsPath,
+                enumMemberOrder: "preserve",
                 compiler: {
                     tsconfigFilePath: tsconfigPath
                 },
@@ -590,6 +592,7 @@ async function bundleDtsFiles(options) {
             tsdocConfigFile: tsdocConfigFile
         });
         const collectedTsdocWarnings = [];
+        const collectedForgottenExports = [];
         const extractorResult = Extractor.invoke(extractorConfig, {
             localBuild: true,
             showVerboseMessages: false,
@@ -613,17 +616,41 @@ async function bundleDtsFiles(options) {
                     });
                     message.logLevel = "none";
                 }
+                if ("ae-forgotten-export" === message.messageId && message.text) if ("ignore" === forgottenExports) message.logLevel = "none";
+                else {
+                    collectedForgottenExports.push({
+                        text: message.text,
+                        sourceFilePath: message.sourceFilePath,
+                        sourceFileLine: message.sourceFileLine,
+                        sourceFileColumn: message.sourceFileColumn
+                    });
+                    message.logLevel = "none";
+                }
             }
         });
         if (!extractorResult.succeeded) throw new Error(`API Extractor failed for entry "${entryName}"`);
+        const formatWarning = (warning)=>{
+            const location = warning.sourceFilePath ? `${picocolors.cyan((0, external_node_path_.relative)(cwd, warning.sourceFilePath))}${warning.sourceFileLine ? `:${warning.sourceFileLine}` : ""}${warning.sourceFileColumn ? `:${warning.sourceFileColumn}` : ""}` : null;
+            return location ? `${location}: ${picocolors.yellow(warning.text)}` : picocolors.yellow(warning.text);
+        };
         if (collectedTsdocWarnings.length > 0) {
-            const formatWarning = (warning)=>{
-                const location = warning.sourceFilePath ? `${picocolors.cyan((0, external_node_path_.relative)(cwd, warning.sourceFilePath))}${warning.sourceFileLine ? `:${warning.sourceFileLine}` : ""}${warning.sourceFileColumn ? `:${warning.sourceFileColumn}` : ""}` : null;
-                return location ? `${location}: ${picocolors.yellow(warning.text)}` : picocolors.yellow(warning.text);
-            };
-            const warningMessages = collectedTsdocWarnings.map(formatWarning).join("\n  ");
-            if ("fail" === tsdocWarnings) throw new Error(`TSDoc validation failed for entry "${entryName}":\n  ${warningMessages}`);
-            if ("log" === tsdocWarnings) core_logger.warn(`TSDoc warnings for entry "${entryName}":\n  ${warningMessages}`);
+            const isThirdParty = (warning)=>warning.sourceFilePath?.includes("node_modules/") ?? false;
+            const firstPartyWarnings = collectedTsdocWarnings.filter((w)=>!isThirdParty(w));
+            const thirdPartyWarnings = collectedTsdocWarnings.filter(isThirdParty);
+            if (thirdPartyWarnings.length > 0) {
+                const thirdPartyMessages = thirdPartyWarnings.map(formatWarning).join("\n  ");
+                core_logger.warn(`TSDoc warnings from dependencies for entry "${entryName}" (cannot be fixed, bundled types may have documentation issues):\n  ${thirdPartyMessages}`);
+            }
+            if (firstPartyWarnings.length > 0) {
+                const firstPartyMessages = firstPartyWarnings.map(formatWarning).join("\n  ");
+                if ("fail" === tsdocWarnings) throw new Error(`TSDoc validation failed for entry "${entryName}":\n  ${firstPartyMessages}`);
+                if ("log" === tsdocWarnings) core_logger.warn(`TSDoc warnings for entry "${entryName}":\n  ${firstPartyMessages}`);
+            }
+        }
+        if (collectedForgottenExports.length > 0) {
+            const forgottenMessages = collectedForgottenExports.map(formatWarning).join("\n  ");
+            if ("error" === forgottenExports) throw new Error(`Forgotten exports detected for entry "${entryName}":\n  ${forgottenMessages}`);
+            if ("include" === forgottenExports) core_logger.warn(`Forgotten exports for entry "${entryName}":\n  ${forgottenMessages}`);
         }
         if (generateApiModel && tempApiModelPath) apiModelPath = tempApiModelPath;
         if (generateTsdocMetadata && tempTsdocMetadataPath) tsdocMetadataPath = tempTsdocMetadataPath;
@@ -876,7 +903,7 @@ function runTsgo(options) {
                             if (apiModelPath) {
                                 const defaultApiModelFilename = packageJson.name ? `${getUnscopedPackageName(packageJson.name)}.api.json` : "api.json";
                                 const apiModelFilename = "object" == typeof options.apiModel && options.apiModel.filename ? options.apiModel.filename : defaultApiModelFilename;
-                                const apiModelContent = await readFile(apiModelPath, "utf-8");
+                                const apiModelContent = (await readFile(apiModelPath, "utf-8")).replaceAll("\r\n", "\n");
                                 const apiModelSource = new context.sources.OriginalSource(apiModelContent, apiModelFilename);
                                 context.compilation.emitAsset(apiModelFilename, apiModelSource);
                                 if (filesArray) filesArray.add(`!${apiModelFilename}`);
@@ -899,14 +926,14 @@ function runTsgo(options) {
                             if (tsdocMetadataPath) {
                                 const tsdocMetadataOption = "object" == typeof options.apiModel ? options.apiModel.tsdocMetadata : void 0;
                                 const tsdocMetadataFilename = "object" == typeof tsdocMetadataOption && tsdocMetadataOption.filename ? tsdocMetadataOption.filename : "tsdoc-metadata.json";
-                                const tsdocMetadataContent = await readFile(tsdocMetadataPath, "utf-8");
+                                const tsdocMetadataContent = (await readFile(tsdocMetadataPath, "utf-8")).replaceAll("\r\n", "\n");
                                 const tsdocMetadataSource = new context.sources.OriginalSource(tsdocMetadataContent, tsdocMetadataFilename);
                                 context.compilation.emitAsset(tsdocMetadataFilename, tsdocMetadataSource);
                                 if (filesArray) filesArray.add(tsdocMetadataFilename);
                                 core_logger.info(`${picocolors.dim(`[${envId}]`)} Emitted TSDoc metadata: ${tsdocMetadataFilename}`);
                             }
                             if (tsdocConfigPath) {
-                                const tsdocConfigContent = await readFile(tsdocConfigPath, "utf-8");
+                                const tsdocConfigContent = (await readFile(tsdocConfigPath, "utf-8")).replaceAll("\r\n", "\n");
                                 const tsdocConfigSource = new context.sources.OriginalSource(tsdocConfigContent, "tsdoc.json");
                                 context.compilation.emitAsset("tsdoc.json", tsdocConfigSource);
                                 if (filesArray) filesArray.add("!tsdoc.json");
@@ -1714,27 +1741,10 @@ async function runTsDocLint(options, cwd) {
     const shouldPersist = TsDocConfigBuilder.shouldPersist(persistConfig);
     const tsdocConfigOutputPath = TsDocConfigBuilder.getConfigPath(persistConfig, cwd);
     const tsdocConfigPath = await TsDocConfigBuilder.writeConfigFile(tsdocOptions, (0, external_node_path_.dirname)(tsdocConfigOutputPath));
-    let ESLint;
-    let tsParserModule;
-    let tsdocPluginModule;
-    const missingPackages = [];
-    try {
-        const eslintModule = await import("eslint");
-        ESLint = eslintModule.ESLint;
-    } catch  {
-        missingPackages.push("eslint");
-    }
-    try {
-        tsParserModule = await import("@typescript-eslint/parser");
-    } catch  {
-        missingPackages.push("@typescript-eslint/parser");
-    }
-    try {
-        tsdocPluginModule = await import("eslint-plugin-tsdoc");
-    } catch  {
-        missingPackages.push("eslint-plugin-tsdoc");
-    }
-    if (missingPackages.length > 0 || !ESLint) throw new Error(`TsDocLintPlugin requires: ${missingPackages.join(", ")}\nInstall with: pnpm add -D ${missingPackages.join(" ")}`);
+    const eslintModule = await import("eslint");
+    const tsParserModule = await import("@typescript-eslint/parser");
+    const tsdocPluginModule = await import("eslint-plugin-tsdoc");
+    const { ESLint } = eslintModule;
     const tsParser = tsParserModule.default ?? tsParserModule;
     const tsdocPlugin = tsdocPluginModule.default ?? tsdocPluginModule;
     const discovery = discoverFilesToLint(options, cwd);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/rslib-builder",
-	"version": "0.4.0",
+	"version": "0.6.0",
 	"private": false,
 	"description": "RSlib-based build system for Node.js libraries with automatic package.json transformation, TypeScript declaration bundling, and multi-target support",
 	"homepage": "https://github.com/savvy-web/rslib-builder",
@@ -27,22 +27,22 @@
 		"@microsoft/tsdoc": "^0.16.0",
 		"@microsoft/tsdoc-config": "^0.18.0",
 		"@pnpm/exportable-manifest": "^1000.3.1",
+		"@typescript-eslint/parser": "^8.53.1",
 		"deep-equal": "^2.2.3",
+		"eslint": "^9.39.2",
+		"eslint-plugin-tsdoc": "^0.5.0",
 		"glob": "^13.0.0",
 		"picocolors": "^1.1.1",
-		"sort-package-json": "^3.6.0",
+		"sort-package-json": "^3.6.1",
 		"tmp": "^0.2.5",
-		"workspace-tools": "^0.40.3",
+		"workspace-tools": "^0.40.4",
 		"yaml": "^2.8.2"
 	},
 	"peerDependencies": {
 		"@microsoft/api-extractor": "^7.55.2",
-		"@rslib/core": "^0.19.2",
-		"@types/node": "^25.0.9",
-		"@typescript-eslint/parser": "^8.0.0",
-		"@typescript/native-preview": "^7.0.0-dev.20260120.1",
-		"eslint": "^9.0.0",
-		"eslint-plugin-tsdoc": "^0.5.0",
+		"@rslib/core": "^0.19.3",
+		"@types/node": "^25.0.10",
+		"@typescript/native-preview": "^7.0.0-dev.20260124.1",
 		"typescript": "^5.9.3"
 	},
 	"peerDependenciesMeta": {
@@ -52,20 +52,14 @@
 		"@rslib/core": {
 			"optional": false
 		},
-		"@typescript-eslint/parser": {
-			"optional": true
+		"@types/node": {
+			"optional": false
 		},
 		"@typescript/native-preview": {
 			"optional": false
 		},
-		"eslint": {
-			"optional": true
-		},
-		"eslint-plugin-tsdoc": {
-			"optional": true
-		},
 		"typescript": {
-			"optional": false
+			"optional": true
 		}
 	},
 	"files": [

package/tsconfig/ecma/lib.json

@@ -11,7 +11,7 @@
 		"explainFiles": false,
 		"forceConsistentCasingInFileNames": true,
 		"incremental": true,
-		"isolatedDeclarations": true,
+		"isolatedDeclarations": false,
 		"isolatedModules": true,
 		"jsx": "preserve",
 		"lib": ["esnext"],

package/tsdoc-metadata.json

@@ -1,11 +1,11 @@
-// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
-// It should be published with your NPM package.  It should not be tracked by Git.
-{
-  "tsdocVersion": "0.12",
-  "toolPackages": [
-    {
-      "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.55.2"
-    }
-  ]
-}
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.55.2"
+    }
+  ]
+}