fix: isolate chained callbacks and fix TSDoc links

- chainCallback() now invokes each callback in its own try/catch
  so a throwing first callback cannot suppress the second
- Replace {@link enableHydration} with plain text in declarative
  TSDoc to avoid ae-unresolved-link warnings in doc:exports:ci

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: janechu

packages/fast-element/SIZES.md

@@ -4,7 +4,7 @@ Bundle sizes for `@microsoft/fast-element` exports.
 
 | Export | Minified | Gzip | Brotli |
 |--------|----------|------|--------|
-| CDN Rollup Bundle | 65.04 KB | 19.35 KB | 17.30 KB |
+| CDN Rollup Bundle | 65.07 KB | 19.35 KB | 17.29 KB |
 | FASTElement | 23.71 KB | 7.37 KB | 6.63 KB |
 | Updates | 473 B | 337 B | 287 B |
 | Observable | 6.70 KB | 2.49 KB | 2.22 KB |
@@ -19,6 +19,6 @@ Bundle sizes for `@microsoft/fast-element` exports.
 | repeat | 29.57 KB | 9.42 KB | 8.47 KB |
 | css | 2.43 KB | 1.00 KB | 911 B |
 | ElementStyles | 1.65 KB | 729 B | 623 B |
-| enableHydration | 43.21 KB | 13.20 KB | 11.88 KB |
+| enableHydration | 43.23 KB | 13.21 KB | 11.88 KB |
 | ArrayObserver | 12.51 KB | 4.45 KB | 4.01 KB |
-| declarativeTemplate | 85.65 KB | 26.21 KB | 23.10 KB |
+| declarativeTemplate | 85.68 KB | 26.22 KB | 23.09 KB |

packages/fast-element/src/components/hydration-tracker.ts

@@ -95,7 +95,15 @@ function chainCallback(
     if (!first) return second;
     if (!second) return first;
     return () => {
-        first();
-        second();
+        try {
+            first();
+        } catch {
+            // Isolate callbacks so one consumer cannot suppress another.
+        }
+        try {
+            second();
+        } catch {
+            // Isolate callbacks so one consumer cannot suppress another.
+        }
     };
 }

packages/fast-element/src/declarative/template.ts

@@ -118,11 +118,11 @@ export interface ElementOptionsDictionary<ElementOptionsType = ElementOptions> {
  * This interface combines template lifecycle callbacks with
  * global hydration events. It is accepted by
  * {@link TemplateElement.config} for backward compatibility.
- * New code should prefer {@link enableHydration} for global
+ * New code should prefer `enableHydration()` for global
  * hydration events and pass per-element callbacks directly to
  * {@link declarativeTemplate}.
  *
- * @deprecated Use {@link enableHydration} and {@link declarativeTemplate} callbacks instead.
+ * @deprecated Use `enableHydration()` and {@link declarativeTemplate} callbacks instead.
  * @public
  */
 export interface HydrationLifecycleCallbacks extends TemplateLifecycleCallbacks {

sites/website/src/docs/3.x/api/fast-element/declarative/fast-element.hydrationlifecyclecallbacks.md

@@ -17,7 +17,7 @@ navigationOptions:
 
 > Warning: This API is now obsolete.
 > 
-> Use  and [declarativeTemplate()](../fast-element.declarativetemplate/) callbacks instead.
+> Use `enableHydration()` and [declarativeTemplate()](../fast-element.declarativetemplate/) callbacks instead.
 > 
 
 Lifecycle callbacks for template events.
@@ -31,7 +31,7 @@ export interface HydrationLifecycleCallbacks extends TemplateLifecycleCallbacks
 
 ## Remarks
 
-This interface combines template lifecycle callbacks with global hydration events. It is accepted by [TemplateElement.config()](../fast-element.templateelement.config/) for backward compatibility. New code should prefer  for global hydration events and pass per-element callbacks directly to [declarativeTemplate()](../fast-element.declarativetemplate/)<!-- -->.
+This interface combines template lifecycle callbacks with global hydration events. It is accepted by [TemplateElement.config()](../fast-element.templateelement.config/) for backward compatibility. New code should prefer `enableHydration()` for global hydration events and pass per-element callbacks directly to [declarativeTemplate()](../fast-element.declarativetemplate/)<!-- -->.
 
 ## Methods
 

sites/website/src/docs/3.x/resources/export-sizes.md

@@ -19,7 +19,7 @@ Bundle sizes for `@microsoft/fast-element` exports.
 
 | Export | Minified | Gzip | Brotli |
 |--------|----------|------|--------|
-| CDN Rollup Bundle | 65.04 KB | 19.35 KB | 17.30 KB |
+| CDN Rollup Bundle | 65.07 KB | 19.35 KB | 17.29 KB |
 | FASTElement | 23.71 KB | 7.37 KB | 6.63 KB |
 | Updates | 473 B | 337 B | 287 B |
 | Observable | 6.70 KB | 2.49 KB | 2.22 KB |
@@ -34,6 +34,6 @@ Bundle sizes for `@microsoft/fast-element` exports.
 | repeat | 29.57 KB | 9.42 KB | 8.47 KB |
 | css | 2.43 KB | 1.00 KB | 911 B |
 | ElementStyles | 1.65 KB | 729 B | 623 B |
-| enableHydration | 43.21 KB | 13.20 KB | 11.88 KB |
+| enableHydration | 43.23 KB | 13.21 KB | 11.88 KB |
 | ArrayObserver | 12.51 KB | 4.45 KB | 4.01 KB |
-| declarativeTemplate | 85.65 KB | 26.21 KB | 23.10 KB |
+| declarativeTemplate | 85.68 KB | 26.22 KB | 23.09 KB |