@microsoft/fast-element 1.7.1 → 1.9.0

package/dist/fast-element.api.json

@@ -1535,6 +1535,10 @@
                   "text": "ExecutionContext",
                   "canonicalReference": "@microsoft/fast-element!ExecutionContext:class"
                 },
+                {
+                  "kind": "Content",
+                  "text": "<TParent>"
+                },
                 {
                   "kind": "Content",
                   "text": "): "
@@ -1549,8 +1553,8 @@
                 }
               ],
               "returnTypeTokenRange": {
-                "startIndex": 5,
-                "endIndex": 6
+                "startIndex": 6,
+                "endIndex": 7
               },
               "releaseTag": "Public",
               "overloadIndex": 1,
@@ -1566,7 +1570,7 @@
                   "parameterName": "context",
                   "parameterTypeTokenRange": {
                     "startIndex": 3,
-                    "endIndex": 4
+                    "endIndex": 5
                   }
                 }
               ],
@@ -3527,7 +3531,7 @@
             },
             {
               "kind": "Content",
-              "text": "): number;\n    createInterpolationPlaceholder(index: number): string;\n    createCustomAttributePlaceholder(attributeName: string, index: number): string;\n    createBlockPlaceholder(index: number): string;\n    queueUpdate(callable: "
+              "text": "): number;\n    createInterpolationPlaceholder(index: number): string;\n    createCustomAttributePlaceholder(attributeName: string, index: number): string;\n    createBlockPlaceholder(index: number): string;\n    queueUpdate: (callable: "
             },
             {
               "kind": "Reference",
@@ -3536,7 +3540,7 @@
             },
             {
               "kind": "Content",
-              "text": "): void;\n    processUpdates(): void;\n    nextUpdate(): "
+              "text": ") => void;\n    processUpdates: () => void;\n    nextUpdate(): "
             },
             {
               "kind": "Reference",
@@ -4987,13 +4991,17 @@
               "isStatic": false
             },
             {
-              "kind": "Method",
-              "canonicalReference": "@microsoft/fast-element!FASTElementDefinition.forType:member(1)",
+              "kind": "Property",
+              "canonicalReference": "@microsoft/fast-element!FASTElementDefinition.forType:member",
               "docComment": "/**\n * Gets the element definition associated with the specified type.\n *\n * @param type - The custom element type to retrieve the definition for.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "static forType<TType extends "
+                  "text": "static readonly forType: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TType_1 extends "
                 },
                 {
                   "kind": "Reference",
@@ -5002,60 +5010,38 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ">(type: "
+                  "text": ">(key: TType_1) => "
                 },
                 {
-                  "kind": "Content",
-                  "text": "TType"
+                  "kind": "Reference",
+                  "text": "FASTElementDefinition",
+                  "canonicalReference": "@microsoft/fast-element!FASTElementDefinition:class"
                 },
                 {
                   "kind": "Content",
-                  "text": "): "
+                  "text": "<"
                 },
                 {
                   "kind": "Reference",
-                  "text": "FASTElementDefinition",
-                  "canonicalReference": "@microsoft/fast-element!FASTElementDefinition:class"
+                  "text": "Function",
+                  "canonicalReference": "!Function:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": " | undefined"
+                  "text": "> | undefined"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isStatic": true,
-              "returnTypeTokenRange": {
-                "startIndex": 5,
-                "endIndex": 7
-              },
               "releaseTag": "Public",
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "type",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 3,
-                    "endIndex": 4
-                  }
-                }
-              ],
-              "typeParameters": [
-                {
-                  "typeParameterName": "TType",
-                  "constraintTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "defaultTypeTokenRange": {
-                    "startIndex": 0,
-                    "endIndex": 0
-                  }
-                }
-              ],
-              "name": "forType"
+              "name": "forType",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 8
+              },
+              "isStatic": true
             },
             {
               "kind": "Property",
@@ -5064,7 +5050,7 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "readonly isDefined: "
+                  "text": "get isDefined(): "
                 },
                 {
                   "kind": "Content",
@@ -5286,6 +5272,15 @@
               "text": "TrustedTypes",
               "canonicalReference": "@microsoft/fast-element!TrustedTypes:type"
             },
