@microsoft/fast-element 1.10.2 → 2.0.0-beta.3

package/.eslintrc.json

@@ -3,6 +3,7 @@
     "rules": {
         "max-classes-per-file": "off",
         "no-case-declarations": "off",
+        "@typescript-eslint/no-non-null-assertion": "off",
         "@typescript-eslint/ban-types": [
             "error",
             {
@@ -13,18 +14,6 @@
                 },
                 "extendDefaults": true
             }
-        ],
-        "@typescript-eslint/no-use-before-define": ["error", { "typedefs": false }],
-        "@typescript-eslint/no-non-null-assertion": "off",
-        "@typescript-eslint/explicit-function-return-type": [
-            "error",
-            {
-                "allowExpressions": true
-            }
-        ],
-        "import/extensions": [
-            "error",
-            "always"
         ]
     }
 }

package/CHANGELOG.json

@@ -2,7 +2,393 @@
   "name": "@microsoft/fast-element",
   "entries": [
     {
-      "date": "Tue, 24 May 2022 07:08:28 GMT",
+      "date": "Wed, 22 Jun 2022 20:17:50 GMT",
+      "tag": "@microsoft/fast-element_v2.0.0-beta.3",
+      "version": "2.0.0-beta.3",
+      "comments": {
+        "prerelease": [
+          {
+            "comment": "fix: correct aspect type for content that looks like an attribute",
+            "author": "nicholasrice@users.noreply.github.com",
+            "commit": "f28cdb9fdba9cb27904acfad7444de82d447f39e",
+            "package": "@microsoft/fast-element"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Wed, 15 Jun 2022 17:41:10 GMT",
+      "tag": "@microsoft/fast-element_v2.0.0-beta.2",
+      "version": "2.0.0-beta.2",
+      "comments": {
+        "prerelease": [
+          {
+            "comment": "doc: add note to FASTElement.metadata API",
+            "author": "roeisenb@microsoft.com",
+            "commit": "359467f9ae67c46a33dfc28ce86dfd908072695d",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "when recycle is set to false while itemBinding stays the same, views should be recreated",
+            "author": "wendy.hsu@microsoft.com",
+            "commit": "9c92b9bb5bc9bf221b439c0a776b3621fdd9d9aa",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: simplify execution context to align closer with v1",
+            "author": "roeisenb@microsoft.com",
+            "commit": "488d051999c43b93a0beef4db30a2bddd6bbdc64",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: ergo improvements to context, array length, and metadata",
+            "author": "roeisenb@microsoft.com",
+            "commit": "12f5671e215ebd2b95c9cc83f856e233e01e9c4a",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: move optional bindings out of rollup and list as exports",
+            "author": "roeisenb@microsoft.com",
+            "commit": "e86a638b9e84cbf36d950025889742944e68e512",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "fix: make SyntheticViewTemplate type a string so it is generally usable",
+            "author": "roeisenb@microsoft.com",
+            "commit": "de7f234ef871204fcac2b5df59433d919809341d",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: implement W3C WC community context protocol and integrate with DI",
+            "author": "roeisenb@microsoft.com",
+            "commit": "c45297c0ca48b7e5f4343ba48e5183f2bccdb946",
+            "package": "@microsoft/fast-element"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Wed, 01 Jun 2022 17:53:14 GMT",
+      "tag": "@microsoft/fast-element_v2.0.0-beta.1",
+      "version": "2.0.0-beta.1",
+      "comments": {
+        "prerelease": [
+          {
+            "comment": "`DOM` - Tree Walker methods are no longer used and are thus removed. The API for removing child nodes has been removed as well since it was only used in one place and could be inlined. The helper `createCustomAttributePlaceholder()` no longer requires an attribute name. It will be uniquely generated internally.",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "`class` - Bindings to `class` are now more nuanced. Binding directly to `class` will simply set the `className` property. If you need to bind to `class` knowing that manual JS will also manipulate the `classList` in addition to the binding, then you should now bind to `:classList` instead. This allows for performance optimizations in the simple, most common case.",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "`Behavior` and `ViewBehavior` - `Behavior` now requires an `ExecutionContext` for `unbind`. Behaviors can be used for elements or views. `ViewBehavior` has been introduced for use exclusively with views, and provides some optimization opportunities.",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "`RefBehavior` has been replaced with `RefDirective`. The directive also implements `ViewBehavior` allowing a single directive instance to be shared across all template instances that use the ref.",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "Removed `SlottedBehavior` and `ChildrenBehavior` have been replaced with `SlottedDirective` and `ChildrenDirective`. These directives allow a single directive instance to be shared across all template instances that use the ref.",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "Removed `AttachedBehaviorHTMLDirective` and `AttachedBehaviorType` since they are no longer used in the new directive/behavior architecture for ref, slotted, and children.",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "Renamed `Notifier#source` to `Notifier#subject` to align with other observable terminology and prevent name clashes with `BindingObserver` properties.",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: create unified API for parsing markers",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "allow null values in attributeChangedCallback",
+            "author": "nicholasrice@users.noreply.github.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: add splice strategies for array observation",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: handle existing shadow roots when upgrading",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "fix: enable safer type inference on the repeat helper",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "Set prerelease version",
+            "author": "nicholasrice@users.noreply.github.com",
+            "commit": "5b313a3262b977acbee3c2efac87d0d14a82f792",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "refactor: separate update queue from DOM and fix architectural layers",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: aspected html directive exposes metadata",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "`HTMLDirective` - The `targetIndex: number` property has been replaced by a `targetId: string` property. The `createBehavior` method no longer takes a target `Node` but instead takes a `BehaviorTargets` instance. The actual target can be looked up on the `BehaviorTargets` instance by indexing with the `targetId` property.",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "`compileTemplate()` - Internals have been significantly changed. The implementation no longer uses a TreeWalker. The return type has change to an `HTMLTemplateCompilationResult` with different properties.",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "refactor: move template/style resolution to lazy getter",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "refactor: enable pluggable template compiler for SSR scenarios",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: enable pluggable style handling strategies",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "fix(fast-element): do not notify splices for changes pre-subscription",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: new directive registration/identification model",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "fix: prevent duplicative array observation patch",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "Adds Aspect as public export",
+            "author": "nicholasrice@users.noreply.github.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: expose official Markup and Parser APIs",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "refactor: refine binding mode types",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: add two-way binding",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "fix: defend against for/in use on arrays",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "fix: merge bug related to moved APIs",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: enable multiple instances of fast-element on a page at once",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "Upgrade TypeScript",
+            "author": "nicholasrice@users.noreply.github.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "enumerate fast-element package as a ES module package",
+            "author": "nicholasrice@users.noreply.github.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: enable array length observation",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: add utilities and hooks, and change exports",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "refactor: new design for execution context",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "chore: fast-element package and build modernization",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: new CSSDirective design",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "chore: configure fast-element for internal stripping",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: enable synchronous dom updates for SSR",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "refactor: extract polyfill and polyfill-like code to an optional module",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "feat: add warn/error message infrastructure",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "`View` and `HTMLView` - Type parameters added to enable strongly typed views based on their data source. The constructor of `HTMLView` has a new signature based on changes to the compiler's output. Internals have been cleaned up and no longer rely on the Range type.",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "`ElementViewTemplate`, `SyntheticViewTemplate`, and `ViewTemplate` - Added type parameters throughout. Logic to instantiate and apply behaviors moved out of the template and into the view where it can be lazily executed. Removed the ability of the `render` method to take a string id of the node to render to. You must provide a node.",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          }
+        ],
+        "none": [
+          {
+            "comment": "update api extractor and typescript to use the latest versions",
+            "author": "chhol@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "docs: add alpha tags to unfinished binding APIs",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "automated update of api-report.md",
+            "author": "nicholasrice@users.noreply.github.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "Fixed linting errors and warnings",
+            "author": "7559015+janechu@users.noreply.github.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "remove unnecessary dependency on @types/ie11 package",
+            "author": "chhol@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          },
+          {
+            "comment": "Updated api-extractor version and exported markdown",
+            "author": "7559015+janechu@users.noreply.github.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-element"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Sun, 29 May 2022 07:08:52 GMT",
+      "tag": "@microsoft/fast-element_v1.10.2",
+      "version": "1.10.2",
+      "comments": {
+        "none": [
+          {
+            "comment": "add md extensions to referenced doc links for fast-element readme",
+            "author": "steph@huynhicode.dev",
+            "commit": "283b4838d46ed83c70ff4ad91f7f72a4936d59bf",
+            "package": "@microsoft/fast-element"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Tue, 24 May 2022 07:10:02 GMT",
       "tag": "@microsoft/fast-element_v1.10.2",
       "version": "1.10.2",
       "comments": {

package/CHANGELOG.md

@@ -1,12 +1,84 @@
 # Change Log - @microsoft/fast-element
 
-This log was last generated on Tue, 24 May 2022 07:08:28 GMT and should not be manually modified.
+This log was last generated on Wed, 22 Jun 2022 20:17:50 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## 2.0.0-beta.3
+
+Wed, 22 Jun 2022 20:17:50 GMT
+
+### Changes
+
+- fix: correct aspect type for content that looks like an attribute (nicholasrice@users.noreply.github.com)
+
+## 2.0.0-beta.2
+
+Wed, 15 Jun 2022 17:41:10 GMT
+
+### Changes
+
+- doc: add note to FASTElement.metadata API (roeisenb@microsoft.com)
+- when recycle is set to false while itemBinding stays the same, views should be recreated (wendy.hsu@microsoft.com)
+- feat: simplify execution context to align closer with v1 (roeisenb@microsoft.com)
+- feat: ergo improvements to context, array length, and metadata (roeisenb@microsoft.com)
+- feat: move optional bindings out of rollup and list as exports (roeisenb@microsoft.com)
+- fix: make SyntheticViewTemplate type a string so it is generally usable (roeisenb@microsoft.com)
+- feat: implement W3C WC community context protocol and integrate with DI (roeisenb@microsoft.com)
+
+## 2.0.0-beta.1
+
+Wed, 01 Jun 2022 17:53:14 GMT
+
+### Changes
+
+- `DOM` - Tree Walker methods are no longer used and are thus removed. The API for removing child nodes has been removed as well since it was only used in one place and could be inlined. The helper `createCustomAttributePlaceholder()` no longer requires an attribute name. It will be uniquely generated internally. (roeisenb@microsoft.com)
+- `class` - Bindings to `class` are now more nuanced. Binding directly to `class` will simply set the `className` property. If you need to bind to `class` knowing that manual JS will also manipulate the `classList` in addition to the binding, then you should now bind to `:classList` instead. This allows for performance optimizations in the simple, most common case. (roeisenb@microsoft.com)
+- `Behavior` and `ViewBehavior` - `Behavior` now requires an `ExecutionContext` for `unbind`. Behaviors can be used for elements or views. `ViewBehavior` has been introduced for use exclusively with views, and provides some optimization opportunities. (roeisenb@microsoft.com)
+- `RefBehavior` has been replaced with `RefDirective`. The directive also implements `ViewBehavior` allowing a single directive instance to be shared across all template instances that use the ref. (roeisenb@microsoft.com)
+- Removed `SlottedBehavior` and `ChildrenBehavior` have been replaced with `SlottedDirective` and `ChildrenDirective`. These directives allow a single directive instance to be shared across all template instances that use the ref. (roeisenb@microsoft.com)
+- Removed `AttachedBehaviorHTMLDirective` and `AttachedBehaviorType` since they are no longer used in the new directive/behavior architecture for ref, slotted, and children. (roeisenb@microsoft.com)
+- Renamed `Notifier#source` to `Notifier#subject` to align with other observable terminology and prevent name clashes with `BindingObserver` properties. (roeisenb@microsoft.com)
+- feat: create unified API for parsing markers (roeisenb@microsoft.com)
+- allow null values in attributeChangedCallback (nicholasrice@users.noreply.github.com)
+- feat: add splice strategies for array observation (roeisenb@microsoft.com)
+- feat: handle existing shadow roots when upgrading (roeisenb@microsoft.com)
+- fix: enable safer type inference on the repeat helper (roeisenb@microsoft.com)
+- Set prerelease version (nicholasrice@users.noreply.github.com)
+- refactor: separate update queue from DOM and fix architectural layers (roeisenb@microsoft.com)
+- feat: aspected html directive exposes metadata (roeisenb@microsoft.com)
+- `HTMLDirective` - The `targetIndex: number` property has been replaced by a `targetId: string` property. The `createBehavior` method no longer takes a target `Node` but instead takes a `BehaviorTargets` instance. The actual target can be looked up on the `BehaviorTargets` instance by indexing with the `targetId` property. (roeisenb@microsoft.com)
+- `compileTemplate()` - Internals have been significantly changed. The implementation no longer uses a TreeWalker. The return type has change to an `HTMLTemplateCompilationResult` with different properties. (roeisenb@microsoft.com)
+- refactor: move template/style resolution to lazy getter (roeisenb@microsoft.com)
+- refactor: enable pluggable template compiler for SSR scenarios (roeisenb@microsoft.com)
+- feat: enable pluggable style handling strategies (roeisenb@microsoft.com)
+- fix(fast-element): do not notify splices for changes pre-subscription (roeisenb@microsoft.com)
+- feat: new directive registration/identification model (roeisenb@microsoft.com)
+- fix: prevent duplicative array observation patch (roeisenb@microsoft.com)
+- Adds Aspect as public export (nicholasrice@users.noreply.github.com)
+- feat: expose official Markup and Parser APIs (roeisenb@microsoft.com)
+- refactor: refine binding mode types (roeisenb@microsoft.com)
+- feat: add two-way binding (roeisenb@microsoft.com)
+- fix: defend against for/in use on arrays (roeisenb@microsoft.com)
+- fix: merge bug related to moved APIs (roeisenb@microsoft.com)
+- feat: enable multiple instances of fast-element on a page at once (roeisenb@microsoft.com)
+- Upgrade TypeScript (nicholasrice@users.noreply.github.com)
+- enumerate fast-element package as a ES module package (nicholasrice@users.noreply.github.com)
+- feat: enable array length observation (roeisenb@microsoft.com)
+- feat: add utilities and hooks, and change exports (roeisenb@microsoft.com)
+- refactor: new design for execution context (roeisenb@microsoft.com)
+- chore: fast-element package and build modernization (roeisenb@microsoft.com)
+- feat: new CSSDirective design (roeisenb@microsoft.com)
+- chore: configure fast-element for internal stripping (roeisenb@microsoft.com)
+- feat: enable synchronous dom updates for SSR (roeisenb@microsoft.com)
+- refactor: extract polyfill and polyfill-like code to an optional module (roeisenb@microsoft.com)
+- feat: add warn/error message infrastructure (roeisenb@microsoft.com)
+- `View` and `HTMLView` - Type parameters added to enable strongly typed views based on their data source. The constructor of `HTMLView` has a new signature based on changes to the compiler's output. Internals have been cleaned up and no longer rely on the Range type. (roeisenb@microsoft.com)
+- `ElementViewTemplate`, `SyntheticViewTemplate`, and `ViewTemplate` - Added type parameters throughout. Logic to instantiate and apply behaviors moved out of the template and into the view where it can be lazily executed. Removed the ability of the `render` method to take a string id of the node to render to. You must provide a node. (roeisenb@microsoft.com)
+
 ## 1.10.2
 
-Tue, 24 May 2022 07:08:28 GMT
+Tue, 24 May 2022 07:10:02 GMT
 
 ### Patches
 

package/README.md

@@ -26,7 +26,7 @@ import { FASTElement } from '@microsoft/fast-element';
 ```
 
 :::tip
-Looking for a setup that integrates with a particular front-end framework or bundler? Check out [our integration docs](https://fast.design/docs/integrations/introduction).
+Looking for a setup that integrates with a particular front-end framework or bundler? Check out [our integration docs](../integrations/introduction.md).
 :::
 
 ### From CDN
@@ -58,5 +58,5 @@ For simplicity, examples throughout the documentation will assume the library ha
 :::
 
 :::tip
-Looking for a quick guide on building components?  Check out [our Cheat Sheet](https://www.fast.design/docs/resources/cheat-sheet#building-components).
+Looking for a quick guide on building components?  Check out [our Cheat Sheet](../resources/cheat-sheet.md#building-components).
 :::

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

@@ -16,6 +16,8 @@ export interface ValueConverter {
      */
     fromView(value: any): any;
 }
+declare const booleanMode = "boolean";
+declare const reflectMode = "reflect";
 /**
  * The mode that specifies the runtime behavior of the attribute.
  * @remarks
@@ -27,7 +29,7 @@ export interface ValueConverter {
  * changes in the DOM, but does not reflect property changes back.
  * @public
  */
-export declare type AttributeMode = "reflect" | "boolean" | "fromView";
+export declare type AttributeMode = typeof reflectMode | typeof booleanMode | "fromView";
 /**
  * Metadata used to configure a custom attribute's behavior.
  * @public
@@ -135,3 +137,4 @@ export declare function attr(config?: DecoratorAttributeConfiguration): (target:
  * @public
  */
 export declare function attr(target: {}, prop: string): void;
+export {};

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

@@ -8,10 +8,11 @@ import { FASTElementDefinition } from "./fast-definitions.js";
  * Controls the lifecycle and rendering of a `FASTElement`.
  * @public
  */
-export declare class Controller extends PropertyChangeNotifier {
+export declare class Controller<TElement extends HTMLElement = HTMLElement> extends PropertyChangeNotifier {
     private boundObservables;
     private behaviors;
     private needsInitialization;
+    private hasExistingShadowRoot;
     private _template;
     private _styles;
     private _isConnected;
@@ -27,7 +28,7 @@ export declare class Controller extends PropertyChangeNotifier {
     /**
      * The element being controlled by this controller.
      */
-    readonly element: HTMLElement;
+    readonly element: TElement;
     /**
      * The element definition that instructs this controller
      * in how to handle rendering and other platform integrations.
@@ -38,7 +39,7 @@ export declare class Controller extends PropertyChangeNotifier {
      * @remarks
      * If `null` then the element is managing its own rendering.
      */
-    readonly view: ElementView | null;
+    readonly view: ElementView<TElement> | null;
     /**
      * Indicates whether or not the custom element has been
      * connected to the document.
@@ -50,8 +51,8 @@ export declare class Controller extends PropertyChangeNotifier {
      * @remarks
      * This value can only be accurately read after connect but can be set at any time.
      */
-    get template(): ElementViewTemplate | null;
-    set template(value: ElementViewTemplate | null);
+    get template(): ElementViewTemplate<TElement> | null;
+    set template(value: ElementViewTemplate<TElement> | null);
     /**
      * Gets/sets the primary styles used for the component.
      * @remarks
@@ -66,28 +67,28 @@ export declare class Controller extends PropertyChangeNotifier {
      * controller in how to handle rendering and other platform integrations.
      * @internal
      */
-    constructor(element: HTMLElement, definition: FASTElementDefinition);
+    constructor(element: TElement, definition: FASTElementDefinition);
     /**
      * Adds styles to this element. Providing an HTMLStyleElement will attach the element instance to the shadowRoot.
      * @param styles - The styles to add.
      */
-    addStyles(styles: ElementStyles | HTMLStyleElement): void;
+    addStyles(styles: ElementStyles | HTMLStyleElement | null | undefined): void;
     /**
      * Removes styles from this element. Providing an HTMLStyleElement will detach the element instance from the shadowRoot.
      * @param styles - the styles to remove.
      */
-    removeStyles(styles: ElementStyles | HTMLStyleElement): void;
+    removeStyles(styles: ElementStyles | HTMLStyleElement | null | undefined): void;
     /**
      * Adds behaviors to this element.
      * @param behaviors - The behaviors to add.
      */
-    addBehaviors(behaviors: ReadonlyArray<Behavior>): void;
+    addBehaviors(behaviors: ReadonlyArray<Behavior<TElement>>): void;
     /**
      * Removes behaviors from this element.
      * @param behaviors - The behaviors to remove.
      * @param force - Forces unbinding of behaviors.
      */
-    removeBehaviors(behaviors: ReadonlyArray<Behavior>, force?: boolean): void;
+    removeBehaviors(behaviors: ReadonlyArray<Behavior<TElement>>, force?: boolean): void;
     /**
      * Runs connected lifecycle behavior on the associated element.
      */
@@ -102,7 +103,7 @@ export declare class Controller extends PropertyChangeNotifier {
      * @param oldValue - The previous value of the attribute.
      * @param newValue - The new value of the attribute.
      */
-    onAttributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+    onAttributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     /**
      * Emits a custom HTML event.
      * @param type - The type name of the event.