@microsoft/fast-html 1.0.0-alpha.4 → 1.0.0-alpha.40

package/dist/esm/index.js

@@ -1,4 +1,4 @@
 import { FAST } from "@microsoft/fast-element";
 import { debugMessages } from "./debug.js";
 FAST.addMessages(debugMessages);
-export { TemplateElement } from "./components/index.js";
+export { RenderableFASTElement, TemplateElement, ObserverMap, } from "./components/index.js";

package/dist/fast-html.api.json

@@ -1,7 +1,7 @@
 {
   "metadata": {
     "toolPackage": "@microsoft/api-extractor",
-    "toolVersion": "7.47.0",
+    "toolVersion": "7.57.7",
     "schemaVersion": 1011,
     "oldestForwardsCompatibleVersion": 1001,
     "tsdocConfig": {
@@ -114,6 +114,22 @@
           "tagName": "@virtual",
           "syntaxKind": "modifier"
         },
+        {
+          "tagName": "@jsx",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxRuntime",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxFrag",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxImportSource",
+          "syntaxKind": "block"
+        },
         {
           "tagName": "@betaDocumentation",
           "syntaxKind": "modifier"
@@ -172,6 +188,185 @@
       "name": "",
       "preserveMemberOrder": false,
       "members": [
+        {
+          "kind": "Class",
+          "canonicalReference": "@microsoft/fast-html!ObserverMap:class",
+          "docComment": "/**\n * ObserverMap provides functionality for caching binding paths, extracting root properties, and defining observable properties on class prototypes\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare class ObserverMap "
+            }
+          ],
+          "fileUrlPath": "dist/dts/components/observer-map.d.ts",
+          "releaseTag": "Public",
+          "isAbstract": false,
+          "name": "ObserverMap",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "Constructor",
+              "canonicalReference": "@microsoft/fast-html!ObserverMap:constructor(1)",
+              "docComment": "/**\n * Constructs a new instance of the `ObserverMap` class\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "constructor(classPrototype: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "any"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", schema: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Schema",
+                  "canonicalReference": "@microsoft/fast-html!~Schema:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ");"
+                }
+              ],
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "classPrototype",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "schema",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ]
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@microsoft/fast-html!ObserverMap#defineProperties:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "defineProperties(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "defineProperties"
+            }
+          ],
+          "implementsTokenRanges": []
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@microsoft/fast-html!RenderableFASTElement:function(1)",
+          "docComment": "/**\n * A mixin function that extends a base class with additional functionality for rendering and hydration.\n *\n * @param BaseCtor - The base class to extend.\n *\n * @returns A new class that extends the provided base class with additional functionality for rendering and hydration.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function RenderableFASTElement<T extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "Constructable",
+              "canonicalReference": "@microsoft/fast-element!Constructable:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "FASTElement",
+              "canonicalReference": "@microsoft/fast-element!FASTElement:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": ">(BaseCtor: "
+            },
+            {
+              "kind": "Content",
+              "text": "T"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "T"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/dts/components/element.d.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 8,
+            "endIndex": 9
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "BaseCtor",
+              "parameterTypeTokenRange": {
+                "startIndex": 6,
+                "endIndex": 7
+              },
+              "isOptional": false
+            }
+          ],
+          "typeParameters": [
+            {
+              "typeParameterName": "T",
+              "constraintTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              }
+            }
+          ],
+          "name": "RenderableFASTElement"
+        },
         {
           "kind": "Class",
           "canonicalReference": "@microsoft/fast-html!TemplateElement:class",
@@ -197,6 +392,75 @@
           "name": "TemplateElement",
           "preserveMemberOrder": false,
           "members": [
+            {
+              "kind": "Constructor",
+              "canonicalReference": "@microsoft/fast-html!TemplateElement:constructor(1)",
+              "docComment": "/**\n * Constructs a new instance of the `TemplateElement` class\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "constructor();"
+                }
+              ],
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": []
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@microsoft/fast-html!TemplateElement.config:member(1)",
+              "docComment": "/**\n * Configure lifecycle callbacks for hydration events.\n *\n * @param callbacks - Lifecycle callbacks to configure.\n *\n * @returns The {@link TemplateElement} class.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "static config(callbacks: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HydrationLifecycleCallbacks",
+                  "canonicalReference": "@microsoft/fast-html!~HydrationLifecycleCallbacks:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "typeof "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "TemplateElement",
+                  "canonicalReference": "@microsoft/fast-html!TemplateElement:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": true,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "callbacks",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "config"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@microsoft/fast-html!TemplateElement#connectedCallback:member(1)",
@@ -228,6 +492,37 @@
               "isAbstract": false,
               "name": "connectedCallback"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@microsoft/fast-html!TemplateElement.elementOptions:member",
+              "docComment": "/**\n * A dictionary of custom element options\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "static elementOptions: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ElementOptionsDictionary",
+                  "canonicalReference": "@microsoft/fast-html!~ElementOptionsDictionary:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "elementOptions",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": true,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@microsoft/fast-html!TemplateElement#name:member",
@@ -257,6 +552,60 @@
               "isStatic": false,
               "isProtected": false,
               "isAbstract": false
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@microsoft/fast-html!TemplateElement.options:member(1)",
+              "docComment": "/**\n * Set options for custom elements.\n *\n * @param elementOptions - A dictionary of custom element options\n *\n * @returns The TemplateElement class.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "static options(elementOptions?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ElementOptionsDictionary",
+                  "canonicalReference": "@microsoft/fast-html!~ElementOptionsDictionary:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "typeof "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "TemplateElement",
+                  "canonicalReference": "@microsoft/fast-html!TemplateElement:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": true,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "elementOptions",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "options"
             }
           ],
           "extendsTokenRange": {