@microsoft/fast-element 2.0.0-beta.1 → 2.0.0-beta.10

package/CHANGELOG.json

@@ -1,6 +1,339 @@
 {
   "name": "@microsoft/fast-element",
   "entries": [
+    {
+      "date": "Mon, 03 Oct 2022 23:44:38 GMT",
+      "tag": "@microsoft/fast-element_v2.0.0-beta.10",
+      "version": "2.0.0-beta.10",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "d29444567d824eb92f4e91e9e173319aef30cfb5",
+            "comment": "fix: observation kernel missing binding observer disconnect method"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "9d620288eb30d963aa7ac08b4d771d79ea6eef7b",
+            "comment": "feat: less surprising class bindings w/ more flexibility for developers"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "a378bfa01843a8a042f3ae37aad6c8fd14fdbcc6",
+            "comment": "fix: don't allow registering FASTElement itself as a web component"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Wed, 28 Sep 2022 20:45:51 GMT",
+      "tag": "@microsoft/fast-element_v2.0.0-beta.9",
+      "version": "2.0.0-beta.9",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "08fab33015853b7f820fdfdac2aecddfeb31843f",
+            "comment": "fix: ensure composed templates receive the existing execution context"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Tue, 27 Sep 2022 22:31:52 GMT",
+      "tag": "@microsoft/fast-element_v2.0.0-beta.8",
+      "version": "2.0.0-beta.8",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "8834c6732c727d39f92f72b197388453a9c17f9b",
+            "comment": "fix: correct view state when processing unbindables during rebind"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "d949a8873621f409f9d9f3453cdb40b593d14b67",
+            "comment": "fix: do not crash when null/undefined is provided literally in templates"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Fri, 23 Sep 2022 22:53:27 GMT",
+      "tag": "@microsoft/fast-element_v2.0.0-beta.7",
+      "version": "2.0.0-beta.7",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "1646b26450a08a77c8bd6302560fe12cc6989ae1",
+            "comment": "feat: improve parent typing and fix repeat context type bug"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "0d786392a38e1d83e56fb1e2112a3e571d193c11",
+            "comment": "feat: prepare fast-element for scoped element registries"
+          },
+          {
+            "author": "wendywendy@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "a42ff75a9130a5ce13006c272c2e2bbbaffdbb41",
+            "comment": "persist totalAvailableViews to compare against removeIndex"
+          },
+          {
+            "author": "863023+radium-v@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "ec2b158dcf39c8b4152b22c3b65963046b473e17",
+            "comment": "make ElementsFilter type arguments optional"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "1039218eafa9a8dbea9da94e1c7803de48d1484c",
+            "comment": "fix(fast-element): attributes properly located in inheritance hierarchy"
+          },
+          {
+            "author": "nicholasrice@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "c1909e9899d517f9483b24043d49a8b193af3c26",
+            "comment": "Adds PendingTask community protocol"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "2edd63a8abe24c68cfc7c76d773c912c6f2d6543",
+            "comment": "feat: new behavior and context API design"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "eb62934b258334c7f92ab3a1112ea62b3901cdac",
+            "comment": "feat: implement getAsync code path for dependency injection"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Thu, 01 Sep 2022 21:53:34 GMT",
+      "tag": "@microsoft/fast-element_v2.0.0-beta.6",
+      "version": "2.0.0-beta.6",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "da9ebbe1b7471cd4e6f7b74f2f9bf02fcc54da4f",
+            "comment": "feat: add new state, ownedState, and computedState APIs"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Thu, 18 Aug 2022 20:46:10 GMT",
+      "tag": "@microsoft/fast-element_v2.0.0-beta.5",
+      "version": "2.0.0-beta.5",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "nicholasrice@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "218cfc014f5c76464493725f83bd883e8b07defa",
+            "comment": "Fix ExpressionObserer bug where watcher was not reset if the binding threw"
+          },
+          {
+            "author": "prudepixie@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "fdd4514664691021a5673934c95acf31a8e73416",
+            "comment": "make insertbefore noop in view"
+          },
+          {
+            "author": "prudepixie@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "eb8d5a59f645b85567adadac41a3bfa66001f941",
+            "comment": "make sure default options for recycle gets set in different scenarios"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "ac3954c97acd3bd549a27829593855c431a24027",
+            "comment": "refactor: remove dependency of DI on FASTElement"
+          },
+          {
+            "author": "32497422+KingOfTac@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "29308db7920baaaac5b31b206d551669e165bc06",
+            "comment": "add subpath export for package.json to packages"
+          },
+          {
+            "author": "prudepixie@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "775d51602cba544347ec1e57fdb4fea248d1b1b5",
+            "comment": "change default array strategy to merge strategy, update repeat directive"
+          },
+          {
+            "author": "nicholasrice@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "aeac1198f427c33f789a2d869f58549ea5bfea57",
+            "comment": "assert FASTElement's type so that instanceof behavior is consistent with other class implementations"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Mon, 18 Jul 2022 21:10:01 GMT",
+      "tag": "@microsoft/fast-element_v2.0.0-beta.4",
+      "version": "2.0.0-beta.4",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "f9fb9c88902bd81233fb927a7357d4bca7634f29",
+            "comment": "feat: extract all error messages from context and DI"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "27dc848327b25328e428f67505684d2171b58711",
+            "comment": "feat: introduce new binding API"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "7f4d6b5587f6eff52e5b7f414e27543bb4d7772d",
+            "comment": "Enabled DOM Container fallback functions when a container cannot be located."
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "0f57d55822bbf97ab69f90efc0a0d100b27e10eb",
+            "comment": "feat: add render directive, renderWith decorator, and RenderInstruction"
+          },
+          {
+            "author": "prudepixie@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "94e6b0a0e7e1fd1167bd6453c3f7b27efdc91804",
+            "comment": "only store removed views if it can't be reused right away"
+          },
+          {
+            "author": "32497422+KingOfTac@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "11d5b4075118456b2e7c2a4f32a415eeea94ed7f",
+            "comment": "fix: enable createElementTemplate to have undefined attributes"
+          },
+          {
+            "author": "prudepixie@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "31296ea2be3981d25f5feb773b2895dbedfaf2c2",
+            "comment": "use index to track reusable views"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "4567188a47598b3d2589b05f039bea695f2b8875",
+            "comment": "feat: enable render, repeat, and when template helpers to handle static data in addition to the already supported dynamic bindings"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "f164aa75e62ed71c9386902051c021f1fdfba364",
+            "comment": "fix: FASTElementDefinition#isDefined should be true only after define"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "aacfde6d1f52a20af5511c5e792f730bd091d452",
+            "comment": "feat: move testing and dependency injection to fast-element"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "04c51a17dde6d03dc2e2a4de3666cbbec950d900",
+            "comment": "fix: warn when host bindings are accidentally applied on non CE views"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "b32eb1004960da95b74dba7f111ee859b6655896",
+            "comment": "feat: perf and safety improvements to fast element definition"
+          }
+        ]
+      }
+    },
+    {
+      "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",

package/CHANGELOG.md

@@ -1,9 +1,114 @@
 # Change Log - @microsoft/fast-element
 
-This log was last generated on Wed, 01 Jun 2022 17:53:14 GMT and should not be manually modified.
+This log was last generated on Mon, 03 Oct 2022 23:44:38 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## 2.0.0-beta.10
+
+Mon, 03 Oct 2022 23:44:38 GMT
+
+### Changes
+
+- fix: observation kernel missing binding observer disconnect method (roeisenb@microsoft.com)
+- feat: less surprising class bindings w/ more flexibility for developers (roeisenb@microsoft.com)
+- fix: don't allow registering FASTElement itself as a web component (roeisenb@microsoft.com)
+
+## 2.0.0-beta.9
+
+Wed, 28 Sep 2022 20:45:51 GMT
+
+### Changes
+
+- fix: ensure composed templates receive the existing execution context (roeisenb@microsoft.com)
+
+## 2.0.0-beta.8
+
+Tue, 27 Sep 2022 22:31:52 GMT
+
+### Changes
+
+- fix: correct view state when processing unbindables during rebind (roeisenb@microsoft.com)
+- fix: do not crash when null/undefined is provided literally in templates (roeisenb@microsoft.com)
+
+## 2.0.0-beta.7
+
+Fri, 23 Sep 2022 22:53:27 GMT
+
+### Changes
+
+- feat: improve parent typing and fix repeat context type bug (roeisenb@microsoft.com)
+- feat: prepare fast-element for scoped element registries (roeisenb@microsoft.com)
+- persist totalAvailableViews to compare against removeIndex (wendywendy@microsoft.com)
+- make ElementsFilter type arguments optional (863023+radium-v@users.noreply.github.com)
+- fix(fast-element): attributes properly located in inheritance hierarchy (roeisenb@microsoft.com)
+- Adds PendingTask community protocol (nicholasrice@users.noreply.github.com)
+- feat: new behavior and context API design (roeisenb@microsoft.com)
+- feat: implement getAsync code path for dependency injection (roeisenb@microsoft.com)
+
+## 2.0.0-beta.6
+
+Thu, 01 Sep 2022 21:53:34 GMT
+
+### Changes
+
+- feat: add new state, ownedState, and computedState APIs (roeisenb@microsoft.com)
+
+## 2.0.0-beta.5
+
+Thu, 18 Aug 2022 20:46:10 GMT
+
+### Changes
+
+- Fix ExpressionObserer bug where watcher was not reset if the binding threw (nicholasrice@users.noreply.github.com)
+- make insertbefore noop in view (prudepixie@users.noreply.github.com)
+- make sure default options for recycle gets set in different scenarios (prudepixie@users.noreply.github.com)
+- refactor: remove dependency of DI on FASTElement (roeisenb@microsoft.com)
+- add subpath export for package.json to packages (32497422+KingOfTac@users.noreply.github.com)
+- change default array strategy to merge strategy, update repeat directive (prudepixie@users.noreply.github.com)
+- assert FASTElement's type so that instanceof behavior is consistent with other class implementations (nicholasrice@users.noreply.github.com)
+
+## 2.0.0-beta.4
+
+Mon, 18 Jul 2022 21:10:01 GMT
+
+### Changes
+
+- feat: extract all error messages from context and DI (roeisenb@microsoft.com)
+- feat: introduce new binding API (roeisenb@microsoft.com)
+- Enabled DOM Container fallback functions when a container cannot be located. (roeisenb@microsoft.com)
+- feat: add render directive, renderWith decorator, and RenderInstruction (roeisenb@microsoft.com)
+- only store removed views if it can't be reused right away (prudepixie@users.noreply.github.com)
+- fix: enable createElementTemplate to have undefined attributes (32497422+KingOfTac@users.noreply.github.com)
+- use index to track reusable views (prudepixie@users.noreply.github.com)
+- feat: enable render, repeat, and when template helpers to handle static data in addition to the already supported dynamic bindings (roeisenb@microsoft.com)
+- fix: FASTElementDefinition#isDefined should be true only after define (roeisenb@microsoft.com)
+- feat: move testing and dependency injection to fast-element (roeisenb@microsoft.com)
+- fix: warn when host bindings are accidentally applied on non CE views (roeisenb@microsoft.com)
+- feat: perf and safety improvements to fast element definition (roeisenb@microsoft.com)
+
+## 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

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

@@ -40,6 +40,16 @@ export declare type AttributeConfiguration = {
     mode?: AttributeMode;
     converter?: ValueConverter;
 };
+/**
+ * Metadata used to configure a custom attribute's behavior.
+ * @public
+ */
+export declare const AttributeConfiguration: Readonly<{
+    /**
+     * Locates all attribute configurations associated with a type.
+     */
+    locate: (target: {}) => AttributeConfiguration[];
+}>;
 /**
  * Metadata used to configure a custom attribute's behavior through a decorator.
  * @public

package/dist/dts/components/{controller.d.ts → element-controller.d.ts}

@@ -1,21 +1,21 @@
-import type { Behavior } from "../observation/behavior.js";
+import type { HostBehavior, HostController } from "../styles/host.js";
 import { PropertyChangeNotifier } from "../observation/notifier.js";
-import type { ElementStyles } from "../styles/element-styles.js";
 import type { ElementViewTemplate } from "../templating/template.js";
 import type { ElementView } from "../templating/view.js";
+import type { ElementStyles } from "../styles/element-styles.js";
 import { FASTElementDefinition } from "./fast-definitions.js";
 /**
  * Controls the lifecycle and rendering of a `FASTElement`.
  * @public
  */
-export declare class Controller<TElement extends HTMLElement = HTMLElement> extends PropertyChangeNotifier {
+export declare class ElementController<TElement extends HTMLElement = HTMLElement> extends PropertyChangeNotifier implements HostController<TElement> {
     private boundObservables;
-    private behaviors;
     private needsInitialization;
     private hasExistingShadowRoot;
     private _template;
-    private _styles;
     private _isConnected;
+    private behaviors;
+    private _mainStyles;
     /**
      * This allows Observable.getNotifier(...) to return the Controller
      * when the notifier for the Controller itself is being requested. The
@@ -28,7 +28,7 @@ export declare class Controller<TElement extends HTMLElement = HTMLElement> exte
     /**
      * The element being controlled by this controller.
      */
-    readonly element: TElement;
+    readonly source: TElement;
     /**
      * The element definition that instructs this controller
      * in how to handle rendering and other platform integrations.
@@ -54,12 +54,11 @@ export declare class Controller<TElement extends HTMLElement = HTMLElement> exte
     get template(): ElementViewTemplate<TElement> | null;
     set template(value: ElementViewTemplate<TElement> | null);
     /**
-     * Gets/sets the primary styles used for the component.
-     * @remarks
-     * This value can only be accurately read after connect but can be set at any time.
+     * The main set of styles used for the component, independent
+     * of any dynamically added styles.
      */
-    get styles(): ElementStyles | null;
-    set styles(value: ElementStyles | null);
+    get mainStyles(): ElementStyles | null;
+    set mainStyles(value: ElementStyles | null);
     /**
      * Creates a Controller to control the specified element.
      * @param element - The element to be controlled by this controller.
@@ -68,6 +67,17 @@ export declare class Controller<TElement extends HTMLElement = HTMLElement> exte
      * @internal
      */
     constructor(element: TElement, definition: FASTElementDefinition);
+    /**
+     * Adds the behavior to the component.
+     * @param behavior - The behavior to add.
+     */
+    addBehavior(behavior: HostBehavior<TElement>): void;
+    /**
+     * Removes the behavior from the component.
+     * @param behavior - The behavior to remove.
+     * @param force - Forces removal even if this behavior was added more than once.
+     */
+    removeBehavior(behavior: HostBehavior<TElement>, force?: boolean): void;
     /**
      * Adds styles to this element. Providing an HTMLStyleElement will attach the element instance to the shadowRoot.
      * @param styles - The styles to add.
@@ -78,25 +88,14 @@ export declare class Controller<TElement extends HTMLElement = HTMLElement> exte
      * @param styles - the styles to remove.
      */
     removeStyles(styles: ElementStyles | HTMLStyleElement | null | undefined): void;
-    /**
-     * Adds behaviors to this element.
-     * @param behaviors - The behaviors to add.
-     */
-    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<TElement>>, force?: boolean): void;
     /**
      * Runs connected lifecycle behavior on the associated element.
      */
-    onConnectedCallback(): void;
+    connect(): void;
     /**
      * Runs disconnected lifecycle behavior on the associated element.
      */
-    onDisconnectedCallback(): void;
+    disconnect(): void;
     /**
      * Runs the attribute changed callback for the associated element.
      * @param name - The name of the attribute that changed.
@@ -123,5 +122,5 @@ export declare class Controller<TElement extends HTMLElement = HTMLElement> exte
      * registered either through the use of the {@link customElement}
      * decorator or a call to `FASTElement.define`.
      */
-    static forCustomElement(element: HTMLElement): Controller;
+    static forCustomElement(element: HTMLElement): ElementController;
 }

package/dist/dts/components/fast-definitions.d.ts

@@ -2,6 +2,18 @@ import { Constructable } from "../interfaces.js";
 import { ComposableStyles, ElementStyles } from "../styles/element-styles.js";
 import type { ElementViewTemplate } from "../templating/template.js";
 import { AttributeConfiguration, AttributeDefinition } from "./attributes.js";
+/**
+ * Shadow root initialization options.
+ * @public
+ */
+export interface ShadowRootOptions extends ShadowRootInit {
+    /**
+     * A registry that provides the custom elements visible
+     * from within this shadow root.
+     * @beta
+     */
+    registry?: CustomElementRegistry;
+}
 /**
  * Represents metadata configuration for a custom element.
  * @public
@@ -25,19 +37,28 @@ export interface PartialFASTElementDefinition {
     readonly attributes?: (AttributeConfiguration | string)[];
     /**
      * Options controlling the creation of the custom element's shadow DOM.
+     * @remarks
+     * If not provided, defaults to an open shadow root. Provide null
+     * to render to the associated template to the light DOM instead.
      */
-    readonly shadowOptions?: Partial<ShadowRootInit> | null;
+    readonly shadowOptions?: Partial<ShadowRootOptions> | null;
     /**
      * Options controlling how the custom element is defined with the platform.
      */
     readonly elementOptions?: ElementDefinitionOptions;
+    /**
+     * The registry to register this component in by default.
+     * @remarks
+     * If not provided, defaults to the global registry.
+     */
+    readonly registry?: CustomElementRegistry;
 }
 /**
  * Defines metadata for a FASTElement.
  * @public
  */
 export declare class FASTElementDefinition<TType extends Constructable<HTMLElement> = Constructable<HTMLElement>> {
-    private observedAttributes;
+    private platformDefined;
     /**
      * The type this element definition describes.
      */
@@ -73,23 +94,36 @@ export declare class FASTElementDefinition<TType extends Constructable<HTMLEleme
     /**
      * Options controlling the creation of the custom element's shadow DOM.
      */
-    readonly shadowOptions?: ShadowRootInit;
+    readonly shadowOptions?: ShadowRootOptions;
     /**
      * Options controlling how the custom element is defined with the platform.
      */
-    readonly elementOptions?: ElementDefinitionOptions;
+    readonly elementOptions: ElementDefinitionOptions;
     /**
-     * Creates an instance of FASTElementDefinition.
-     * @param type - The type this definition is being created for.
-     * @param nameOrConfig - The name of the element to define or a config object
-     * that describes the element to define.
+     * The registry to register this component in by default.
      */
-    constructor(type: TType, nameOrConfig?: PartialFASTElementDefinition | string);
+    readonly registry: CustomElementRegistry;
+    private constructor();
     /**
      * Defines a custom element based on this definition.
      * @param registry - The element registry to define the element in.
+     * @remarks
+     * This operation is idempotent per registry.
      */
     define(registry?: CustomElementRegistry): this;
+    /**
+     * Creates an instance of FASTElementDefinition.
+     * @param type - The type this definition is being created for.
+     * @param nameOrDef - The name of the element to define or a config object
+     * that describes the element to define.
+     */
+    static compose<TType extends Constructable<HTMLElement> = Constructable<HTMLElement>>(type: TType, nameOrDef?: string | PartialFASTElementDefinition): FASTElementDefinition<TType>;
+    /**
+     * Registers a FASTElement base type.
+     * @param type - The type to register as a base type.
+     * @internal
+     */
+    static registerBaseType(type: Function): void;
     /**
      * Gets the element definition associated with the specified type.
      * @param type - The custom element type to retrieve the definition for.