chore(apidom-error): use API Extractor for TypeScript rollup (#4422)

Refs #4382

Author: char0n

api-extractor.json

@@ -86,6 +86,7 @@
     "lerna": "=8.1.8",
     "lint-staged": "=15.2.10",
     "microtime": "=3.1.1",
+    "@microsoft/api-extractor": "^7.47.11",
     "mocha": "=10.7.3",
     "mocha-chai-jest-snapshot": "^1.1.6",
     "node-gyp": "=10.2.0",

package-lock.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+  "extends": "../../../../api-extractor.json"
+}

package.json

@@ -11,11 +11,11 @@
   "unpkg": "./dist/apidom-error.browser.min.js",
   "main": "./src/index.cjs",
   "exports": {
-    "types": "./types/dist.d.ts",
+    "types": "./types/apidom-error.d.ts",
     "import": "./src/index.mjs",
     "require": "./src/index.cjs"
   },
-  "types": "./types/dist.d.ts",
+  "types": "./types/apidom-error.d.ts",
   "scripts": {
     "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "cross-env BABEL_ENV=es babel src --out-dir src --extensions '.ts' --out-file-extension '.mjs' --root-mode 'upward'",
@@ -25,7 +25,7 @@
     "lint:fix": "eslint ./ --fix",
     "clean": "rimraf --glob 'src/**/*.mjs' 'src/**/*.cjs' 'test/**/*.mjs' ./dist ./types",
     "typescript:check-types": "tsc --noEmit",
-    "typescript:declaration": "copyfiles -u 1 'src/**/*.d.ts' ./types && tsc -p declaration.tsconfig.json && rollup -c config/rollup/types.dist.js",
+    "typescript:declaration": "copyfiles -u 1 'src/**/*.d.ts' ./types && tsc -p declaration.tsconfig.json && api-extractor run -l -c ./config/api-extractor/api-extractor.json",
     "test": "npm run build:es && cross-env BABEL_ENV=es babel test --out-dir test --extensions '.ts' --out-file-extension '.mjs' --root-mode 'upward' && cross-env NODE_ENV=test mocha",
     "prepack": "copyfiles -u 3 ../../LICENSES/* LICENSES && copyfiles -u 2 ../../NOTICE .",
     "postpack": "rimraf NOTICE LICENSES"
@@ -43,7 +43,7 @@
     "src/**/*.mjs",
     "src/**/*.cjs",
     "dist/",
-    "types/dist.d.ts",
+    "types/apidom-error.d.ts",
     "LICENSES",
     "NOTICE",
     "README.md",

packages/apidom-error/config/api-extractor/api-extractor.json

@@ -1,5 +1,8 @@
 import type ApiDOMErrorOptions from './ApiDOMErrorOptions.ts';
 
+/**
+ * @public
+ */
 class ApiDOMAggregateError extends AggregateError {
   constructor(errors: Iterable<unknown>, message?: string, options?: ApiDOMErrorOptions) {
     super(errors, message, options);

packages/apidom-error/config/rollup/types.dist.js

@@ -1,6 +1,9 @@
 import ApiDOMAggregateError from './ApiDOMAggregateError.ts';
 import type ApiDOMErrorOptions from './ApiDOMErrorOptions.ts';
 
+/**
+ * @public
+ */
 class ApiDOMError extends Error {
   public static [Symbol.hasInstance](instance: unknown) {
     // we want to ApiDOMAggregateError to act as if ApiDOMError was its superclass

packages/apidom-error/package.json

@@ -1,3 +1,6 @@
+/**
+ * @public
+ */
 export default interface ApiDOMErrorOptions extends ErrorOptions {
   readonly cause?: unknown;
   readonly [key: string]: unknown;

packages/apidom-error/src/ApiDOMAggregateError.ts

@@ -1,6 +1,9 @@
 import ApiDOMError from './ApiDOMError.ts';
 import type ApiDOMErrorOptions from './ApiDOMErrorOptions.ts';
 
+/**
+ * @public
+ */
 class ApiDOMStructuredError extends ApiDOMError {
   constructor(message?: string, structuredOptions?: ApiDOMErrorOptions) {
     super(message, structuredOptions);

packages/apidom-error/src/ApiDOMError.ts

@@ -1,5 +1,8 @@
 import UnsupportedOperationError from './UnsupportedOperationError.ts';
 
+/**
+ * @public
+ */
 class NotImplementedError extends UnsupportedOperationError {}
 
 export default NotImplementedError;

packages/apidom-error/src/ApiDOMErrorOptions.d.ts

@@ -1,5 +1,8 @@
 import ApiDOMError from './ApiDOMError.ts';
 
+/**
+ * @public
+ */
 class UnsupportedOperationError extends ApiDOMError {}
 
 export default UnsupportedOperationError;