@microsoft/fast-element 2.9.1 → 2.10.0

package/dist/fast-element.api.json

@@ -330,7 +330,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type AddBehavior = "
+              "text": "export type AddBehavior = "
             },
             {
               "kind": "Content",
@@ -374,7 +374,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type AddViewBehaviorFactory = "
+              "text": "export type AddViewBehaviorFactory = "
             },
             {
               "kind": "Content",
@@ -957,7 +957,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type AttributeConfiguration = "
+              "text": "export type AttributeConfiguration = "
             },
             {
               "kind": "Content",
@@ -1437,7 +1437,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type AttributeMode = "
+              "text": "export type AttributeMode = "
             },
             {
               "kind": "Content",
@@ -1959,7 +1959,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type Callable = "
+              "text": "export type Callable = "
             },
             {
               "kind": "Content",
@@ -2444,7 +2444,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type ChildrenDirectiveOptions<T = "
+              "text": "export type ChildrenDirectiveOptions<T = "
             },
             {
               "kind": "Content",
@@ -2505,7 +2505,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type Class<T, C = "
+              "text": "export type Class<T, C = "
             },
             {
               "kind": "Content",
@@ -2572,7 +2572,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type CompilationStrategy = "
+              "text": "export type CompilationStrategy = "
             },
             {
               "kind": "Content",
@@ -2639,7 +2639,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type CompiledViewBehaviorFactory = "
+              "text": "export type CompiledViewBehaviorFactory = "
             },
             {
               "kind": "Reference",
@@ -2783,7 +2783,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type ComposableStyles = "
+              "text": "export type ComposableStyles = "
             },
             {
               "kind": "Content",
@@ -2823,7 +2823,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type Constructable<T = "
+              "text": "export type Constructable<T = "
             },
             {
               "kind": "Content",
@@ -2870,7 +2870,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type ConstructibleStyleStrategy = "
+              "text": "export type ConstructibleStyleStrategy = "
             },
             {
               "kind": "Content",
@@ -4016,7 +4016,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type CSSTemplateTag = "
+              "text": "export type CSSTemplateTag = "
             },
             {
               "kind": "Content",
@@ -4096,7 +4096,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type CSSValue<TSource, TParent = "
+              "text": "export type CSSValue<TSource, TParent = "
             },
             {
               "kind": "Content",
@@ -4250,7 +4250,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type DecoratorAttributeConfiguration = "
+              "text": "export type DecoratorAttributeConfiguration = "
             },
             {
               "kind": "Reference",
@@ -4427,7 +4427,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type DOMAspect = "
+              "text": "export type DOMAspect = "
             },
             {
               "kind": "Content",
@@ -4667,7 +4667,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type DOMSink = "
+              "text": "export type DOMSink = "
             },
             {
               "kind": "Content",
@@ -6194,7 +6194,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type ElementsFilter = "
+              "text": "export type ElementsFilter = "
             },
             {
               "kind": "Content",
@@ -7569,7 +7569,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type Expression<TSource = "
+              "text": "export type Expression<TSource = "
             },
             {
               "kind": "Content",
@@ -11512,7 +11512,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type HTMLTemplateTag = "
+              "text": "export type HTMLTemplateTag = "
             },
             {
               "kind": "Content",
@@ -12578,7 +12578,7 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "static lifecycleCallbacks?: "
+                  "text": "static lifecycleCallbacks: "
                 },
                 {
                   "kind": "Reference",
@@ -12591,7 +12591,7 @@
                 }
               ],
               "isReadonly": false,
-              "isOptional": true,
+              "isOptional": false,
               "releaseTag": "Beta",
               "name": "lifecycleCallbacks",
               "propertyTypeTokenRange": {
@@ -13107,26 +13107,57 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export interface HydrationControllerCallbacks "
+              "text": "export interface HydrationControllerCallbacks<TElement extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "HTMLElement",
+              "canonicalReference": "!HTMLElement:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " = "
+            },
+            {
+              "kind": "Reference",
+              "text": "HTMLElement",
+              "canonicalReference": "!HTMLElement:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "> "
             }
           ],
           "fileUrlPath": "dist/dts/components/element-controller.d.ts",
           "releaseTag": "Public",
