@microsoft/fast-element 2.0.0-beta.6 → 2.0.0-beta.7

package/dist/fast-element.d.ts

@@ -24,7 +24,7 @@ export declare interface Accessor {
  * Used to add behaviors when constructing styles.
  * @public
  */
-export declare type AddBehavior = (behavior: Behavior<HTMLElement>) => void;
+export declare type AddBehavior = (behavior: HostBehavior<HTMLElement>) => void;
 
 /**
  * Used to add behavior factories when constructing templates.
@@ -176,6 +176,17 @@ export declare type AttributeConfiguration = {
     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[];
+}>;
+
 /**
  * An implementation of {@link Accessor} that supports reactivity,
  * change callbacks, attribute reflection, and type conversion for
@@ -247,25 +258,6 @@ export declare class AttributeDefinition implements Accessor {
  */
 export declare type AttributeMode = typeof reflectMode | typeof booleanMode | "fromView";
 
-/**
- * Represents an object that can contribute behavior to a view or
- * element's bind/unbind operations.
- * @public
- */
-export declare interface Behavior<TSource = any, TParent = any> {
-    /**
-     * Bind this behavior to the source.
-     * @param source - The source to bind to.
-     * @param context - The execution context that the binding is operating within.
-     */
-    bind(source: TSource, context: ExecutionContext<TParent>): void;
-    /**
-     * Unbinds this behavior from the source.
-     * @param source - The source to unbind from.
-     */
-    unbind(source: TSource, context: ExecutionContext<TParent>): void;
-}
-
 /**
  * Creates an standard binding.
  * @param binding - The binding to refresh when changed.
@@ -281,18 +273,18 @@ export declare function bind<T = any>(binding: Expression<T>, isVolatile?: boole
  * @public
  */
 export declare abstract class Binding<TSource = any, TReturn = any, TParent = any> {
+    evaluate: Expression<TSource, TReturn, TParent>;
+    isVolatile: boolean;
     /**
      * Options associated with the binding.
      */
     options?: any;
     /**
-     * Whether or not the binding is volatile.
-     */
-    isVolatile?: boolean;
-    /**
-     * Evaluates the binding expression.
+     * Creates a binding.
+     * @param evaluate - Evaluates the binding.
+     * @param isVolatile - Indicates whether the binding is volatile.
      */
-    evaluate: Expression<TSource, TReturn, TParent>;
+    constructor(evaluate: Expression<TSource, TReturn, TParent>, isVolatile?: boolean);
     /**
      * Creates an observer capable of notifying a subscriber when the output of a binding changes.
      * @param directive - The HTML Directive to create the observer for.
@@ -301,48 +293,6 @@ export declare abstract class Binding<TSource = any, TReturn = any, TParent = an
     abstract createObserver(directive: HTMLDirective, subscriber: Subscriber): ExpressionObserver<TSource, TReturn, TParent>;
 }
 
-/**
- * A binding behavior for bindings that change.
- * @public
- */
-export declare class BindingBehavior implements ViewBehavior {
-    readonly directive: HTMLBindingDirective;
-    protected updateTarget: UpdateTarget;
-    private observerProperty;
-    /**
-     * Creates an instance of ChangeBinding.
-     * @param directive - The directive that has the configuration for this behavior.
-     * @param updateTarget - The function used to update the target with the latest value.
-     */
-    constructor(directive: HTMLBindingDirective, updateTarget: UpdateTarget);
-    /**
-     * Bind this behavior to the source.
-     * @param source - The source to bind to.
-     * @param context - The execution context that the binding is operating within.
-     * @param targets - The targets that behaviors in a view can attach to.
-     */
-    bind(source: any, context: ExecutionContext, targets: ViewBehaviorTargets): void;
-    /**
-     * Unbinds this behavior from the source.
-     * @param source - The source to unbind from.
-     * @param context - The execution context that the binding is operating within.
-     * @param targets - The targets that behaviors in a view can attach to.
-     */
-    unbind(source: any, context: ExecutionContext, targets: ViewBehaviorTargets): void;
-    /* Excluded from this release type: handleChange */
-    /**
-     * Returns the binding observer used to update the node.
-     * @param target - The target node.
-     * @returns A BindingObserver.
-     */
-    protected getObserver(target: Node): ExpressionObserver;
-    /**
-     * Creates a behavior.
-     * @param targets - The targets available for behaviors to be attached to.
-     */
-    createBehavior(targets: ViewBehaviorTargets): ViewBehavior;
-}
-
 /**
  * A {@link ValueConverter} that converts to and from `boolean` values.
  * @remarks
@@ -366,7 +316,7 @@ export declare type Callable = typeof Function.prototype.call | {
  * into templates.
  * @public
  */
-export declare interface CaptureType<TSource> {
+export declare interface CaptureType<TSource, TParent> {
 }
 
 /**
@@ -382,7 +332,7 @@ export declare interface ChildListDirectiveOptions<T = any> extends NodeBehavior
  * @param propertyOrOptions - The options used to configure child node observation.
  * @public
  */
-export declare function children<T = any>(propertyOrOptions: (keyof T & string) | ChildrenDirectiveOptions<keyof T & string>): CaptureType<T>;
+export declare function children<TSource = any, TParent = any>(propertyOrOptions: (keyof TSource & string) | ChildrenDirectiveOptions<keyof TSource & string>): CaptureType<TSource, TParent>;
 
 /**
  * The runtime behavior for child node observation.
@@ -505,20 +455,6 @@ export declare type ConstructibleStyleStrategy = {
     new (styles: (string | CSSStyleSheet)[]): StyleStrategy;
 };
 
-/**
- * A special binding behavior that can bind node content.
- * @public
- */
-export declare class ContentBehavior extends BindingBehavior {
-    /**
-     * Unbinds this behavior from the source.
-     * @param source - The source to unbind from.
-     * @param context - The execution context that the binding is operating within.
-     * @param targets - The targets that behaviors in a view can attach to.
-     */
-    unbind(source: any, context: ExecutionContext, targets: ViewBehaviorTargets): void;
-}
-
 /**
  * A simple template that can create ContentView instances.
  * @public
@@ -535,12 +471,13 @@ export declare interface ContentTemplate {
  * @public
  */
 export declare interface ContentView {
+    readonly context: ExecutionContext;
     /**
      * Binds a view's behaviors to its binding source.
      * @param source - The binding source for the view's binding behaviors.
      * @param context - The execution context to run the view within.
      */
-    bind(source: any, context: ExecutionContext): void;
+    bind(source: any): void;
     /**
      * Unbinds a view's behaviors from its binding source and context.
      */
@@ -557,120 +494,7 @@ export declare interface ContentView {
     remove(): void;
 }
 
-/**
- * Controls the lifecycle and rendering of a `FASTElement`.
- * @public
- */
-export declare class Controller<TElement extends HTMLElement = HTMLElement> extends PropertyChangeNotifier {
-    private boundObservables;
-    private behaviors;
-    private needsInitialization;
-    private hasExistingShadowRoot;
-    private _template;
-    private _styles;
-    private _isConnected;
-    /**
-     * This allows Observable.getNotifier(...) to return the Controller
-     * when the notifier for the Controller itself is being requested. The
-     * result is that the Observable system does not need to create a separate
-     * instance of Notifier for observables on the Controller. The component and
-     * the controller will now share the same notifier, removing one-object construct
-     * per web component instance.
-     */
-    private readonly $fastController;
-    /**
-     * The element being controlled by this controller.
-     */
-    readonly element: TElement;
-    /**
-     * The element definition that instructs this controller
-     * in how to handle rendering and other platform integrations.
-     */
-    readonly definition: FASTElementDefinition;
-    /**
-     * The view associated with the custom element.
-     * @remarks
-     * If `null` then the element is managing its own rendering.
-     */
-    readonly view: ElementView<TElement> | null;
-    /**
-     * Indicates whether or not the custom element has been
-     * connected to the document.
-     */
-    get isConnected(): boolean;
-    private setIsConnected;
-    /**
-     * Gets/sets the template used to render the component.
-     * @remarks
-     * This value can only be accurately read after connect but can be set at any time.
-     */
-    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.
-     */
-    get styles(): ElementStyles | null;
-    set styles(value: ElementStyles | null);
-    /* Excluded from this release type: __constructor */
-    /**
-     * 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 | 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 | 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;
-    /**
-     * Runs disconnected lifecycle behavior on the associated element.
-     */
-    onDisconnectedCallback(): 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 | null, newValue: string | null): void;
-    /**
-     * Emits a custom HTML event.
-     * @param type - The type name of the event.
-     * @param detail - The event detail object to send with the event.
-     * @param options - The event options. By default bubbles and composed.
-     * @remarks
-     * Only emits events if connected.
-     */
-    emit(type: string, detail?: any, options?: Omit<CustomEventInit, "detail">): void | boolean;
-    private finishInitialization;
-    private renderTemplate;
-    /**
-     * Locates or creates a controller for the specified element.
-     * @param element - The element to return the controller for.
-     * @remarks
-     * The specified element must have a {@link FASTElementDefinition}
-     * registered either through the use of the {@link customElement}
-     * decorator or a call to `FASTElement.define`.
-     */
-    static forCustomElement(element: HTMLElement): Controller;
-}
+/* Excluded from this release type: createMetadataLocator */
 
 /* Excluded from this release type: createTypeRegistry */
 
@@ -832,6 +656,120 @@ export declare const DOM: Readonly<{
     setBooleanAttribute(element: HTMLElement, attributeName: string, value: boolean): void;
 }>;
 
+/**
+ * Controls the lifecycle and rendering of a `FASTElement`.
+ * @public
+ */
+export declare class ElementController<TElement extends HTMLElement = HTMLElement> extends PropertyChangeNotifier implements HostController<TElement> {
+    private boundObservables;
+    private needsInitialization;
+    private hasExistingShadowRoot;
+    private _template;
+    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
+     * result is that the Observable system does not need to create a separate
+     * instance of Notifier for observables on the Controller. The component and
+     * the controller will now share the same notifier, removing one-object construct
+     * per web component instance.
+     */
+    private readonly $fastController;
+    /**
+     * The element being controlled by this controller.
+     */
+    readonly source: TElement;
+    /**
+     * The element definition that instructs this controller
+     * in how to handle rendering and other platform integrations.
+     */
+    readonly definition: FASTElementDefinition;
+    /**
+     * The view associated with the custom element.
+     * @remarks
+     * If `null` then the element is managing its own rendering.
+     */
+    readonly view: ElementView<TElement> | null;
+    /**
+     * Indicates whether or not the custom element has been
+     * connected to the document.
+     */
+    get isConnected(): boolean;
+    private setIsConnected;
+    /**
+     * Gets/sets the template used to render the component.
+     * @remarks
+     * This value can only be accurately read after connect but can be set at any time.
+     */
+    get template(): ElementViewTemplate<TElement> | null;
+    set template(value: ElementViewTemplate<TElement> | null);
+    /**
+     * The main set of styles used for the component, independent
+     * of any dynamically added styles.
+     */
+    get mainStyles(): ElementStyles | null;
+    set mainStyles(value: ElementStyles | null);
+    /* Excluded from this release type: __constructor */
+    /**
+     * 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.
+     */
+    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 | null | undefined): void;
+    /**
+     * Runs connected lifecycle behavior on the associated element.
+     */
+    connect(): void;
+    /**
+     * Runs disconnected lifecycle behavior on the associated element.
+     */
+    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 | null, newValue: string | null): void;
+    /**
+     * Emits a custom HTML event.
+     * @param type - The type name of the event.
+     * @param detail - The event detail object to send with the event.
+     * @param options - The event options. By default bubbles and composed.
+     * @remarks
+     * Only emits events if connected.
+     */
+    emit(type: string, detail?: any, options?: Omit<CustomEventInit, "detail">): void | boolean;
+    private finishInitialization;
+    private renderTemplate;
+    /**
+     * Locates or creates a controller for the specified element.
+     * @param element - The element to return the controller for.
+     * @remarks
+     * The specified element must have a {@link FASTElementDefinition}
+     * registered either through the use of the {@link customElement}
+     * decorator or a call to `FASTElement.define`.
+     */
+    static forCustomElement(element: HTMLElement): ElementController;
+}
+
 /**
  * Creates a function that can be used to filter a Node array, selecting only elements.
  * @param selector - An optional selector to restrict the filter to.
@@ -844,7 +782,7 @@ export declare const elements: (selector?: string) => ElementsFilter;
  *
  * @public
  */
-export declare type ElementsFilter = (value: Node, index: number, array: Node[]) => boolean;
+export declare type ElementsFilter = (value: Node, index?: number, array?: Node[]) => boolean;
 
 /**
  * Represents styles that can be applied to a custom element.
@@ -857,7 +795,7 @@ export declare class ElementStyles {
     /**
      * The behaviors associated with this set of styles.
      */
-    readonly behaviors: ReadonlyArray<Behavior<HTMLElement>> | null;
+    readonly behaviors: ReadonlyArray<HostBehavior<HTMLElement>> | null;
     /**
      * Gets the StyleStrategy associated with these element styles.
      */
@@ -874,7 +812,7 @@ export declare class ElementStyles {
      * Associates behaviors with this set of styles.
      * @param behaviors - The behaviors to associate.
      */
-    withBehaviors(...behaviors: Behavior<HTMLElement>[]): this;
+    withBehaviors(...behaviors: HostBehavior<HTMLElement>[]): this;
     /**
      * Sets the strategy that handles adding/removing these styles for an element.
      * @param strategy - The strategy to use.
@@ -912,76 +850,37 @@ export declare interface ElementView<TSource = any, TParent = any> extends View<
 /**
  * A template capable of creating views specifically for rendering custom elements.
  * @public
- */
-export declare interface ElementViewTemplate<TSource = any, TParent = any> {
-    /**
-     * Creates an ElementView instance based on this template definition.
-     * @param hostBindingTarget - The element that host behaviors will be bound to.
-     */
-    create(hostBindingTarget: Element): ElementView<TSource, TParent>;
-    /**
-     * Creates an HTMLView from this template, binds it to the source, and then appends it to the host.
-     * @param source - The data source to bind the template to.
-     * @param host - The Element where the template will be rendered.
-     * @param hostBindingTarget - An HTML element to target the host bindings at if different from the
-     * host that the template is being attached to.
-     */
-    render(source: TSource, host: Node, hostBindingTarget?: Element): ElementView<TSource, TParent>;
-}
-
-/**
- * A readonly, empty array.
- * @remarks
- * Typically returned by APIs that return arrays when there are
- * no actual items to return.
- * @public
- */
-export declare const emptyArray: readonly never[];
-
-/**
- * A binding behavior for handling events.
- * @public
- */
-export declare class EventBehavior {
-    readonly directive: HTMLBindingDirective;
-    private contextProperty;
-    private sourceProperty;
-    /**
-     * Creates an instance of EventBinding.
-     * @param directive - The directive that has the configuration for this behavior.
-     */
-    constructor(directive: HTMLBindingDirective);
-    /**
-     * Bind this behavior to the source.
-     * @param source - The source to bind to.
-     * @param context - The execution context that the binding is operating within.
-     * @param targets - The targets that behaviors in a view can attach to.
-     */
-    bind(source: any, context: ExecutionContext, targets: ViewBehaviorTargets): void;
-    /**
-     * Unbinds this behavior from the source.
-     * @param source - The source to unbind from.
-     * @param context - The execution context that the binding is operating within.
-     * @param targets - The targets that behaviors in a view can attach to.
+ */
+export declare interface ElementViewTemplate<TSource = any, TParent = any> {
+    /**
+     * Creates an ElementView instance based on this template definition.
+     * @param hostBindingTarget - The element that host behaviors will be bound to.
      */
-    unbind(source: any, context: ExecutionContext, targets: ViewBehaviorTargets): void;
+    create(hostBindingTarget: Element): ElementView<TSource, TParent>;
     /**
-     * Creates a behavior.
-     * @param targets - The targets available for behaviors to be attached to.
+     * Creates an HTMLView from this template, binds it to the source, and then appends it to the host.
+     * @param source - The data source to bind the template to.
+     * @param host - The Element where the template will be rendered.
+     * @param hostBindingTarget - An HTML element to target the host bindings at if different from the
+     * host that the template is being attached to.
      */
-    createBehavior(targets: ViewBehaviorTargets): ViewBehavior;
-    /* Excluded from this release type: handleEvent */
+    render(source: TSource, host: Node, hostBindingTarget?: Element): ElementView<TSource, TParent>;
 }
 
+/**
+ * A readonly, empty array.
+ * @remarks
+ * Typically returned by APIs that return arrays when there are
+ * no actual items to return.
+ * @public
+ */
+export declare const emptyArray: readonly never[];
+
 /**
  * Provides additional contextual information available to behaviors and expressions.
  * @public
  */
-export declare class ExecutionContext<TParentSource = any> {
-    /**
-     * The default execution context.
-     */
-    static readonly default: ExecutionContext<any>;
+export declare interface ExecutionContext<TParent = any> {
     /**
      * The index of the current item within a repeat context.
      */
@@ -993,41 +892,40 @@ export declare class ExecutionContext<TParentSource = any> {
     /**
      * The parent data source within a nested context.
      */
-    readonly parent: TParentSource;
+    parent: TParent;
     /**
      * The parent execution context when in nested context scenarios.
      */
-    readonly parentContext: ExecutionContext<TParentSource>;
-    private constructor();
+    parentContext: ExecutionContext<TParent>;
     /**
      * The current event within an event handler.
      */
-    get event(): Event;
+    readonly event: Event;
     /**
      * Indicates whether the current item within a repeat context
      * has an even index.
      */
-    get isEven(): boolean;
+    readonly isEven: boolean;
     /**
      * Indicates whether the current item within a repeat context
      * has an odd index.
      */
-    get isOdd(): boolean;
+    readonly isOdd: boolean;
     /**
      * Indicates whether the current item within a repeat context
      * is the first item in the collection.
      */
-    get isFirst(): boolean;
+    readonly isFirst: boolean;
     /**
      * Indicates whether the current item within a repeat context
      * is somewhere in the middle of the collection.
      */
-    get isInMiddle(): boolean;
+    readonly isInMiddle: boolean;
     /**
      * Indicates whether the current item within a repeat context
      * is the last item in the collection.
      */
-    get isLast(): boolean;
+    readonly isLast: boolean;
     /**
      * Returns the typed event detail of a custom event.
      */
@@ -1036,32 +934,28 @@ export declare class ExecutionContext<TParentSource = any> {
      * Returns the typed event target of the event.
      */
     eventTarget<TTarget extends EventTarget>(): TTarget;
+}
+
+/**
+ * Provides additional contextual information available to behaviors and expressions.
+ * @public
+ */
+export declare const ExecutionContext: Readonly<{
     /**
-     * Updates the position/size on a context associated with a list item.
-     * @param index - The new index of the item.
-     * @param length - The new length of the list.
-     */
-    updatePosition(index: number, length: number): void;
-    /**
-     * Creates a new execution context descendent from the current context.
-     * @param source - The source for the context if different than the parent.
-     * @returns A child execution context.
+     * A default execution context.
      */
-    createChildContext<TParentSource>(parentSource: TParentSource): ExecutionContext<TParentSource>;
+    default: ExecutionContext<any>;
     /**
-     * Creates a new execution context descent suitable for use in list rendering.
-     * @param item - The list item to serve as the source.
-     * @param index - The index of the item in the list.
-     * @param length - The length of the list.
+     * Gets the current event.
+     * @returns An event object.
      */
-    createItemContext(index: number, length: number): ExecutionContext<TParentSource>;
-    /* Excluded from this release type: setEvent */
+    getEvent(): Event | null;
     /**
-     * Creates a new root execution context.
-     * @returns A new execution context.
+     * Sets the current event.
+     * @param event - An event object.
      */
-    static create(): ExecutionContext;
-}
+    setEvent(event: Event | null): void;
+}>;
 
 /**
  * The signature of an arrow function capable of being evaluated
@@ -1070,11 +964,47 @@ export declare class ExecutionContext<TParentSource = any> {
  */
 export declare type Expression<TSource = any, TReturn = any, TParent = any> = (source: TSource, context: ExecutionContext<TParent>) => TReturn;
 
+/**
+ * Controls the lifecycle of an expression and provides relevant context.
+ * @public
+ */
+export declare interface ExpressionController<TSource = any, TParent = any> {
+    /**
+     * The source the expression is evaluated against.
+     */
+    readonly source: TSource;
+    /**
+     * Indicates how the source's lifetime relates to the controller's lifetime.
+     */
+    readonly sourceLifetime?: SourceLifetime;
+    /**
+     * The context the expression is evaluated against.
+     */
+    readonly context: ExecutionContext<TParent>;
+    /**
+     * Indicates whether the controller is bound.
+     */
+    readonly isBound: boolean;
+    /**
+     * Registers an unbind handler with the controller.
+     * @param behavior - An object to call when the controller unbinds.
+     */
+    onUnbind(behavior: {
+        unbind(controller: ExpressionController<TSource, TParent>): any;
+    }): void;
+}
+
 /**
  * Enables evaluation of and subscription to a binding.
  * @public
  */
-export declare interface ExpressionNotifier<TSource = any, TReturn = any, TParent = any> extends Notifier, ExpressionObserver<TSource, TReturn, TParent> {
+export declare interface ExpressionNotifier<TSource = any, TReturn = any, TParent = any> extends Notifier, ExpressionObserver<TSource, TReturn, TParent>, Disposable {
+    /**
+     * Observes the expression.
+     * @param source - The source for the expression.
+     * @param context - The context for the expression.
+     */
+    observe(source: TSource, context?: ExecutionContext): TReturn;
     /**
      * Gets {@link ObservationRecord|ObservationRecords} that the {@link ExpressionNotifier}
      * is observing.
@@ -1092,17 +1022,16 @@ export declare interface ExpressionNotifier<TSource = any, TReturn = any, TParen
 }
 
 /**
- * Observes a binding for changes.
- *
+ * Observes an expression for changes.
  * @public
  */
-export declare interface ExpressionObserver<TSource = any, TReturn = any, TParent = any> extends Disposable {
+export declare interface ExpressionObserver<TSource = any, TReturn = any, TParent = any> {
     /**
-     * Begins observing the binding.
-     * @param source - The source to pass to the binding.
-     * @param context - The context to pass to the binding.
+     * Binds the expression to the source.
+     * @param controller - The controller that manages the lifecycle and related
+     * context for the expression.
      */
-    observe(source: TSource, context?: ExecutionContext<TParent>): TReturn;
+    bind(controller: ExpressionController<TSource, TParent>): TReturn;
 }
 
 /* Excluded from this release type: FAST */
@@ -1116,7 +1045,7 @@ export declare 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.
@@ -1205,11 +1134,15 @@ 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;
+    /**
+     * The registry to register this component in by default.
+     */
+    readonly registry: CustomElementRegistry;
     private constructor();
     /**
      * Defines a custom element based on this definition.
@@ -1241,6 +1174,75 @@ export declare class FASTElementDefinition<TType extends Constructable<HTMLEleme
 
 declare function from<TBase extends typeof HTMLElement>(BaseType: TBase): new () => InstanceType<TBase> & FASTElement;
 
+/**
+ * Represents an object that can contribute behavior to a host.
+ * @public
+ */
+export declare interface HostBehavior<TSource = any> {
+    /**
+     * Executed when this behavior is attached to a controller.
+     * @param controller - Controls the behavior lifecycle.
+     */
+    addedCallback?(controller: HostController<TSource>): void;
+    /**
+     * Executed when this behavior is detached from a controller.
+     * @param controller - Controls the behavior lifecycle.
+     */
+    removedCallback?(controller: HostController<TSource>): void;
+    /**
+     * Executed when this behavior's host is connected.
+     * @param controller - Controls the behavior lifecycle.
+     */
+    connectedCallback?(controller: HostController<TSource>): void;
+    /**
+     * Executed when this behavior's host is disconnected.
+     * @param controller - Controls the behavior lifecycle.
+     */
+    disconnectedCallback?(controller: HostController<TSource>): void;
+}
+
+/**
+ * Controls the lifecycle and context of behaviors and styles
+ * associated with a component host.
+ * @public
+ */
+export declare interface HostController<TSource = any> {
+    /**
+     * The component source.
+     */
+    readonly source: TSource;
+    /**
+     * Indicates whether the host is connected or not.
+     */
+    readonly isConnected: boolean;
+    /**
+     * The main set of styles used for the component, independent
+     * of any behavior-specific styles.
+     */
+    mainStyles: ElementStyles | null;
+    /**
+     * Adds the behavior to the component.
+     * @param behavior - The behavior to add.
+     */
+    addBehavior(behavior: HostBehavior<TSource>): 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<TSource>, 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.
+     */
+    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 | null | undefined): void;
+}
+
 /**
  * Transforms a template literal string into a ViewTemplate.
  * @param strings - The string fragments that are interpolated with the values.
@@ -1256,9 +1258,10 @@ export declare function html<TSource = any, TParent = any>(strings: TemplateStri
  * A directive that applies bindings.
  * @public
  */
-export declare class HTMLBindingDirective implements HTMLDirective, ViewBehaviorFactory, Aspected {
+export declare class HTMLBindingDirective implements HTMLDirective, ViewBehaviorFactory, ViewBehavior, Aspected {
     dataBinding: Binding;
-    private factory;
+    private data;
+    private updateTarget;
     /**
      * The unique id of the factory.
      */
@@ -1291,9 +1294,15 @@ export declare class HTMLBindingDirective implements HTMLDirective, ViewBehavior
     createHTML(add: AddViewBehaviorFactory): string;
     /**
      * Creates a behavior.
-     * @param targets - The targets available for behaviors to be attached to.
      */
-    createBehavior(targets: ViewBehaviorTargets): ViewBehavior;
+    createBehavior(): ViewBehavior;
+    /* Excluded from this release type: bindDefault */
+    /* Excluded from this release type: bind */
+    /* Excluded from this release type: bindContent */
+    /* Excluded from this release type: bindEvent */
+    /* Excluded from this release type: unbind */
+    /* Excluded from this release type: handleEvent */
+    /* Excluded from this release type: handleChange */
 }
 
 /**
@@ -1365,19 +1374,75 @@ export declare interface HTMLTemplateCompilationResult<TSource = any, TParent =
  * The standard View implementation, which also implements ElementView and SyntheticView.
  * @public
  */
-export declare class HTMLView<TSource = any, TParent = any> implements ElementView<TSource, TParent>, SyntheticView<TSource, TParent> {
+export declare class HTMLView<TSource = any, TParent = any> implements ElementView<TSource, TParent>, SyntheticView<TSource, TParent>, ExecutionContext<TParent> {
     private fragment;
     private factories;
-    private targets;
+    readonly targets: ViewBehaviorTargets;
     private behaviors;
+    private unbindables;
     /**
      * The data that the view is bound to.
      */
     source: TSource | null;
+    isBound: boolean;
+    selfContained: boolean;
     /**
      * The execution context the view is running within.
      */
-    context: ExecutionContext<TParent> | null;
+    get context(): ExecutionContext<TParent>;
+    /**
+     * The index of the current item within a repeat context.
+     */
+    index: number;
+    /**
+     * The length of the current collection within a repeat context.
+     */
+    length: number;
+    /**
+     * The parent data source within a nested context.
+     */
+    readonly parent: TParent;
+    /**
+     * The parent execution context when in nested context scenarios.
+     */
+    readonly parentContext: ExecutionContext<TParent>;
+    /**
+     * The current event within an event handler.
+     */
+    get event(): Event;
+    /**
+     * Indicates whether the current item within a repeat context
+     * has an even index.
+     */
+    get isEven(): boolean;
+    /**
+     * Indicates whether the current item within a repeat context
+     * has an odd index.
+     */
+    get isOdd(): boolean;
+    /**
+     * Indicates whether the current item within a repeat context
+     * is the first item in the collection.
+     */
+    get isFirst(): boolean;
+    /**
+     * Indicates whether the current item within a repeat context
+     * is somewhere in the middle of the collection.
+     */
+    get isInMiddle(): boolean;
+    /**
+     * Indicates whether the current item within a repeat context
+     * is the last item in the collection.
+     */
+    get isLast(): boolean;
+    /**
+     * Returns the typed event detail of a custom event.
+     */
+    eventDetail<TDetail>(): TDetail;
+    /**
+     * Returns the typed event target of the event.
+     */
+    eventTarget<TTarget extends EventTarget>(): TTarget;
     /**
      * The first DOM node in the range of nodes that make up the view.
      */
@@ -1412,16 +1477,20 @@ export declare class HTMLView<TSource = any, TParent = any> implements ElementVi
      * Once a view has been disposed, it cannot be inserted or bound again.
      */
     dispose(): void;
+    onUnbind(behavior: {
+        unbind(controller: ViewController<TSource, TParent>): any;
+    }): void;
     /**
      * Binds a view's behaviors to its binding source.
      * @param source - The binding source for the view's binding behaviors.
      * @param context - The execution context to run the behaviors within.
      */
-    bind(source: TSource, context: ExecutionContext<TParent>): void;
+    bind(source: TSource): void;
     /**
      * Unbinds a view's behaviors from its binding source.
      */
     unbind(): void;
+    private evaluateUnbindables;
     /**
      * Efficiently disposes of a contiguous range of synthetic view instances.
      * @param views - A contiguous range of views to be disposed.
@@ -1523,14 +1592,14 @@ export declare abstract class NodeObservationDirective<T extends NodeBehaviorOpt
      * @param context - The execution context that the binding is operating within.
      * @param targets - The targets that behaviors in a view can attach to.
      */
-    bind(source: any, context: ExecutionContext, targets: ViewBehaviorTargets): void;
+    bind(controller: ViewController): void;
     /**
      * Unbinds this behavior from the source.
      * @param source - The source to unbind from.
      * @param context - The execution context that the binding is operating within.
      * @param targets - The targets that behaviors in a view can attach to.
      */
-    unbind(source: any, context: ExecutionContext, targets: ViewBehaviorTargets): void;
+    unbind(controller: ViewController): void;
     /**
      * Gets the data source for the target.
      * @param target - The target to get the source for.
@@ -1747,12 +1816,21 @@ export declare 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;
 }
 
 /**
@@ -1808,7 +1886,7 @@ export declare class PropertyChangeNotifier implements Notifier {
  * @param propertyName - The name of the property to assign the reference to.
  * @public
  */
-export declare const ref: <T = any>(propertyName: keyof T & string) => CaptureType<T>;
+export declare const ref: <TSource = any, TParent = any>(propertyName: keyof TSource & string) => CaptureType<TSource, TParent>;
 
 /**
  * The runtime behavior for template references.
@@ -1816,17 +1894,10 @@ export declare const ref: <T = any>(propertyName: keyof T & string) => CaptureTy
  */
 export declare class RefDirective extends StatelessAttachedAttributeDirective<string> {
     /**
-     * Bind this behavior to the source.
-     * @param source - The source to bind to.
-     * @param context - The execution context that the binding is operating within.
-     * @param targets - The targets that behaviors in a view can attach to.
-     */
-    bind(source: any, context: ExecutionContext, targets: ViewBehaviorTargets): void;
-    /**
-     * Unbinds this behavior from the source.
-     * @param source - The source to unbind from.
+     * Bind this behavior.
+     * @param controller - The view controller that manages the lifecycle of this behavior.
      */
-    unbind(): void;
+    bind(controller: ViewController): void;
 }
 
 declare const reflectMode = "reflect";
@@ -1839,24 +1910,22 @@ declare const reflectMode = "reflect";
  * @param options - Options used to turn on special repeat features.
  * @public
  */
-export declare function repeat<TSource = any, TArray extends ReadonlyArray<any> = ReadonlyArray<any>>(items: Expression<TSource, TArray, ExecutionContext<TSource>> | Binding<TSource, TArray> | ReadonlyArray<any>, template: Expression<TSource, ViewTemplate> | Binding<TSource, ViewTemplate> | ViewTemplate, options?: RepeatOptions): CaptureType<TSource>;
+export declare function repeat<TSource = any, TArray extends ReadonlyArray<any> = ReadonlyArray<any>, TParent = any>(items: Expression<TSource, TArray, TParent> | Binding<TSource, TArray, TParent> | ReadonlyArray<any>, template: Expression<TSource, ViewTemplate<any, TSource>> | Binding<TSource, ViewTemplate<any, TSource>> | ViewTemplate<any, TSource>, options?: RepeatOptions): CaptureType<TSource, TParent>;
 
 /**
  * A behavior that renders a template for each item in an array.
  * @public
  */
-export declare class RepeatBehavior<TSource = any> implements Behavior, Subscriber {
+export declare class RepeatBehavior<TSource = any> implements ViewBehavior, Subscriber {
     private directive;
     private location;
-    private source;
+    private controller;
     private views;
     private template;
     private templateBindingObserver;
     private items;
     private itemsObserver;
     private itemsBindingObserver;
-    private context;
-    private childContext;
     private bindView;
     /**
      * Creates an instance of RepeatBehavior.
@@ -1867,16 +1936,14 @@ export declare class RepeatBehavior<TSource = any> implements Behavior, Subscrib
      * @param isTemplateBindingVolatile - Indicates whether the template binding has volatile dependencies.
      * @param options - Options used to turn on special repeat features.
      */
-    constructor(directive: RepeatDirective, location: Node);
+    constructor(directive: RepeatDirective);
     /**
-     * Bind this behavior to the source.
-     * @param source - The source to bind to.
-     * @param context - The execution context that the binding is operating within.
+     * Bind this behavior.
+     * @param controller - The view controller that manages the lifecycle of this behavior.
      */
-    bind(source: TSource, context: ExecutionContext): void;
+    bind(controller: ViewController): void;
     /**
-     * Unbinds this behavior from the source.
-     * @param source - The source to unbind from.
+     * Unbinds this behavior.
      */
     unbind(): void;
     /**
@@ -1923,7 +1990,7 @@ export declare class RepeatDirective<TSource = any> implements HTMLDirective, Vi
      * Creates a behavior for the provided target node.
      * @param target - The node instance to create the behavior for.
      */
-    createBehavior(targets: ViewBehaviorTargets): RepeatBehavior<TSource>;
+    createBehavior(): RepeatBehavior<TSource>;
 }
 
 /**
@@ -1941,13 +2008,26 @@ export declare interface RepeatOptions {
     recycle?: boolean;
 }
 
+/**
+ * Shadow root initialization options.
+ * @public
+ */
+export declare interface ShadowRootOptions extends ShadowRootInit {
+    /**
+     * A registry that provides the custom elements visible
+     * from within this shadow root.
+     * @beta
+     */
+    registry?: CustomElementRegistry;
+}
+
 /**
  * A directive that observes the `assignedNodes()` of a slot and updates a property
  * whenever they change.
  * @param propertyOrOptions - The options used to configure slotted node observation.
  * @public
  */
-export declare function slotted<T = any>(propertyOrOptions: (keyof T & string) | SlottedDirectiveOptions<keyof T & string>): CaptureType<T>;
+export declare function slotted<TSource = any, TParent = any>(propertyOrOptions: (keyof TSource & string) | SlottedDirectiveOptions<keyof TSource & string>): CaptureType<TSource, TParent>;
 
 /**
  * The runtime behavior for slotted node observation.
@@ -1979,6 +2059,28 @@ export declare class SlottedDirective extends NodeObservationDirective<SlottedDi
 export declare interface SlottedDirectiveOptions<T = any> extends NodeBehaviorOptions<T>, AssignedNodesOptions {
 }
 
+/**
+ * Describes how the source's lifetime relates to its controller's lifetime.
+ * @public
+ */
+export declare const SourceLifetime: Readonly<{
+    /**
+     * The source to controller lifetime relationship is unknown.
+     */
+    readonly unknown: undefined;
+    /**
+     * The source and controller lifetimes are coupled to one another.
+     * They can/will be GC'd together.
+     */
+    readonly coupled: 1;
+}>;
+
+/**
+ * Describes how the source's lifetime relates to its controller's lifetime.
+ * @public
+ */
+export declare type SourceLifetime = typeof SourceLifetime[keyof typeof SourceLifetime];
+
 /**
  * A splice map is a representation of how a previous array of items
  * was transformed into a new array of items. Conceptually it is a list of
@@ -2135,8 +2237,8 @@ export declare type SpliceStrategySupport = typeof SpliceStrategySupport[keyof t
  * A base class used for attribute directives that don't need internal state.
  * @public
  */
-export declare abstract class StatelessAttachedAttributeDirective<T> implements HTMLDirective, ViewBehaviorFactory, ViewBehavior {
-    protected options: T;
+export declare abstract class StatelessAttachedAttributeDirective<TOptions> implements HTMLDirective, ViewBehaviorFactory, ViewBehavior {
+    protected options: TOptions;
     /**
      * The unique id of the factory.
      */
@@ -2149,12 +2251,7 @@ export declare abstract class StatelessAttachedAttributeDirective<T> implements
      * Creates an instance of RefDirective.
      * @param options - The options to use in configuring the directive.
      */
-    constructor(options: T);
-    /**
-     * Creates a behavior.
-     * @param targets - The targets available for behaviors to be attached to.
-     */
-    createBehavior(targets: ViewBehaviorTargets): ViewBehavior;
+    constructor(options: TOptions);
     /**
      * Creates a placeholder string based on the directive's index within the template.
      * @param index - The index of the directive within the template.
@@ -2163,17 +2260,15 @@ export declare abstract class StatelessAttachedAttributeDirective<T> implements
      */
     createHTML(add: AddViewBehaviorFactory): string;
     /**
-     * Bind this behavior to the source.
-     * @param source - The source to bind to.
-     * @param context - The execution context that the binding is operating within.
-     * @param targets - The targets that behaviors in a view can attach to.
+     * Creates a behavior.
+     * @param targets - The targets available for behaviors to be attached to.
      */
-    abstract bind(source: any, context: ExecutionContext, targets: ViewBehaviorTargets): void;
+    createBehavior(): ViewBehavior;
     /**
-     * Unbinds this behavior from the source.
-     * @param source - The source to unbind from.
+     * Bind this behavior.
+     * @param controller - The view controller that manages the lifecycle of this behavior.
      */
-    abstract unbind(source: any, context: ExecutionContext, targets: ViewBehaviorTargets): void;
+    abstract bind(controller: ViewController): void;
 }
 
 /**
@@ -2336,7 +2431,7 @@ export declare interface SyntheticViewTemplate<TSource = any, TParent = any> {
  * Represents the types of values that can be interpolated into a template.
  * @public
  */
-export declare type TemplateValue<TSource, TParent = any> = Expression<TSource, any, TParent> | Binding<TSource, any, TParent> | HTMLDirective | CaptureType<TSource>;
+export declare type TemplateValue<TSource, TParent = any> = Expression<TSource, any, TParent> | Binding<TSource, any, TParent> | HTMLDirective | CaptureType<TSource, TParent>;
 
 /**
  * Enables working with trusted types.
@@ -2408,29 +2503,6 @@ export declare interface UpdateQueue {
  */
 export declare const Updates: UpdateQueue;
 
-/**
- * A target update function.
- * @param this - The "this" context for the update.
- * @param target - The node that is targeted by the update.
- * @param aspect - The aspect of the node that is being targeted.
- * @param value - The value to assign to the aspect.
- * @param source - The source object that the value was derived from.
- * @param context - The execution context that the binding is being run under.
- * @public
- */
-export declare type UpdateTarget = (this: UpdateTargetThis, target: Node, aspect: string, value: any, source: any, context: ExecutionContext) => void;
-
-/**
- * The "this" context for an update target function.
- * @public
- */
-export declare interface UpdateTargetThis {
-    /**
-     * The directive configuration for the update.
-     */
-    directive: HTMLBindingDirective;
-}
-
 /**
  * Represents objects that can convert values to and from
  * view or model representations.
@@ -2457,7 +2529,7 @@ export declare interface View<TSource = any, TParent = any> extends Disposable {
     /**
      * The execution context the view is running within.
      */
-    readonly context: ExecutionContext<TParent> | null;
+    readonly context: ExecutionContext<TParent>;
     /**
      * The data that the view is bound to.
      */
@@ -2465,9 +2537,8 @@ export declare interface View<TSource = any, TParent = any> extends Disposable {
     /**
      * Binds a view's behaviors to its binding source.
      * @param source - The binding source for the view's binding behaviors.
-     * @param context - The execution context to run the view within.
      */
-    bind(source: TSource, context: ExecutionContext<TParent>): void;
+    bind(source: TSource): void;
     /**
      * Unbinds a view's behaviors from its binding source and context.
      */
@@ -2480,23 +2551,14 @@ export declare interface View<TSource = any, TParent = any> extends Disposable {
  */
 export declare interface ViewBehavior<TSource = any, TParent = any> {
     /**
-     * Bind this behavior to the source.
-     * @param source - The source to bind to.
-     * @param context - The execution context that the binding is operating within.
-     * @param targets - The targets that behaviors in a view can attach to.
-     */
-    bind(source: TSource, context: ExecutionContext<TParent>, targets: ViewBehaviorTargets): void;
-    /**
-     * Unbinds this behavior from the source.
-     * @param source - The source to unbind from.
-     * @param context - The execution context that the binding is operating within.
-     * @param targets - The targets that behaviors in a view can attach to.
+     * Bind this behavior.
+     * @param controller - The view controller that manages the lifecycle of this behavior.
      */
-    unbind(source: TSource, context: ExecutionContext<TParent>, targets: ViewBehaviorTargets): void;
+    bind(controller: ViewController<TSource, TParent>): void;
 }
 
 /**
- * A factory that can create a {@link Behavior} associated with a particular
+ * A factory that can create a {@link ViewBehavior} associated with a particular
  * location within a DOM fragment.
  * @public
  */
@@ -2511,11 +2573,49 @@ export declare interface ViewBehaviorFactory {
     nodeId: string;
     /**
      * Creates a behavior.
-     * @param targets - The targets available for behaviors to be attached to.
      */
-    createBehavior(targets: ViewBehaviorTargets): Behavior | ViewBehavior;
+    createBehavior(): ViewBehavior;
+}
+
+/**
+ * Bridges between ViewBehaviors and HostBehaviors, enabling a host to
+ * control ViewBehaviors.
+ * @public
+ */
+export declare interface ViewBehaviorOrchestrator<TSource = any, TParent = any> extends ViewController<TSource, TParent>, HostBehavior<TSource> {
+    /**
+     *
+     * @param nodeId - The structural id of the DOM node to which a behavior will apply.
+     * @param target - The DOM node associated with the id.
+     */
+    addTarget(nodeId: string, target: Node): void;
+    /**
+     * Adds a behavior.
+     * @param behavior - The behavior to add.
+     */
+    addBehavior(behavior: ViewBehavior): void;
+    /**
+     * Adds a behavior factory.
+     * @param factory - The behavior factory to add.
+     * @param target - The target the factory will create behaviors for.
+     */
+    addBehaviorFactory(factory: ViewBehaviorFactory, target: Node): void;
 }
 
+/**
+ * Bridges between ViewBehaviors and HostBehaviors, enabling a host to
+ * control ViewBehaviors.
+ * @public
+ */
+export declare const ViewBehaviorOrchestrator: Readonly<{
+    /**
+     * Creates a ViewBehaviorOrchestrator.
+     * @param source - The source to to associate behaviors with.
+     * @returns A ViewBehaviorOrchestrator.
+     */
+    create<TSource = any, TParent = any>(source: TSource): ViewBehaviorOrchestrator<TSource, TParent>;
+}>;
+
 /**
  * The target nodes available to a behavior.
  * @public
@@ -2524,6 +2624,17 @@ export declare type ViewBehaviorTargets = {
     [id: string]: Node;
 };
 
+/**
+ * Controls the lifecycle of a view and provides relevant context.
+ * @public
+ */
+export declare interface ViewController<TSource = any, TParent = any> extends ExpressionController<TSource, TParent> {
+    /**
+     * The parts of the view that are targeted by view behaviors.
+     */
+    readonly targets: ViewBehaviorTargets;
+}
+
 /**
  * A template capable of creating HTMLView instances or rendering directly to DOM.
  * @public
@@ -2557,7 +2668,7 @@ export declare class ViewTemplate<TSource = any, TParent = any> implements Eleme
      * @param hostBindingTarget - An HTML element to target the host bindings at if different from the
      * host that the template is being attached to.
      */
-    render(source: TSource, host: Node, hostBindingTarget?: Element, context?: ExecutionContext): HTMLView<TSource, TParent>;
+    render(source: TSource, host: Node, hostBindingTarget?: Element): HTMLView<TSource, TParent>;
 }
 
 /**
@@ -2576,6 +2687,6 @@ export declare function volatile(target: {}, name: string | Accessor, descriptor
  * the template to render when the condition is true.
  * @public
  */
-export declare function when<TSource = any, TReturn = any>(condition: Expression<TSource, TReturn> | boolean, templateOrTemplateBinding: SyntheticViewTemplate | Expression<TSource, SyntheticViewTemplate>): CaptureType<TSource>;
+export declare function when<TSource = any, TReturn = any, TParent = any>(condition: Expression<TSource, TReturn, TParent> | boolean, templateOrTemplateBinding: SyntheticViewTemplate<TSource, TParent> | Expression<TSource, SyntheticViewTemplate<TSource, TParent>, TParent>): CaptureType<TSource, TParent>;
 
 export { }