@microsoft/fast-element 2.8.3 → 2.8.5

package/.eslintrc.json

@@ -1,5 +1,5 @@
 {
-    "extends": ["../../../.eslintrc.js"],
+    "extends": ["../../.eslintrc.js"],
     "rules": {
         "max-classes-per-file": "off",
         "no-case-declarations": "off",

package/CHANGELOG.json

@@ -2,7 +2,52 @@
   "name": "@microsoft/fast-element",
   "entries": [
     {
-      "date": "Wed, 12 Nov 2025 20:41:22 GMT",
+      "date": "Tue, 02 Dec 2025 21:46:27 GMT",
+      "version": "2.8.5",
+      "tag": "@microsoft/fast-element_v2.8.5",
+      "comments": {
+        "patch": [
+          {
+            "author": "863023+radium-v@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "78c90cc517baa58b21e1dfc99939636fac7fbac6",
+            "comment": "fix: move hydration lifecycle callback to correct position"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Mon, 01 Dec 2025 18:46:00 GMT",
+      "version": "2.8.4",
+      "tag": "@microsoft/fast-element_v2.8.4",
+      "comments": {
+        "patch": [
+          {
+            "author": "mmansour@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "ed14307460fecef6636c0402199528f1db2cf97d",
+            "comment": "chore: add interfaces to sideEffects"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Sun, 16 Nov 2025 07:14:24 GMT",
+      "version": "2.8.3",
+      "tag": "@microsoft/fast-element_v2.8.3",
+      "comments": {
+        "none": [
+          {
+            "author": "13071055+chrisdholt@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "acbdd78666f70b0b49dc99f61b71af7c0b3e259e",
+            "comment": "chore: flatten repository package structure"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Wed, 12 Nov 2025 20:41:54 GMT",
       "version": "2.8.3",
       "tag": "@microsoft/fast-element_v2.8.3",
       "comments": {

package/CHANGELOG.md

@@ -1,12 +1,28 @@
 # Change Log - @microsoft/fast-element
 
-<!-- This log was last generated on Wed, 12 Nov 2025 20:41:22 GMT and should not be manually modified. -->
+<!-- This log was last generated on Tue, 02 Dec 2025 21:46:27 GMT and should not be manually modified. -->
 
 <!-- Start content -->
 
+## 2.8.5
+
+Tue, 02 Dec 2025 21:46:27 GMT
+
+### Patches
+
+- fix: move hydration lifecycle callback to correct position (863023+radium-v@users.noreply.github.com)
+
+## 2.8.4
+
+Mon, 01 Dec 2025 18:46:00 GMT
+
+### Patches
+
+- chore: add interfaces to sideEffects (mmansour@microsoft.com)
+
 ## 2.8.3
 
-Wed, 12 Nov 2025 20:41:22 GMT
+Wed, 12 Nov 2025 20:41:54 GMT
 
 ### Patches
 

package/api-extractor.context.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
-    "extends": "../../../api-extractor.json",
+    "extends": "../../api-extractor.json",
     "mainEntryPointFilePath": "./dist/dts/context.d.ts",
     "apiReport": {
         "enabled": true,

package/api-extractor.di.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
-    "extends": "../../../api-extractor.json",
+    "extends": "../../api-extractor.json",
     "mainEntryPointFilePath": "./dist/dts/di/di.d.ts",
     "apiReport": {
         "enabled": true,

package/dist/dts/components/element-controller.d.ts

@@ -6,6 +6,10 @@ import type { StyleStrategy, StyleTarget } from "../styles/style-strategy.js";
 import type { ElementViewTemplate } from "../templating/template.js";
 import type { ElementView } from "../templating/view.js";
 import { FASTElementDefinition, ShadowRootOptions } from "./fast-definitions.js";
+/**
+ * @deprecated Use the export from ./hydration.js instead.
+ */
+export { deferHydrationAttribute } from "./hydration.js";
 /**
  * A type that instantiates an ElementController
  * @public
@@ -256,11 +260,6 @@ export declare class StyleElementStrategy implements StyleStrategy {
     addStylesTo(target: StyleTarget): void;
     removeStylesFrom(target: StyleTarget): void;
 }
-/**
- * The attribute used to defer hydration of an element.
- * @public
- */
-export declare const deferHydrationAttribute = "defer-hydration";
 /**
  * The attribute used to indicate that an element needs hydration.
  * @public

package/dist/dts/components/hydration.d.ts

@@ -58,6 +58,14 @@ export declare const Hydratable: unique symbol;
  * @beta
  */
 export declare function isHydratable(view: ViewController): view is HydrationView;
+/** @beta */
 export declare function isHydratable<TSource = any, TParent = any>(template: SyntheticViewTemplate<TSource, TParent>): template is HydratableSyntheticViewTemplate<TSource, TParent>;
+/** @beta */
 export declare function isHydratable<TSource = any, TParent = any>(template: ElementViewTemplate<TSource, TParent>): template is HydratableElementViewTemplate<TSource, TParent>;
+/** @beta */
 export declare function isHydratable(template: ContentTemplate): template is HydratableContentTemplate;
+/**
+ * The attribute used to defer hydration of an element.
+ * @beta
+ */
+export declare const deferHydrationAttribute = "defer-hydration";

package/dist/dts/index.d.ts

@@ -31,4 +31,5 @@ export { render, RenderBehavior, RenderDirective } from "./templating/render.js"
 export { customElement, FASTElement } from "./components/fast-element.js";
 export { FASTElementDefinition, PartialFASTElementDefinition, ShadowRootOptions, fastElementRegistry, TemplateOptions, TypeRegistry, type TemplateLifecycleCallbacks, } from "./components/fast-definitions.js";
 export { attr, AttributeConfiguration, AttributeDefinition, AttributeMode, booleanConverter, DecoratorAttributeConfiguration, nullableBooleanConverter, nullableNumberConverter, ValueConverter, } from "./components/attributes.js";
-export { deferHydrationAttribute, ElementController, ElementControllerStrategy, HydratableElementController, type HydrationControllerCallbacks, needsHydrationAttribute, Stages, } from "./components/element-controller.js";
+export { ElementController, ElementControllerStrategy, HydratableElementController, type HydrationControllerCallbacks, needsHydrationAttribute, Stages, } from "./components/element-controller.js";
+export { deferHydrationAttribute, isHydratable } from "./components/hydration.js";

package/dist/esm/components/element-controller.js

@@ -5,7 +5,11 @@ import { FAST, makeSerializationNoop } from "../platform.js";
 import { ElementStyles } from "../styles/element-styles.js";
 import { UnobservableMutationObserver } from "../utilities.js";
 import { FASTElementDefinition, TemplateOptions, } from "./fast-definitions.js";
-import { HydrationMarkup, isHydratable } from "./hydration.js";
+import { deferHydrationAttribute, HydrationMarkup, isHydratable } from "./hydration.js";
+/**
+ * @deprecated Use the export from ./hydration.js instead.
+ */
+export { deferHydrationAttribute } from "./hydration.js";
 const defaultEventOptions = {
     bubbles: true,
     composed: true,
@@ -623,11 +627,6 @@ if (ElementStyles.supportsAdoptedStyleSheets) {
 else {
     ElementStyles.setDefaultStrategy(StyleElementStrategy);
 }
-/**
- * The attribute used to defer hydration of an element.
- * @public
- */
-export const deferHydrationAttribute = "defer-hydration";
 /**
  * The attribute used to indicate that an element needs hydration.
  * @public
@@ -712,9 +711,6 @@ export class HydratableElementController extends ElementController {
         // Initialize needsHydration on first connect
         this.needsHydration =
             (_a = this.needsHydration) !== null && _a !== void 0 ? _a : this.source.hasAttribute(needsHydrationAttribute);
-        if (this.needsHydration) {
-            (_c = (_b = HydratableElementController.lifecycleCallbacks) === null || _b === void 0 ? void 0 : _b.elementWillHydrate) === null || _c === void 0 ? void 0 : _c.call(_b, this.definition.name);
-        }
         // If the `defer-hydration` attribute exists on the source,
         // wait for it to be removed before continuing connection behavior.
         if (this.source.hasAttribute(deferHydrationAttribute)) {
@@ -736,6 +732,7 @@ export class HydratableElementController extends ElementController {
         if (this.stage !== 3 /* Stages.disconnected */) {
             return;
         }
+        (_c = (_b = HydratableElementController.lifecycleCallbacks) === null || _b === void 0 ? void 0 : _b.elementWillHydrate) === null || _c === void 0 ? void 0 : _c.call(_b, this.definition.name);
         this.stage = 0 /* Stages.connecting */;
         this.bindObservables();
         this.connectBehaviors();

package/dist/esm/components/hydration.js

@@ -122,6 +122,12 @@ function parseIndexAndIdMarker(regex, content) {
  * @internal
  */
 export const Hydratable = Symbol.for("fe-hydration");
+/** @beta */
 export function isHydratable(value) {
     return value[Hydratable] === Hydratable;
 }
+/**
+ * The attribute used to defer hydration of an element.
+ * @beta
+ */
+export const deferHydrationAttribute = "defer-hydration";

package/dist/esm/index.js

@@ -36,4 +36,5 @@ export { render, RenderBehavior, RenderDirective } from "./templating/render.js"
 export { customElement, FASTElement } from "./components/fast-element.js";
 export { FASTElementDefinition, fastElementRegistry, TemplateOptions, } from "./components/fast-definitions.js";
 export { attr, AttributeConfiguration, AttributeDefinition, booleanConverter, nullableBooleanConverter, nullableNumberConverter, } from "./components/attributes.js";
-export { deferHydrationAttribute, ElementController, HydratableElementController, needsHydrationAttribute, } from "./components/element-controller.js";
+export { ElementController, HydratableElementController, needsHydrationAttribute, } from "./components/element-controller.js";
+export { deferHydrationAttribute, isHydratable } from "./components/hydration.js";

package/dist/fast-element.api.json

@@ -4286,7 +4286,7 @@
         {
           "kind": "Variable",
           "canonicalReference": "@microsoft/fast-element!deferHydrationAttribute:var",
-          "docComment": "/**\n * The attribute used to defer hydration of an element.\n *\n * @public\n */\n",
+          "docComment": "/**\n * The attribute used to defer hydration of an element.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -4297,13 +4297,13 @@
               "text": "\"defer-hydration\""
             }
           ],
-          "fileUrlPath": "dist/dts/components/element-controller.d.ts",
+          "fileUrlPath": "dist/dts/components/hydration.d.ts",
           "initializerTokenRange": {
             "startIndex": 1,
             "endIndex": 2
           },
           "isReadonly": true,
-          "releaseTag": "Public",
+          "releaseTag": "Beta",
           "name": "deferHydrationAttribute",
           "variableTypeTokenRange": {
             "startIndex": 0,
@@ -13411,6 +13411,326 @@
             }
           ]
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@microsoft/fast-element!isHydratable:function(1)",
+          "docComment": "/**\n * Tests if a template or ViewController is hydratable.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function isHydratable(view: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ViewController",
+              "canonicalReference": "@microsoft/fast-element!ViewController:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "view",
+              "canonicalReference": "@microsoft/fast-element!~view"
+            },
+            {
+              "kind": "Content",
+              "text": " is "
+            },
+            {
+              "kind": "Reference",
+              "text": "HydrationView",
+              "canonicalReference": "@microsoft/fast-element!~HydrationView:class"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/dts/components/hydration.d.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 6
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "view",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "isHydratable"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@microsoft/fast-element!isHydratable:function(2)",
+          "docComment": "/**\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function isHydratable<TSource = "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ", TParent = "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ">(template: "
+            },
+            {
+              "kind": "Reference",
+              "text": "SyntheticViewTemplate",
+              "canonicalReference": "@microsoft/fast-element!SyntheticViewTemplate:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<TSource, TParent>"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "template",
+              "canonicalReference": "@microsoft/fast-element!~template"
+            },
+            {
+              "kind": "Content",
+              "text": " is "
+            },
+            {
+              "kind": "Reference",
+              "text": "HydratableSyntheticViewTemplate",
+              "canonicalReference": "@microsoft/fast-element!~HydratableSyntheticViewTemplate:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<TSource, TParent>"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/dts/components/hydration.d.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 8,
+            "endIndex": 12
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 2,
+          "parameters": [
+            {
+              "parameterName": "template",
+              "parameterTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 7
+              },
+              "isOptional": false
+            }
+          ],
+          "typeParameters": [
+            {
+              "typeParameterName": "TSource",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "typeParameterName": "TParent",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              }
+            }
+          ],
+          "name": "isHydratable"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@microsoft/fast-element!isHydratable:function(3)",
+          "docComment": "/**\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function isHydratable<TSource = "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ", TParent = "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ">(template: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ElementViewTemplate",
+              "canonicalReference": "@microsoft/fast-element!ElementViewTemplate:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<TSource, TParent>"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "template",
+              "canonicalReference": "@microsoft/fast-element!~template"
+            },
+            {
+              "kind": "Content",
+              "text": " is "
+            },
+            {
+              "kind": "Reference",
+              "text": "HydratableElementViewTemplate",
+              "canonicalReference": "@microsoft/fast-element!~HydratableElementViewTemplate:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<TSource, TParent>"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/dts/components/hydration.d.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 8,
+            "endIndex": 12
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 3,
+          "parameters": [
+            {
+              "parameterName": "template",
+              "parameterTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 7
+              },
+              "isOptional": false
+            }
+          ],
+          "typeParameters": [
+            {
+              "typeParameterName": "TSource",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "typeParameterName": "TParent",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              }
+            }
+          ],
+          "name": "isHydratable"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@microsoft/fast-element!isHydratable:function(4)",
+          "docComment": "/**\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function isHydratable(template: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ContentTemplate",
+              "canonicalReference": "@microsoft/fast-element!ContentTemplate:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "template",
+              "canonicalReference": "@microsoft/fast-element!~template"
+            },
+            {
+              "kind": "Content",
+              "text": " is "
+            },
+            {
+              "kind": "Reference",
+              "text": "HydratableContentTemplate",
+              "canonicalReference": "@microsoft/fast-element!~HydratableContentTemplate:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/dts/components/hydration.d.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 6
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 4,
+          "parameters": [
+            {
+              "parameterName": "template",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "isHydratable"
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@microsoft/fast-element!LengthObserver:interface",

package/dist/fast-element.debug.js

@@ -2442,9 +2442,15 @@ function parseIndexAndIdMarker(regex, content) {
  * @internal
  */
 const Hydratable = Symbol.for("fe-hydration");
+/** @beta */
 function isHydratable(value) {
     return value[Hydratable] === Hydratable;
 }
+/**
+ * The attribute used to defer hydration of an element.
+ * @beta
+ */
+const deferHydrationAttribute = "defer-hydration";
 
 const marker = `fast-${Math.random().toString(36).substring(2, 8)}`;
 const interpolationStart = `${marker}{`;
@@ -6088,11 +6094,6 @@ if (ElementStyles.supportsAdoptedStyleSheets) {
 else {
     ElementStyles.setDefaultStrategy(StyleElementStrategy);
 }
-/**
- * The attribute used to defer hydration of an element.
- * @public
- */
-const deferHydrationAttribute = "defer-hydration";
 /**
  * The attribute used to indicate that an element needs hydration.
  * @public
@@ -6177,9 +6178,6 @@ class HydratableElementController extends ElementController {
         // Initialize needsHydration on first connect
         this.needsHydration =
             (_a = this.needsHydration) !== null && _a !== void 0 ? _a : this.source.hasAttribute(needsHydrationAttribute);
-        if (this.needsHydration) {
-            (_c = (_b = HydratableElementController.lifecycleCallbacks) === null || _b === void 0 ? void 0 : _b.elementWillHydrate) === null || _c === void 0 ? void 0 : _c.call(_b, this.definition.name);
-        }
         // If the `defer-hydration` attribute exists on the source,
         // wait for it to be removed before continuing connection behavior.
         if (this.source.hasAttribute(deferHydrationAttribute)) {
@@ -6201,6 +6199,7 @@ class HydratableElementController extends ElementController {
         if (this.stage !== 3 /* Stages.disconnected */) {
             return;
         }
+        (_c = (_b = HydratableElementController.lifecycleCallbacks) === null || _b === void 0 ? void 0 : _b.elementWillHydrate) === null || _c === void 0 ? void 0 : _c.call(_b, this.definition.name);
         this.stage = 0 /* Stages.connecting */;
         this.bindObservables();
         this.connectBehaviors();
@@ -6393,4 +6392,4 @@ function customElement(nameOrDef) {
 
 DOM.setPolicy(DOMPolicy.create());
 
-export { ArrayObserver, AttributeConfiguration, AttributeDefinition, Binding, CSSBindingDirective, CSSDirective, ChildrenDirective, Compiler, DOM, DOMAspect, ElementController, ElementStyles, ExecutionContext, FAST, FASTElement, FASTElementDefinition, HTMLBindingDirective, HTMLDirective, HTMLView, HydratableElementController, HydrationBindingError, InlineTemplateDirective, Markup, NodeObservationDirective, Observable, Parser, PropertyChangeNotifier, RefDirective, RenderBehavior, RenderDirective, RepeatBehavior, RepeatDirective, SlottedDirective, Sort, SourceLifetime, Splice, SpliceStrategy, SpliceStrategySupport, StatelessAttachedAttributeDirective, SubscriberSet, TemplateOptions, Updates, ViewTemplate, attr, booleanConverter, children, css, cssDirective, customElement, deferHydrationAttribute, elements, emptyArray, fastElementRegistry, html, htmlDirective, lengthOf, listener, needsHydrationAttribute, normalizeBinding$1 as normalizeBinding, nullableBooleanConverter, nullableNumberConverter, observable, oneTime, oneWay, ref, render, repeat, slotted, sortedCount, volatile, when };
+export { ArrayObserver, AttributeConfiguration, AttributeDefinition, Binding, CSSBindingDirective, CSSDirective, ChildrenDirective, Compiler, DOM, DOMAspect, ElementController, ElementStyles, ExecutionContext, FAST, FASTElement, FASTElementDefinition, HTMLBindingDirective, HTMLDirective, HTMLView, HydratableElementController, HydrationBindingError, InlineTemplateDirective, Markup, NodeObservationDirective, Observable, Parser, PropertyChangeNotifier, RefDirective, RenderBehavior, RenderDirective, RepeatBehavior, RepeatDirective, SlottedDirective, Sort, SourceLifetime, Splice, SpliceStrategy, SpliceStrategySupport, StatelessAttachedAttributeDirective, SubscriberSet, TemplateOptions, Updates, ViewTemplate, attr, booleanConverter, children, css, cssDirective, customElement, deferHydrationAttribute, elements, emptyArray, fastElementRegistry, html, htmlDirective, isHydratable, lengthOf, listener, needsHydrationAttribute, normalizeBinding$1 as normalizeBinding, nullableBooleanConverter, nullableNumberConverter, observable, oneTime, oneWay, ref, render, repeat, slotted, sortedCount, volatile, when };