@lushly-dev/fast-element 3.0.1-preview.1 → 3.0.1-preview.2

package/dist/declarative/declarative.api.json

@@ -1,7 +1,7 @@
 {
   "metadata": {
     "toolPackage": "@microsoft/api-extractor",
-    "toolVersion": "7.58.1",
+    "toolVersion": "7.60.1",
     "schemaVersion": 1011,
     "oldestForwardsCompatibleVersion": 1001,
     "tsdocConfig": {
@@ -482,7 +482,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@lushly-dev/fast-element!AttributeDefinition:class",
-          "docComment": "/**\n * An implementation of {@link Accessor} that supports reactivity, change callbacks, attribute reflection, and type conversion for custom elements.\n *\n * @public\n */\n",
+          "docComment": "/**\n * An implementation of {@link Accessor} that supports reactivity,\n * change callbacks, attribute reflection, and type conversion for\n * custom elements.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -507,7 +507,7 @@
             {
               "kind": "Constructor",
               "canonicalReference": "@lushly-dev/fast-element!AttributeDefinition:constructor(1)",
-              "docComment": "/**\n * Creates an instance of AttributeDefinition.\n *\n * @param Owner - The class constructor that owns this attribute.\n *\n * @param name - The name of the property associated with the attribute.\n *\n * @param attribute - The name of the attribute in HTML.\n *\n * @param mode - The {@link AttributeMode} that describes the behavior of this attribute.\n *\n * @param converter - A {@link ValueConverter} that integrates with the property getter/setter to convert values to and from a DOM string.\n */\n",
+              "docComment": "/**\n * Creates an instance of AttributeDefinition.\n *\n * @param Owner - The class constructor that owns this attribute.\n *\n * @param name - The name of the property associated with the attribute.\n *\n * @param attribute - The name of the attribute in HTML.\n *\n * @param mode - The {@link AttributeMode} that describes the behavior of this attribute.\n *\n * @param converter - A {@link ValueConverter} that integrates with the property getter/setter\n * to convert values to and from a DOM string.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -636,7 +636,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@lushly-dev/fast-element!AttributeDefinition#converter:member",
-              "docComment": "/**\n * A {@link ValueConverter} that integrates with the property getter/setter to convert values to and from a DOM string.\n */\n",
+              "docComment": "/**\n * A {@link ValueConverter} that integrates with the property getter/setter\n * to convert values to and from a DOM string.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -881,7 +881,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@lushly-dev/fast-element!AttributeMode:type",
-          "docComment": "/**\n * The mode that specifies the runtime behavior of the attribute.\n *\n * @remarks\n *\n * By default, attributes run in `reflect` mode, propagating their property values to the DOM and DOM values to the property. The `boolean` mode also reflects values, but uses the HTML standard boolean attribute behavior, interpreting the presence of the attribute as `true` and the absence as `false`. The `fromView` behavior only updates the property value based on changes in the DOM, but does not reflect property changes back.\n *\n * @public\n */\n",
+          "docComment": "/**\n * The mode that specifies the runtime behavior of the attribute.\n *\n * @remarks\n *\n * By default, attributes run in `reflect` mode, propagating their property\n * values to the DOM and DOM values to the property. The `boolean` mode also\n * reflects values, but uses the HTML standard boolean attribute behavior,\n * interpreting the presence of the attribute as `true` and the absence as\n * `false`. The `fromView` behavior only updates the property value based on\n * changes in the DOM, but does not reflect property changes back.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1109,7 +1109,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!CaptureType:interface",
-          "docComment": "/**\n * A marker interface used to capture types when interpolating Directive helpers into templates.\n *\n * @public\n */\n",
+          "docComment": "/**\n * A marker interface used to capture types when interpolating Directive helpers\n * into templates.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1369,7 +1369,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!declarativeTemplate:function(1)",
-          "docComment": "/**\n * Returns a declarative template resolver that waits for the matching `<f-template>` element and resolves it into a concrete `ViewTemplate`.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Returns a declarative template resolver that waits for the matching\n * `<f-template>` element and resolves it into a concrete `ViewTemplate`.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2771,7 +2771,7 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@lushly-dev/fast-element!ElementViewTemplate#create:member(1)",
-              "docComment": "/**\n * Creates an ElementView instance based on this template definition.\n *\n * @param hostBindingTarget - The element that host behaviors will be bound to.\n *\n * @param scope - The shadow root whose scoped custom element registry child elements should be created against, when it has one.\n */\n",
+              "docComment": "/**\n * Creates an ElementView instance based on this template definition.\n *\n * @param hostBindingTarget - The element that host behaviors will be bound to.\n *\n * @param scope - The shadow root whose scoped custom element registry child\n * elements should be created against, when it has one.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -2839,7 +2839,7 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@lushly-dev/fast-element!ElementViewTemplate#render:member(1)",
-              "docComment": "/**\n * Creates an HTMLView from this template, binds it to the source, and then appends it to the host.\n *\n * @param source - The data source to bind the template to.\n *\n * @param host - The Element where the template will be rendered.\n *\n * @param hostBindingTarget - An HTML element to target the host bindings at if different from the host that the template is being attached to.\n *\n * @param scope - The shadow root whose scoped custom element registry child elements should be created against, when it has one.\n */\n",
+              "docComment": "/**\n * Creates an HTMLView from this template, binds it to the source, and then appends it to the host.\n *\n * @param source - The data source to bind the template to.\n *\n * @param host - The Element where the template will be rendered.\n *\n * @param hostBindingTarget - An HTML element to target the host bindings at if different from the\n * host that the template is being attached to.\n *\n * @param scope - The shadow root whose scoped custom element registry child\n * elements should be created against, when it has one.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -3163,7 +3163,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!FASTElementDefinition.compose:member(1)",
-              "docComment": "/**\n * Creates an instance of FASTElementDefinition.\n *\n * @param type - The type this definition is being created for.\n *\n * @param nameOrDef - The name of the element to define or a config object that describes the element to define.\n */\n",
+              "docComment": "/**\n * Creates an instance of FASTElementDefinition.\n *\n * @param type - The type this definition is being created for.\n *\n * @param nameOrDef - The name of the element to define or a config object\n * that describes the element to define.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -3307,7 +3307,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!FASTElementDefinition#define:member(1)",
-              "docComment": "/**\n * Defines a custom element based on this definition.\n *\n * @remarks\n *\n * This operation is idempotent per registry.\n *\n * @param registry - The element registry to define the element in.\n *\n * @param extensions - An optional array of extension callbacks to invoke with this definition before platform registration.\n */\n",
+              "docComment": "/**\n * Defines a custom element based on this definition.\n *\n * @remarks\n *\n * This operation is idempotent per registry.\n *\n * @param registry - The element registry to define the element in.\n *\n * @param extensions - An optional array of extension callbacks to invoke\n * with this definition before platform registration.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -3666,7 +3666,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@lushly-dev/fast-element!FASTElementDefinition#schema:member",
-              "docComment": "/**\n * The optional schema associated with the custom element definition. Declarative templates assign this automatically during template resolution. Non-declarative callers can provide one for schema-driven extensions.\n */\n",
+              "docComment": "/**\n * The optional schema associated with the custom element definition.\n * Declarative templates assign this automatically during template resolution.\n * Non-declarative callers can provide one for schema-driven extensions.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -3836,7 +3836,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@lushly-dev/fast-element!FASTElementExtension:type",
-          "docComment": "/**\n * A callback that receives a FASTElementDefinition during element registration. Extensions are invoked before the element is registered with the platform, allowing plugins to inspect or act on the resolved definition.\n *\n * @public\n */\n",
+          "docComment": "/**\n * A callback that receives a FASTElementDefinition during element registration.\n * Extensions are invoked before the element is registered with the platform,\n * allowing plugins to inspect or act on the resolved definition.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -4072,7 +4072,7 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@lushly-dev/fast-element!HTMLTemplateCompilationResult#createView:member(1)",
-              "docComment": "/**\n * Creates a view instance.\n *\n * @param hostBindingTarget - The host binding target for the view.\n *\n * @param scope - The shadow root whose scoped custom element registry the view's elements should be created against, when it has one.\n */\n",
+              "docComment": "/**\n * Creates a view instance.\n *\n * @param hostBindingTarget - The host binding target for the view.\n *\n * @param scope - The shadow root whose scoped custom element registry the view's\n * elements should be created against, when it has one.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4433,7 +4433,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!HTMLView#bind:member(1)",
-              "docComment": "/**\n * Binds a view's behaviors to its binding source.\n *\n * On the first call, this iterates through all compiled factories, calling createBehavior() on each to produce a ViewBehavior instance (e.g., an HTMLBindingDirective), and then immediately binds it. This is where event listeners are registered, expression observers are created, and initial DOM values are set.\n *\n * On subsequent calls with a new source, existing behaviors are re-bound to the new data source, which re-evaluates all binding expressions and updates the DOM accordingly.\n *\n * @param source - The binding source for the view's binding behaviors.\n *\n * @param context - The execution context to run the behaviors within.\n */\n",
+              "docComment": "/**\n * Binds a view's behaviors to its binding source.\n *\n * On the first call, this iterates through all compiled factories, calling\n * createBehavior() on each to produce a ViewBehavior instance (e.g., an\n * HTMLBindingDirective), and then immediately binds it. This is where event\n * listeners are registered, expression observers are created, and initial\n * DOM values are set.\n *\n * On subsequent calls with a new source, existing behaviors are re-bound\n * to the new data source, which re-evaluates all binding expressions and\n * updates the DOM accordingly.\n *\n * @param source - The binding source for the view's binding behaviors.\n *\n * @param context - The execution context to run the behaviors within.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4537,7 +4537,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!HTMLView#dispose:member(1)",
-              "docComment": "/**\n * Removes the view and unbinds its behaviors, disposing of DOM nodes afterward. Once a view has been disposed, it cannot be inserted or bound again.\n */\n",
+              "docComment": "/**\n * Removes the view and unbinds its behaviors, disposing of DOM nodes afterward.\n * Once a view has been disposed, it cannot be inserted or bound again.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4731,7 +4731,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@lushly-dev/fast-element!HTMLView#isHydrated:member",
-              "docComment": "/**\n * Resolves `true` after prerendered content has been hydrated, `false` when client-side rendered or hydration not enabled.\n */\n",
+              "docComment": "/**\n * Resolves `true` after prerendered content has been hydrated,\n * `false` when client-side rendered or hydration not enabled.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4766,7 +4766,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@lushly-dev/fast-element!HTMLView#isPrerendered:member",
-              "docComment": "/**\n * A promise that resolves with `true` after prerendered content has been hydrated, or `false` when the view is client-side rendered. Resolves once the first bind completes.\n */\n",
+              "docComment": "/**\n * A promise that resolves with `true` after prerendered content\n * has been hydrated, or `false` when the view is client-side\n * rendered. Resolves once the first bind completes.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4889,7 +4889,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!HTMLView#remove:member(1)",
-              "docComment": "/**\n * Removes the view's DOM nodes. The nodes are not disposed and the view can later be re-inserted.\n */\n",
+              "docComment": "/**\n * Removes the view's DOM nodes.\n * The nodes are not disposed and the view can later be re-inserted.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -5205,7 +5205,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@lushly-dev/fast-element!JSONSchemaCommon#$observe:member",
-              "docComment": "/**\n * Stamped by `applyConfigToSchema` when an `ObserverMapConfig` excludes this path. When `false`, the proxy system skips observation for this node and (if all descendants are also `false`) its subtree.\n */\n",
+              "docComment": "/**\n * Stamped by `applyConfigToSchema` when an `ObserverMapConfig` excludes\n * this path. When `false`, the proxy system skips observation for this\n * node and (if all descendants are also `false`) its subtree.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -5657,7 +5657,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@lushly-dev/fast-element!PartialFASTElementDefinition#schema:member",
-              "docComment": "/**\n * The optional schema associated with the custom element definition. Declarative templates assign this automatically during template resolution. Non-declarative callers can provide one for schema-driven extensions.\n */\n",
+              "docComment": "/**\n * The optional schema associated with the custom element definition.\n * Declarative templates assign this automatically during template resolution.\n * Non-declarative callers can provide one for schema-driven extensions.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -5685,7 +5685,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@lushly-dev/fast-element!PartialFASTElementDefinition#shadowOptions:member",
-              "docComment": "/**\n * Options controlling the creation of the custom element's shadow DOM.\n *\n * @remarks\n *\n * If not provided, defaults to an open shadow root. Provide null to render to the associated template to the light DOM instead.\n */\n",
+              "docComment": "/**\n * Options controlling the creation of the custom element's shadow DOM.\n *\n * @remarks\n *\n * If not provided, defaults to an open shadow root. Provide null\n * to render to the associated template to the light DOM instead.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -6255,7 +6255,7 @@
         {
           "kind": "Variable",
           "canonicalReference": "@lushly-dev/fast-element!schemaRegistry:var",
-          "docComment": "/**\n * Module-level registry that maps custom element names to their schema maps. Used for cross-element `$ref` resolution (e.g. nested element schemas). Each Schema instance registers itself here on construction.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Module-level registry that maps custom element names to their schema maps.\n * Used for cross-element `$ref` resolution (e.g. nested element schemas).\n * Each Schema instance registers itself here on construction.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -6303,7 +6303,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@lushly-dev/fast-element!ShadowRootOptions#registry:member",
-              "docComment": "/**\n * A registry that provides the custom elements visible from within this shadow root.\n *\n * @beta\n */\n",
+              "docComment": "/**\n * A registry that provides the custom elements visible\n * from within this shadow root.\n *\n * @beta\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -6339,7 +6339,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!StyleStrategy:interface",
-          "docComment": "/**\n * Implemented to provide specific behavior when adding/removing styles for elements.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Implemented to provide specific behavior when adding/removing styles\n * for elements.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -6823,7 +6823,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@lushly-dev/fast-element!TemplateParser:class",
-          "docComment": "/**\n * Converts declarative HTML template markup into the `strings` and `values` arrays that `ViewTemplate.create()` consumes.\n *\n * This class is intentionally stateless across invocations — all mutable parsing state lives on the call stack or in the `TemplateResolutionContext`.\n *\n * The parsing pipeline is fully synchronous — no promises are allocated during template resolution.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Converts declarative HTML template markup into the `strings` and `values`\n * arrays that `ViewTemplate.create()` consumes.\n *\n * This class is intentionally stateless across invocations — all mutable\n * parsing state lives on the call stack or in the `TemplateResolutionContext`.\n *\n * The parsing pipeline is fully synchronous — no promises are allocated\n * during template resolution.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -7103,7 +7103,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!ValueConverter:interface",
-          "docComment": "/**\n * Represents objects that can convert values to and from view or model representations.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Represents objects that can convert values to and from\n * view or model representations.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -7319,7 +7319,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!ViewBehaviorFactory:interface",
-          "docComment": "/**\n * A factory that can create a {@link ViewBehavior} associated with a particular location within a DOM fragment.\n *\n * @public\n */\n",
+          "docComment": "/**\n * A factory that can create a {@link ViewBehavior} associated with a particular\n * location within a DOM fragment.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -7645,7 +7645,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!ViewTemplate#create:member(1)",
-              "docComment": "/**\n * Creates an HTMLView instance based on this template definition.\n *\n * @param hostBindingTarget - The element that host behaviors will be bound to.\n *\n * @param scope - The shadow root whose scoped custom element registry child elements should be created against, when it has one.\n */\n",
+              "docComment": "/**\n * Creates an HTMLView instance based on this template definition.\n *\n * @param hostBindingTarget - The element that host behaviors will be bound to.\n *\n * @param scope - The shadow root whose scoped custom element registry child\n * elements should be created against, when it has one.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7716,7 +7716,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!ViewTemplate.create:member(1)",
-              "docComment": "/**\n * Processes the tagged template literal's static strings and interpolated values and creates a ViewTemplate.\n *\n * For each interpolated value: 1. Functions (binding expressions, e.g., `x => x.name`) → wrapped in a one-way HTMLBindingDirective 2. Binding instances → wrapped in an HTMLBindingDirective 3. HTMLDirective instances → used as-is 4. Static values (strings, numbers) → wrapped in a one-time HTMLBindingDirective\n *\n * Each directive's createHTML() is called with an `add` callback that registers the factory in the factories record under a unique ID and returns that ID. The directive inserts a placeholder marker (e.g., `fast-abc123{0}fast-abc123`) into the HTML string so the compiler can later find and associate it with the factory.\n *\n * Aspect detection happens here too: the `lastAttributeNameRegex` checks whether the placeholder appears inside an attribute value, and if so, assignAspect() sets the correct DOMAspect (attribute, property, event, etc.) based on the attribute name prefix.\n *\n * @remarks\n *\n * This API should not be used directly under normal circumstances because constructing a template in this way, if not done properly, can open up the application to XSS attacks. When using this API, provide a strong DOMPolicy that can properly sanitize and also be sure to manually sanitize all static strings particularly if they can come from user input.\n *\n * @param strings - The static strings to create the template with.\n *\n * @param values - The dynamic values to create the template with.\n *\n * @param policy - The DOMPolicy to associated with the template.\n *\n * @returns A ViewTemplate.\n */\n",
+              "docComment": "/**\n * Processes the tagged template literal's static strings and interpolated values and\n * creates a ViewTemplate.\n *\n * For each interpolated value:\n * 1. Functions (binding expressions, e.g., `x => x.name`) → wrapped in a one-way HTMLBindingDirective\n * 2. Binding instances → wrapped in an HTMLBindingDirective\n * 3. HTMLDirective instances → used as-is\n * 4. Static values (strings, numbers) → wrapped in a one-time HTMLBindingDirective\n *\n * Each directive's createHTML() is called with an `add` callback that registers\n * the factory in the factories record under a unique ID and returns that ID.\n * The directive inserts a placeholder marker (e.g., `fast-abc123{0}fast-abc123`) into\n * the HTML string so the compiler can later find and associate it with the factory.\n *\n * Aspect detection happens here too: the `lastAttributeNameRegex` checks whether\n * the placeholder appears inside an attribute value, and if so, assignAspect()\n * sets the correct DOMAspect (attribute, property, event, etc.) based on the\n * attribute name prefix.\n *\n * @remarks\n *\n * This API should not be used directly under normal circumstances because constructing\n * a template in this way, if not done properly, can open up the application to XSS\n * attacks. When using this API, provide a strong DOMPolicy that can properly sanitize\n * and also be sure to manually sanitize all static strings particularly if they can\n * come from user input.\n *\n * @param strings - The static strings to create the template with.\n *\n * @param values - The dynamic values to create the template with.\n *\n * @param policy - The DOMPolicy to associated with the template.\n *\n * @returns A ViewTemplate.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7891,7 +7891,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@lushly-dev/fast-element!ViewTemplate#html:member",
-              "docComment": "/**\n * The html representing what this template will instantiate, including placeholders for directives.\n */\n",
+              "docComment": "/**\n * The html representing what this template will\n * instantiate, including placeholders for directives.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7962,7 +7962,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!ViewTemplate#render:member(1)",
-              "docComment": "/**\n * Creates an HTMLView from this template, binds it to the source, and then appends it to the host.\n *\n * @param source - The data source to bind the template to.\n *\n * @param host - The Element where the template will be rendered.\n *\n * @param hostBindingTarget - An HTML element to target the host bindings at if different from the host that the template is being attached to.\n *\n * @param scope - The shadow root whose scoped custom element registry child elements should be created against, when it has one.\n */\n",
+              "docComment": "/**\n * Creates an HTMLView from this template, binds it to the source, and then appends it to the host.\n *\n * @param source - The data source to bind the template to.\n *\n * @param host - The Element where the template will be rendered.\n *\n * @param hostBindingTarget - An HTML element to target the host bindings at if different from the\n * host that the template is being attached to.\n *\n * @param scope - The shadow root whose scoped custom element registry child\n * elements should be created against, when it has one.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -8066,7 +8066,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!ViewTemplate#withPolicy:member(1)",
-              "docComment": "/**\n * Sets the DOMPolicy for this template.\n *\n * @remarks\n *\n * The DOMPolicy can only be set once for a template and cannot be set after the template is compiled.\n *\n * @param policy - The policy to associated with this template.\n *\n * @returns The modified template instance.\n */\n",
+              "docComment": "/**\n * Sets the DOMPolicy for this template.\n *\n * @remarks\n *\n * The DOMPolicy can only be set once for a template and cannot be\n * set after the template is compiled.\n *\n * @param policy - The policy to associated with this template.\n *\n * @returns The modified template instance.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",

package/dist/definition-schema/definition-schema.api.json

@@ -1,7 +1,7 @@
 {
   "metadata": {
     "toolPackage": "@microsoft/api-extractor",
-    "toolVersion": "7.58.1",
+    "toolVersion": "7.60.1",
     "schemaVersion": 1011,
     "oldestForwardsCompatibleVersion": 1001,
     "tsdocConfig": {
@@ -452,7 +452,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!CommandSchema:interface",
-          "docComment": "/**\n * Schema describing a command palette action. Populated by the `command` decorator during schema extraction.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Schema describing a command palette action.\n * Populated by the `command` decorator during schema extraction.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1180,7 +1180,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!diffSchemas:function(1)",
-          "docComment": "/**\n * Compares two component schemas and returns the differences. Used to detect breaking changes between versions.\n *\n * @param a - The original schema (before).\n *\n * @param b - The new schema (after).\n *\n * @returns A SchemaDiff object describing the changes.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Compares two component schemas and returns the differences.\n * Used to detect breaking changes between versions.\n *\n * @param a - The original schema (before).\n *\n * @param b - The new schema (after).\n *\n * @returns A SchemaDiff object describing the changes.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1272,7 +1272,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!enableDefinitionSchema:function(1)",
-          "docComment": "/**\n * Enables automatic Definition Schema extraction for subsequently defined FAST elements. Call this before element definitions are registered.\n *\n * @returns A callback that disables automatic extraction.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Enables automatic Definition Schema extraction for subsequently defined FAST elements.\n * Call this before element definitions are registered.\n *\n * @returns A callback that disables automatic extraction.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2288,7 +2288,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!SchemaDiff:interface",
-          "docComment": "/**\n * Represents the difference between two component schemas. Used to detect breaking changes between versions.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Represents the difference between two component schemas.\n * Used to detect breaking changes between versions.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2594,7 +2594,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!toCustomElementsManifest:function(1)",
-          "docComment": "/**\n * Generates a Custom Elements Manifest (CEM 2.1.0) from registered schemas.\n *\n * @remarks\n *\n * The manifest groups each component into its own module with a synthesized path based on the tag name (e.g., `my-button.js`). This is suitable for documentation and tooling purposes but may not reflect actual file paths.\n *\n * @param registry - The custom element registry to export from (defaults to global customElements).\n *\n * @returns A Custom Elements Manifest object conforming to CEM 2.1.0 schema.\n *\n * @example\n * ```typescript\n * const manifest = toCustomElementsManifest();\n * console.log(JSON.stringify(manifest, null, 2));\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * Generates a Custom Elements Manifest (CEM 2.1.0) from registered schemas.\n *\n * @remarks\n *\n * The manifest groups each component into its own module with a synthesized path\n * based on the tag name (e.g., `my-button.js`). This is suitable for documentation\n * and tooling purposes but may not reflect actual file paths.\n *\n * @param registry - The custom element registry to export from (defaults to global customElements).\n *\n * @returns A Custom Elements Manifest object conforming to CEM 2.1.0 schema.\n *\n * @example\n * ```typescript\n * const manifest = toCustomElementsManifest();\n * console.log(JSON.stringify(manifest, null, 2));\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2641,7 +2641,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!toPascalCase:function(1)",
-          "docComment": "/**\n * Converts a kebab-case string to PascalCase.\n *\n * @param str - The kebab-case string to convert.\n *\n * @returns The PascalCase version of the string.\n *\n * @example\n *\n * toPascalCase('my-button') // 'MyButton' toPascalCase('my-cool-element') // 'MyCoolElement'\n *\n * @public\n */\n",
+          "docComment": "/**\n * Converts a kebab-case string to PascalCase.\n *\n * @param str - The kebab-case string to convert.\n *\n * @returns The PascalCase version of the string.\n *\n * @example\n *\n * toPascalCase('my-button') // 'MyButton'\n * toPascalCase('my-cool-element') // 'MyCoolElement'\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",