+          "typeParameters": [
+            {
+              "typeParameterName": "TElement",
+              "constraintTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              }
+            }
+          ],
           "name": "HydrationControllerCallbacks",
           "preserveMemberOrder": false,
           "members": [
             {
               "kind": "MethodSignature",
               "canonicalReference": "@microsoft/fast-element!HydrationControllerCallbacks#elementDidHydrate:member(1)",
-              "docComment": "/**\n * Called after hydration has finished\n */\n",
+              "docComment": "/**\n * Called after an individual element's hydration has finished\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "elementDidHydrate?(name: "
+                  "text": "elementDidHydrate?(source: "
                 },
                 {
                   "kind": "Content",
-                  "text": "string"
+                  "text": "TElement"
                 },
                 {
                   "kind": "Content",
@@ -13150,7 +13181,7 @@
               "overloadIndex": 1,
               "parameters": [
                 {
-                  "parameterName": "name",
+                  "parameterName": "source",
                   "parameterTypeTokenRange": {
                     "startIndex": 1,
                     "endIndex": 2
@@ -13163,15 +13194,15 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@microsoft/fast-element!HydrationControllerCallbacks#elementWillHydrate:member(1)",
-              "docComment": "/**\n * Called before hydration has started\n */\n",
+              "docComment": "/**\n * Called before an individual element's hydration begins\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "elementWillHydrate?(name: "
+                  "text": "elementWillHydrate?(source: "
                 },
                 {
                   "kind": "Content",
-                  "text": "string"
+                  "text": "TElement"
                 },
                 {
                   "kind": "Content",
@@ -13195,7 +13226,7 @@
               "overloadIndex": 1,
               "parameters": [
                 {
-                  "parameterName": "name",
+                  "parameterName": "source",
                   "parameterTypeTokenRange": {
                     "startIndex": 1,
                     "endIndex": 2
@@ -13232,6 +13263,34 @@
               "overloadIndex": 1,
               "parameters": [],
               "name": "hydrationComplete"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@microsoft/fast-element!HydrationControllerCallbacks#hydrationStarted:member(1)",
+              "docComment": "/**\n * Called once when the first element enters the hydration pipeline. This is the earliest point at which we know a component has been async-defined with `defer-and-hydrate`, a template is pending via `<f-template>`, and the element has `needs-hydration`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "hydrationStarted?(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "hydrationStarted"
             }
           ],
           "extendsTokenRanges": []
@@ -18698,7 +18757,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type SourceLifetime = "
+              "text": "export type SourceLifetime = "
             },
             {
               "kind": "Content",
@@ -19897,7 +19956,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type SpliceStrategySupport = "
+              "text": "export type SpliceStrategySupport = "
             },
             {
               "kind": "Content",
@@ -21655,7 +21714,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type TemplateOptions = "
+              "text": "export type TemplateOptions = "
             },
             {
               "kind": "Content",
@@ -21722,7 +21781,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type TemplateValue<TSource, TParent = "
+              "text": "export type TemplateValue<TSource, TParent = "
             },
             {
               "kind": "Content",
@@ -21812,7 +21871,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type TrustedTypesPolicy = "
+              "text": "export type TrustedTypesPolicy = "
             },
             {
               "kind": "Content",
@@ -22656,7 +22715,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type ViewBehaviorTargets = "
+              "text": "export type ViewBehaviorTargets = "
             },
             {
               "kind": "Content",

package/dist/fast-element.d.ts

@@ -431,7 +431,7 @@ export declare const DI: Readonly<{
      *
      * @public
      */
-    transient<T extends Constructable<{}>>(target: T & Partial<RegisterSelf<T>>): T & RegisterSelf<T>;
+    transient<T extends Constructable>(target: T & Partial<RegisterSelf<T>>): T & RegisterSelf<T>;
     /**
      * Registers the `target` class as a singleton dependency; the class will only be created once. Each
      * consecutive time the dependency is resolved, the same instance will be returned.
@@ -455,7 +455,7 @@ export declare const DI: Readonly<{
      *
      * @public
      */
-    singleton<T_1 extends Constructable<{}>>(target: T_1 & Partial<RegisterSelf<T_1>>, options?: SingletonOptions): T_1 & RegisterSelf<T_1>;
+    singleton<T_1 extends Constructable>(target: T_1 & Partial<RegisterSelf<T_1>>, options?: SingletonOptions): T_1 & RegisterSelf<T_1>;
 }>;
 
 /**
@@ -762,7 +762,7 @@ export declare const Registration: Readonly<{
      * @param key - The key to register the singleton under.
      * @param value - The class to instantiate as a singleton when first requested.
      */
-    singleton<T_1 extends Constructable<{}>>(key: Key, value: T_1): Registration<InstanceType<T_1>>;
+    singleton<T_1 extends Constructable>(key: Key, value: T_1): Registration<InstanceType<T_1>>;
     /**
      * Creates an instance from a class.
      * Every time you request this {@link Key} you will get a new instance.
@@ -775,7 +775,7 @@ export declare const Registration: Readonly<{
      * @param key - The key to register the instance type under.
      * @param value - The class to instantiate each time the key is requested.
      */
-    transient<T_2 extends Constructable<{}>>(key: Key, value: T_2): Registration<InstanceType<T_2>>;
+    transient<T_2 extends Constructable>(key: Key, value: T_2): Registration<InstanceType<T_2>>;
     /**
      * Delegates to a callback function to provide the dependency.
      * Every time you request this {@link Key} the callback will be invoked to provide