Refactor exception handler

Author: tolyo

@types/core/compile/attributes.d.ts

@@ -18,7 +18,7 @@ export class Attributes {
   );
   $rootScope: import("../scope/scope.js").Scope;
   $animate: import("../../interface.ts").AnimateService;
-  $exceptionHandler: import("../../interface.ts").ErrorHandler;
+  $exceptionHandler: import("../../interface.ts").ExceptionHandler;
   $sce: any;
   $attr: {};
   /** @type {import("../../shared/noderef.js").NodeRef} */

@types/directive/model/model.d.ts

@@ -141,7 +141,7 @@ export class NgModelController {
   $$element: Element;
   $$animate: import("../../interface.ts").AnimateService;
   $$parse: import("../../core/parse/interface.ts").ParseService;
-  $$exceptionHandler: import("../../interface.ts").ErrorHandler;
+  $$exceptionHandler: import("../../interface.ts").ExceptionHandler;
   $$hasNativeValidators: boolean;
   $$classCache: {};
   $$eventRemovers: Set<any>;

@types/interface.d.ts

@@ -12,6 +12,7 @@ export * from "./core/di/internal-injector.js";
 export * from "./core/scope/scope.js";
 export * from "./services/cookie/cookie.js";
 export * from "./services/cookie/interface.ts";
+export * from "./services/exception/exception.ts";
 export * from "./services/exception/interface.ts";
 export * from "./core/parse/interface.ts";
 import { Attributes } from "./core/compile/attributes.js";

@types/namespace.d.ts

@@ -13,7 +13,7 @@ import {
   AnchorScrollService as TAnchorScrollService,
 } from "./services/anchor-scroll/anchor-scroll.js";
 import { ControllerService as TControllerService } from "./core/controller/interface.ts";
-import { ErrorHandler as TErrorHandler } from "./services/exception/interface.ts";
+import { ExceptionHandler as TExceptionHandler } from "./services/exception/interface.ts";
 import { ParseService as TParseService } from "./core/parse/interface.ts";
 import { TemplateRequestService as TTemplateRequestService } from "./services/template-request/interface.ts";
 import { HttpParamSerializer as THttpParamSerializer } from "./services/http/interface.ts";
@@ -115,7 +115,7 @@ declare global {
     type CompileService = TCompileFn;
     type ControllerService = TControllerService;
     type CookieService = TCookieService;
-    type ExceptionHandlerService = TErrorHandler;
+    type ExceptionHandlerService = TExceptionHandler;
     type FilterService = TFilterFactory;
     type HttpParamSerializerSerService = THttpParamSerializer;
     type HttpService = THttpService;

@types/services/cookie/cookie.d.ts

@@ -28,7 +28,7 @@ export class CookieService {
   );
   /** @type {ng.CookieOptions} */
   defaults: ng.CookieOptions;
-  $exceptionHandler: import("../exception/interface.ts").ErrorHandler;
+  $exceptionHandler: import("../exception/interface.ts").ExceptionHandler;
   /**
    * Retrieves a raw cookie value.
    *

…ervices/exception/exception-handler.d.ts @types/services/exception/exception.d.ts@types/services/exception/exception-handler.d.ts renamed to @types/services/exception/exception.d.ts @types/services/exception/exception-handler.d.ts renamed to @types/services/exception/exception.d.ts

@@ -3,7 +3,7 @@
  *
  * This service receives uncaught exceptions from both synchronous and asynchronous operations.
  * Its purpose is to provide a central point through which the framework
- * surfaces errors.
+ * processes errors.
  *
  * By default, `$exceptionHandler` simply rethrows the exception. This ensures fail-fast
  * behavior, making errors visible immediately in development and in unit tests.
@@ -37,7 +37,7 @@
  * }
  * ```
  *
- * @see {@link angular.ErrorHandler AngularTS ErrorHandler}
+ * @see {@link ng.ExceptionHandlerService ExceptionHandlerService}
  */
 /**
  * Provider for the `$exceptionHandler` service.
@@ -48,7 +48,7 @@
  */
 export class ExceptionHandlerProvider {
   /** @type {ng.ExceptionHandlerService} */
-  errorHandler: ng.ExceptionHandlerService;
+  handler: ng.ExceptionHandlerService;
   /**
    * @returns {ng.ExceptionHandlerService}
    */

@types/services/exception/interface.d.ts

@@ -1,6 +1,6 @@
 /**
  * A callback type for handling errors.
  *
- * @param exception - The exception associated with the error.
+ * @param {Error} exception - The exception associated with the error.
  */
-export type ErrorHandler = (exception: Error) => void;
+export type ExceptionHandler = (exception: Error) => void;

docs/content/docs/provider/exceptionHandlerProvider.md

@@ -0,0 +1,46 @@
+---
+title: $exceptionHandlerProvider
+description: >
+  Configuration provider for `$exceptionHandler` service.
+---
+
+### Description
+
+Instance of [ng.ExceptionHandlerProvider](../../../typedoc/classes/ExceptionHandlerProvider.html) for
+configuring the `$exceptionHandler` service. 
+
+The default implementation returns 
+[ng.ExceptionHandler](../../../typedoc/types/ExceptionHandler.html) function, which simply rethrows the exception.
+
+**NOTE**: custom implementations should always rethrow the error as the framework assumes that `$exceptionHandler` always does the throwing.
+
+
+### Properties
+
+---
+
+#### $exceptionHandler.handler
+
+Customize the `exceptionHandler` function.
+
+- **Type:** [ng.ExceptionHandler](../../../typedoc/classes/PubSub.html)
+- **Default:** Function that rethrows the exception.
+- **Example:**
+  ```js
+  angular.module('demo', [])
+    .config([
+      "$exceptionHandlerProvider",
+      /** @param {ng.ExceptionHandlerProvider} $exceptionHandlerProvider */
+      ($exceptionHandlerProvider) => {
+        exceptionHandlerProvider.handler = (error) => {
+          myLogger.capture(error);
+          // Rethrow to preserve fail-fast behavior:
+          throw error;
+        };
+      }
+    ]);
+  ```
+
+---
+
+For service description, see [$exceptionHandler](../../../docs/service/exceptionhandler/).

docs/content/docs/service/exceptionHandler.md

@@ -0,0 +1,24 @@
+---
+title: $exceptionHandler
+description: >
+  Error handling service
+---
+
+### Description 
+
+`$exceptionHandler` is the central hook for uncaught exceptions inside an AngularTS application.
+The framework routes all errors from synchronous code, async tasks, expression evaluation, and dependency injection through this service.
+
+By default, it rethrows exceptions that occur during AngularTS-managed execution. This fail-fast behavior ensures errors are visible immediately in development and in unit tests.
+<div class="alert alert-danger" role="alert">
+
+**IMPORTANT**: In AngularJS, `$exceptionHandler` only caught errors in expressions and 
+logged them to the console, using a type signature of `$exceptionHandler(exception, [cause])`.
+
+AngularTS treats `$exceptionHandler` as a single error sink, fails eagerly, and assumes that the [Error](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) object or one of its subclasses provides all the context necessary for the client.
+
+</div>
+
+For type description, see [ng.ExceptionHandler](../../../typedoc/types/ExceptionHandler.html).
+
+For service customisation, see [ng.ExceptionHandlerProvider](../../../docs/provider/exceptionhandlerprovider/)