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

package/CHANGELOG.md

@@ -1,16 +1,163 @@
 # Change Log - @microsoft/fast-element
 
-This log was last generated on Wed, 17 Aug 2022 16:39:46 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 -->
 
-## 1.10.5
+## 2.0.0-beta.10
 
-Wed, 17 Aug 2022 16:39:46 GMT
+Mon, 03 Oct 2022 23:44:38 GMT
 
-### Patches
+### 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
 
-- default options in repeat should be set in various scenarios (prudepixie@users.noreply.github.com)
+### 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
+
+### 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
 

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
@@ -38,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
@@ -135,3 +147,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 → element-controller.d.ts}

@@ -1,20 +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 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
@@ -27,7 +28,7 @@ export declare class Controller extends PropertyChangeNotifier {
     /**
      * The element being controlled by this controller.
      */
-    readonly element: HTMLElement;
+    readonly source: 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,15 +51,14 @@ 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
-     * 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.
@@ -66,43 +66,43 @@ 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.
+     * Adds the behavior to the component.
+     * @param behavior - The behavior to add.
      */
-    addStyles(styles: ElementStyles | HTMLStyleElement): void;
+    addBehavior(behavior: HostBehavior<TElement>): void;
     /**
-     * Removes styles from this element. Providing an HTMLStyleElement will detach the element instance from the shadowRoot.
-     * @param styles - the styles to remove.
+     * 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.
      */
-    removeStyles(styles: ElementStyles | HTMLStyleElement): void;
+    removeBehavior(behavior: HostBehavior<TElement>, force?: boolean): void;
     /**
-     * Adds behaviors to this element.
-     * @param behaviors - The behaviors to add.
+     * Adds styles to this element. Providing an HTMLStyleElement will attach the element instance to the shadowRoot.
+     * @param styles - The styles to add.
      */
-    addBehaviors(behaviors: ReadonlyArray<Behavior>): void;
+    addStyles(styles: ElementStyles | HTMLStyleElement | null | undefined): void;
     /**
-     * Removes behaviors from this element.
-     * @param behaviors - The behaviors to remove.
-     * @param force - Forces unbinding of behaviors.
+     * Removes styles from this element. Providing an HTMLStyleElement will detach the element instance from the shadowRoot.
+     * @param styles - the styles to remove.
      */
-    removeBehaviors(behaviors: ReadonlyArray<Behavior>, force?: boolean): void;
+    removeStyles(styles: ElementStyles | HTMLStyleElement | null | undefined): 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.
      * @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.
@@ -122,5 +122,5 @@ export declare class Controller extends PropertyChangeNotifier {
      * 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

@@ -1,6 +1,19 @@
+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
@@ -24,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 Function = Function> {
-    private observedAttributes;
+export declare class FASTElementDefinition<TType extends Constructable<HTMLElement> = Constructable<HTMLElement>> {
+    private platformDefined;
     /**
      * The type this element definition describes.
      */
@@ -72,26 +94,44 @@ export declare class FASTElementDefinition<TType extends Function = Function> {
     /**
      * 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.
      */
-    static readonly forType: <TType_1 extends Function>(key: TType_1) => FASTElementDefinition<Function> | undefined;
+    static readonly getByType: (key: Function) => FASTElementDefinition<Constructable<HTMLElement>> | undefined;
+    /**
+     * Gets the element definition associated with the instance.
+     * @param instance - The custom element instance to retrieve the definition for.
+     */
+    static readonly getForInstance: (object: any) => FASTElementDefinition<Constructable<HTMLElement>> | undefined;
 }

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

@@ -1,15 +1,16 @@
-import { Controller } from "./controller.js";
-import { PartialFASTElementDefinition } from "./fast-definitions.js";
+import { Constructable } from "../interfaces.js";
+import { ElementController } from "./element-controller.js";
+import { FASTElementDefinition, PartialFASTElementDefinition } from "./fast-definitions.js";
 /**
  * Represents a custom element based on the FASTElement infrastructure.
  * @public
  */
-export interface FASTElement {
+export interface FASTElement extends HTMLElement {
     /**
      * The underlying controller that handles the lifecycle and rendering of
      * this FASTElement.
      */
-    readonly $fastController: Controller;
+    readonly $fastController: ElementController;
     /**
      * Emits a custom HTML event.
      * @param type - The type name of the event.
@@ -42,30 +43,23 @@ export interface FASTElement {
      * This method is invoked by the platform whenever an observed
      * attribute of FASTElement has a value change.
      */
-    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
 }
+declare function compose<TType extends Constructable<HTMLElement> = Constructable<HTMLElement>>(this: TType, nameOrDef: string | PartialFASTElementDefinition): FASTElementDefinition<TType>;
+declare function compose<TType extends Constructable<HTMLElement> = Constructable<HTMLElement>>(type: TType, nameOrDef?: string | PartialFASTElementDefinition): FASTElementDefinition<TType>;
+declare function define<TType extends Constructable<HTMLElement> = Constructable<HTMLElement>>(this: TType, nameOrDef: string | PartialFASTElementDefinition): TType;
+declare function define<TType extends Constructable<HTMLElement> = Constructable<HTMLElement>>(type: TType, nameOrDef?: string | PartialFASTElementDefinition): TType;
+declare function from<TBase extends typeof HTMLElement>(BaseType: TBase): new () => InstanceType<TBase> & FASTElement;
 /**
  * A minimal base class for FASTElements that also provides
  * static helpers for working with FASTElements.
  * @public
  */
-export declare const FASTElement: (new () => HTMLElement & FASTElement) & {
-    /**
-     * Creates a new FASTElement base class inherited from the
-     * provided base type.
-     * @param BaseType - The base element type to inherit from.
-     */
-    from<TBase extends {
-        new (): HTMLElement;
-        prototype: HTMLElement;
-    }>(BaseType: TBase): new () => InstanceType<TBase> & FASTElement;
-    /**
-     * Defines a platform custom element based on the provided type and definition.
-     * @param type - The custom element type to define.
-     * @param nameOrDef - The name of the element to define or a definition object
-     * that describes the element to define.
-     */
-    define<TType extends Function>(type: TType, nameOrDef?: string | PartialFASTElementDefinition | undefined): TType;
+export declare const FASTElement: {
+    new (): FASTElement;
+    define: typeof define;
+    compose: typeof compose;
+    from: typeof from;
 };
 /**
  * Decorator: Defines a platform custom element based on `FASTElement`.
@@ -73,4 +67,5 @@ export declare const FASTElement: (new () => HTMLElement & FASTElement) & {
  * that describes the element to define.
  * @public
  */
-export declare function customElement(nameOrDef: string | PartialFASTElementDefinition): (type: Function) => void;
+export declare function customElement(nameOrDef: string | PartialFASTElementDefinition): (type: Constructable<HTMLElement>) => void;
+export {};