+            {
+              "kind": "Content",
+              "text": ";\n    readonly FAST: "
+            },
+            {
+              "kind": "Reference",
+              "text": "FASTGlobal",
+              "canonicalReference": "@microsoft/fast-element!FASTGlobal:interface"
+            },
             {
               "kind": "Content",
               "text": ";\n}"
@@ -5299,7 +5294,7 @@
           "name": "Global",
           "typeTokenRange": {
             "startIndex": 1,
-            "endIndex": 6
+            "endIndex": 8
           }
         },
         {
@@ -6722,7 +6717,7 @@
             },
             {
               "kind": "Content",
-              "text": "): void;\n    getNotifier(source: any): "
+              "text": "): void;\n    getNotifier: (source: any) => "
             },
             {
               "kind": "Reference",
@@ -6740,7 +6735,7 @@
             },
             {
               "kind": "Content",
-              "text": "): void;\n    getAccessors(target: {}): "
+              "text": "): void;\n    getAccessors: (target: {}) => "
             },
             {
               "kind": "Reference",

package/dist/fast-element.d.ts

@@ -262,7 +262,7 @@ export declare interface BindingObserver<TSource = any, TReturn = any, TParent =
      * @param context - The execution context to execute the binding within.
      * @returns The value of the binding.
      */
-    observe(source: TSource, context: ExecutionContext): TReturn;
+    observe(source: TSource, context: ExecutionContext<TParent>): TReturn;
     /**
      * Unsubscribe from all dependent observables of the binding.
      */
@@ -639,7 +639,7 @@ export declare const DOM: Readonly<{
      * Schedules DOM update work in the next async batch.
      * @param callable - The callable function or object to queue.
      */
-    queueUpdate(callable: Callable): void;
+    queueUpdate: (callable: Callable) => void;
     /**
      * Immediately processes all work previously scheduled
      * through queueUpdate.
@@ -647,7 +647,7 @@ export declare const DOM: Readonly<{
      * This also forces nextUpdate promises
      * to resolve.
      */
-    processUpdates(): void;
+    processUpdates: () => void;
     /**
      * Resolves with the next DOM update.
      */
@@ -831,8 +831,20 @@ export declare class ExecutionContext<TParent = any, TGrandparent = any> {
      * is the last item in the collection.
      */
     get isLast(): boolean;
+    /**
+     * Sets the event for the current execution context.
+     * @param event - The event to set.
+     * @internal
+     */
+    static setEvent(event: Event | null): void;
 }
 
+/**
+ * The FAST global.
+ * @internal
+ */
+export declare const FAST: FASTGlobal;
+
 /**
  * Represents a custom element based on the FASTElement infrastructure.
  * @public
@@ -915,7 +927,7 @@ export declare class FASTElementDefinition<TType extends Function = Function> {
     /**
      * Indicates if this element has been defined in at least one registry.
      */
-    readonly isDefined: boolean;
+    get isDefined(): boolean;
     /**
      * The name of the custom element.
      */
@@ -964,7 +976,25 @@ export declare class FASTElementDefinition<TType extends Function = Function> {
      * Gets the element definition associated with the specified type.
      * @param type - The custom element type to retrieve the definition for.
      */
-    static forType<TType extends Function>(type: TType): FASTElementDefinition | undefined;
+    static readonly forType: <TType_1 extends Function>(key: TType_1) => FASTElementDefinition<Function> | undefined;
+}
+
+/**
+ * The FAST global.
+ * @internal
+ */
+export declare interface FASTGlobal {
+    /**
+     * The list of loaded versions.
+     */
+    readonly versions: string[];
+    /**
+     * Gets a kernel value.
+     * @param id - The id to get the value for.
+     * @param initialize - Creates the initial value for the id if not already existing.
+     */
+    getById<T>(id: string | number): T | null;
+    getById<T>(id: string | number, initialize: () => T): T;
 }
 
 /**
@@ -976,6 +1006,11 @@ export declare type Global = typeof globalThis & {
      * Enables working with trusted types.
      */
     trustedTypes: TrustedTypes;
+    /**
+     * The FAST global.
+     * @internal
+     */
+    readonly FAST: FASTGlobal;
 };
 
 /**
@@ -1112,6 +1147,17 @@ export declare class HTMLView implements ElementView, SyntheticView {
     static disposeContiguousBatch(views: SyntheticView[]): void;
 }
 
+/**
+ * Core services shared across FAST instances.
+ * @internal
+ */
+export declare const enum KernelServiceId {
+    updateQueue = 1,
+    observable = 2,
+    contextEvent = 3,
+    elementRegistry = 4
+}
+
 /**
  * Reverses all readonly members, making them mutable.
  * @internal
@@ -1262,7 +1308,7 @@ export declare const Observable: Readonly<{
      * Gets a notifier for an object or Array.
      * @param source - The object or Array to get the notifier for.
      */
-    getNotifier(source: any): Notifier;
+    getNotifier: (source: any) => Notifier;
     /**
      * Records a property change for a source object.
      * @param source - The object to record the change against.
@@ -1292,7 +1338,7 @@ export declare const Observable: Readonly<{
      * including its prototype chain.
      * @param target - The target object to search for accessor on.
      */
-    getAccessors(target: {}): Accessor[];
+    getAccessors: (target: {}) => Accessor[];
     /**
      * Creates a {@link BindingObserver} that can watch the
      * provided {@link Binding} for changes.
@@ -1534,12 +1580,6 @@ export declare interface RepeatOptions {
     recycle?: boolean;
 }
 
-/**
- * @param event - The event to set as current for the context.
- * @internal
- */
-export declare function setCurrentEvent(event: Event | null): void;
-
 /**
  * A directive that observes the `assignedNodes()` of a slot and updates a property
  * whenever they change.