@microsoft/fast-element 2.9.1 → 2.10.0

package/CHANGELOG.json

@@ -1,6 +1,64 @@
 {
   "name": "@microsoft/fast-element",
   "entries": [
+    {
+      "date": "Tue, 17 Feb 2026 20:49:29 GMT",
+      "version": "2.10.0",
+      "tag": "@microsoft/fast-element_v2.10.0",
+      "comments": {
+        "patch": [
+          {
+            "author": "863023+radium-v@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "4176d0cb01260e6c5d03c53351eb9be0d2736b90",
+            "comment": "chore: enable verbatimModuleSyntax to identify type-only imports and exports"
+          }
+        ],
+        "none": [
+          {
+            "author": "863023+radium-v@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "65f87c8f1fff03011d77f8159bae96e0f3fe9fce",
+            "comment": "chore: remove benchmark scripts and related utilities from fast-element package"
+          },
+          {
+            "author": "machi@microsoft.com",
+            "package": "@microsoft/fast-element",
+            "commit": "b5ed37b3aa98bc37430f2ba5cd47de3768066a3a",
+            "comment": "introduce playwright for testing"
+          }
+        ],
+        "minor": [
+          {
+            "author": "863023+radium-v@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "350bb02ec3c35f7b354314dd9e4dfb614c335723",
+            "comment": "feat: pass source element to hydration lifecycle callbacks"
+          },
+          {
+            "author": "863023+radium-v@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "57ef1a5495298ad3aadc6b74c95b10bbdbdde3ca",
+            "comment": "feat(hydration): add hydrationStarted callback and update documentation"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Tue, 27 Jan 2026 17:28:54 GMT",
+      "version": "2.9.2",
+      "tag": "@microsoft/fast-element_v2.9.2",
+      "comments": {
+        "patch": [
+          {
+            "author": "863023+radium-v@users.noreply.github.com",
+            "package": "@microsoft/fast-element",
+            "commit": "d1cd327a6d37cea742b1b1df48f807fe9a1da4f7",
+            "comment": "chore: hoist devDependencies"
+          }
+        ]
+      }
+    },
     {
       "date": "Tue, 16 Dec 2025 21:27:19 GMT",
       "version": "2.9.1",

package/CHANGELOG.md

@@ -1,9 +1,30 @@
 # Change Log - @microsoft/fast-element
 
-<!-- This log was last generated on Tue, 16 Dec 2025 21:27:19 GMT and should not be manually modified. -->
+<!-- This log was last generated on Tue, 17 Feb 2026 20:49:29 GMT and should not be manually modified. -->
 
 <!-- Start content -->
 
+## 2.10.0
+
+Tue, 17 Feb 2026 20:49:29 GMT
+
+### Minor changes
+
+- feat: pass source element to hydration lifecycle callbacks (863023+radium-v@users.noreply.github.com)
+- feat(hydration): add hydrationStarted callback and update documentation (863023+radium-v@users.noreply.github.com)
+
+### Patches
+
+- chore: enable verbatimModuleSyntax to identify type-only imports and exports (863023+radium-v@users.noreply.github.com)
+
+## 2.9.2
+
+Tue, 27 Jan 2026 17:28:54 GMT
+
+### Patches
+
+- chore: hoist devDependencies (863023+radium-v@users.noreply.github.com)
+
 ## 2.9.1
 
 Tue, 16 Dec 2025 21:27:19 GMT

package/dist/context/context.api.json

@@ -179,7 +179,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type Context<T> = "
+              "text": "export type Context<T> = "
             },
             {
               "kind": "Content",
@@ -462,7 +462,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type ContextCallback<ValueType> = "
+              "text": "export type ContextCallback<ValueType> = "
             },
             {
               "kind": "Content",
@@ -501,7 +501,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type ContextDecorator<T = "
+              "text": "export type ContextDecorator<T = "
             },
             {
               "kind": "Content",
@@ -812,7 +812,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type ContextType<T extends "
+              "text": "export type ContextType<T extends "
             },
             {
               "kind": "Reference",
@@ -869,7 +869,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type FASTContext<T> = "
+              "text": "export type FASTContext<T> = "
             },
             {
               "kind": "Reference",
@@ -976,7 +976,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type FASTContextRequestStrategy = "
+              "text": "export type FASTContextRequestStrategy = "
             },
             {
               "kind": "Content",
@@ -1038,7 +1038,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type UnknownContext = "
+              "text": "export type UnknownContext = "
             },
             {
               "kind": "Reference",

package/dist/di/di.api.json

@@ -250,7 +250,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type AsyncRegistrationLocator = "
+              "text": "export type AsyncRegistrationLocator = "
             },
             {
               "kind": "Content",
@@ -1487,7 +1487,7 @@
             },
             {
               "kind": "Content",
-              "text": "<{}>>(target: T & "
+              "text": ">(target: T & "
             },
             {
               "kind": "Reference",
@@ -1523,7 +1523,7 @@
             },
             {
               "kind": "Content",
-              "text": "<{}>>(target: T_1 & "
+              "text": ">(target: T_1 & "
             },
             {
               "kind": "Reference",
@@ -2108,7 +2108,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type Injectable<T = "
+              "text": "export type Injectable<T = "
             },
             {
               "kind": "Content",
@@ -2241,7 +2241,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type Key = "
+              "text": "export type Key = "
             },
             {
               "kind": "Reference",
@@ -2459,7 +2459,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type ParentLocator = "
+              "text": "export type ParentLocator = "
             },
             {
               "kind": "Content",
@@ -2494,7 +2494,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type RegisterSelf<T extends "
+              "text": "export type RegisterSelf<T extends "
             },
             {
               "kind": "Reference",
@@ -2695,7 +2695,7 @@
             },
             {
               "kind": "Content",
-              "text": "<{}>>(key: "
+              "text": ">(key: "
             },
             {
               "kind": "Reference",
@@ -2731,7 +2731,7 @@
             },
             {
               "kind": "Content",
-              "text": "<{}>>(key: "
+              "text": ">(key: "
             },
             {
               "kind": "Reference",
@@ -2961,7 +2961,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type ResolveCallback<T = "
+              "text": "export type ResolveCallback<T = "
             },
             {
               "kind": "Content",
@@ -3035,7 +3035,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type Resolved<K> = "
+              "text": "export type Resolved<K> = "
             },
             {
               "kind": "Content",
@@ -4724,7 +4724,7 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare type Transformer<K> = "
+              "text": "export type Transformer<K> = "
             },
             {
               "kind": "Content",

package/dist/dts/binding/one-way.d.ts

@@ -1,5 +1,5 @@
 import type { DOMPolicy } from "../dom.js";
-import { Expression } from "../observation/observable.js";
+import { type Expression } from "../observation/observable.js";
 import { Binding } from "./binding.js";
 /**
  * Creates an standard binding.

package/dist/dts/binding/two-way.d.ts

@@ -1,11 +1,11 @@
 import type { DOMPolicy } from "../dom.js";
-import { Expression } from "../observation/observable.js";
-import { Binding, BindingDirective } from "./binding.js";
+import { type Expression } from "../observation/observable.js";
+import { Binding, type BindingDirective } from "./binding.js";
 /**
  * The twoWay binding options.
  * @public
  */
-export declare type TwoWayBindingOptions = {
+export type TwoWayBindingOptions = {
     changeEvent?: string;
     fromView?: (value: any) => any;
 };

package/dist/dts/components/attributes.d.ts

@@ -1,4 +1,4 @@
-import { Accessor } from "../observation/observable.js";
+import { type Accessor } from "../observation/observable.js";
 /**
  * Represents objects that can convert values to and from
  * view or model representations.
@@ -29,12 +29,12 @@ declare const reflectMode = "reflect";
  * changes in the DOM, but does not reflect property changes back.
  * @public
  */
-export declare type AttributeMode = typeof reflectMode | typeof booleanMode | "fromView";
+export type AttributeMode = typeof reflectMode | typeof booleanMode | "fromView";
 /**
  * Metadata used to configure a custom attribute's behavior.
  * @public
  */
-export declare type AttributeConfiguration = {
+export type AttributeConfiguration = {
     property: string;
     attribute?: string;
     mode?: AttributeMode;
@@ -54,7 +54,7 @@ export declare const AttributeConfiguration: Readonly<{
  * Metadata used to configure a custom attribute's behavior through a decorator.
  * @public
  */
-export declare type DecoratorAttributeConfiguration = Omit<AttributeConfiguration, "property">;
+export type DecoratorAttributeConfiguration = Omit<AttributeConfiguration, "property">;
 /**
  * A {@link ValueConverter} that converts to and from `boolean` values.
  * @remarks

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

@@ -1,11 +1,11 @@
 import { PropertyChangeNotifier } from "../observation/notifier.js";
-import { ExecutionContext, ExpressionController, SourceLifetime } from "../observation/observable.js";
+import { ExecutionContext, type ExpressionController, SourceLifetime } from "../observation/observable.js";
 import { ElementStyles } from "../styles/element-styles.js";
 import type { HostBehavior, HostController } from "../styles/host.js";
 import type { StyleStrategy, StyleTarget } from "../styles/style-strategy.js";
 import type { ElementViewTemplate } from "../templating/template.js";
 import type { ElementView } from "../templating/view.js";
-import { FASTElementDefinition, ShadowRootOptions } from "./fast-definitions.js";
+import { FASTElementDefinition, type ShadowRootOptions } from "./fast-definitions.js";
 /**
  * @deprecated Use the export from ./hydration.js instead.
  */
@@ -269,15 +269,22 @@ export declare const needsHydrationAttribute = "needs-hydration";
  * Lifecycle callbacks for element hydration events
  * @public
  */
-export interface HydrationControllerCallbacks {
+export interface HydrationControllerCallbacks<TElement extends HTMLElement = HTMLElement> {
     /**
-     * Called before hydration has started
+     * Called once when the first element enters the hydration pipeline.
+     * This is the earliest point at which we know a component has been
+     * async-defined with `defer-and-hydrate`, a template is pending via
+     * `<f-template>`, and the element has `needs-hydration`.
      */
-    elementWillHydrate?(name: string): void;
+    hydrationStarted?(): void;
     /**
-     * Called after hydration has finished
+     * Called before an individual element's hydration begins
      */
-    elementDidHydrate?(name: string): void;
+    elementWillHydrate?(source: TElement): void;
+    /**
+     * Called after an individual element's hydration has finished
+     */
+    elementDidHydrate?(source: TElement): void;
     /**
      * Called after all elements have completed hydration
      */
@@ -305,7 +312,11 @@ export declare class HydratableElementController<TElement extends HTMLElement =
     /**
      * Lifecycle callbacks for hydration events
      */
-    static lifecycleCallbacks?: HydrationControllerCallbacks;
+    static lifecycleCallbacks: HydrationControllerCallbacks;
+    /**
+     * Whether the hydrationStarted callback has already been invoked.
+     */
+    private static hydrationStarted;
     /**
      * An idle callback ID used to track hydration completion
      */

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

@@ -1,6 +1,6 @@
-import { Constructable } from "../interfaces.js";
-import { TypeRegistry } from "../platform.js";
-import { ComposableStyles, ElementStyles } from "../styles/element-styles.js";
+import { type Constructable } from "../interfaces.js";
+import { type TypeRegistry } from "../platform.js";
+import { type ComposableStyles, ElementStyles } from "../styles/element-styles.js";
 import type { ElementViewTemplate } from "../templating/template.js";
 import { AttributeConfiguration, AttributeDefinition } from "./attributes.js";
 /**
@@ -8,7 +8,7 @@ import { AttributeConfiguration, AttributeDefinition } from "./attributes.js";
  * @internal
  */
 export declare const fastElementRegistry: TypeRegistry<FASTElementDefinition>;
-export { TypeRegistry };
+export type { TypeRegistry };
 /**
  * Shadow root initialization options.
  * @public
@@ -32,7 +32,7 @@ export declare const TemplateOptions: {
  * Type for the `TemplateOptions` const enum.
  * @alpha
  */
-export declare type TemplateOptions = (typeof TemplateOptions)[keyof typeof TemplateOptions];
+export type TemplateOptions = (typeof TemplateOptions)[keyof typeof TemplateOptions];
 /**
  * Lifecycle callbacks for template events.
  * @public

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

@@ -1,6 +1,6 @@
-import { Constructable } from "../interfaces.js";
+import { type Constructable } from "../interfaces.js";
 import { ElementController } from "./element-controller.js";
-import { FASTElementDefinition, PartialFASTElementDefinition } from "./fast-definitions.js";
+import { FASTElementDefinition, type PartialFASTElementDefinition } from "./fast-definitions.js";
 /**
  * Represents a custom element based on the FASTElement infrastructure.
  * @public

package/dist/dts/context.d.ts

@@ -1,9 +1,9 @@
-import { Constructable, ParameterDecorator } from "./interfaces.js";
+import { type Constructable, type ParameterDecorator } from "./interfaces.js";
 /**
  * A Context object defines an optional initial value for a Context, as well as a name identifier for debugging purposes.
  * @public
  */
-export declare type Context<T> = {
+export type Context<T> = {
     readonly name: string;
     readonly initialValue?: T;
 };
@@ -13,13 +13,13 @@ export declare type Context<T> = {
  * resolving the associated dependency.
  * @public
  */
-export declare type ContextDecorator<T = any> = Readonly<Context<T>> & PropertyDecorator & ParameterDecorator;
+export type ContextDecorator<T = any> = Readonly<Context<T>> & PropertyDecorator & ParameterDecorator;
 /**
  * A Context object defines an optional initial value for a Context, as well as a name identifier for debugging purposes.
  * The FASTContext can also be used as a decorator to declare context dependencies or as a key for DI.
  * @public
  */
-export declare type FASTContext<T> = ContextDecorator<T> & {
+export type FASTContext<T> = ContextDecorator<T> & {
     get(target: EventTarget): T;
     provide(target: EventTarget, value: T): void;
     request(target: EventTarget, callback: ContextCallback<T>, multiple?: boolean): void;
@@ -31,7 +31,7 @@ export declare type FASTContext<T> = ContextDecorator<T> & {
  * By default this is handled via Context.dispatch, which dispatches a ContextEvent.
  * @public
  */
-export declare type FASTContextRequestStrategy = <T extends UnknownContext>(target: EventTarget, context: T, callback: ContextCallback<ContextType<T>>, multiple: any) => void;
+export type FASTContextRequestStrategy = <T extends UnknownContext>(target: EventTarget, context: T, callback: ContextCallback<ContextType<T>>, multiple: any) => void;
 declare const contextEventType = "context-request";
 /**
  * Enables using:
@@ -130,18 +130,18 @@ export declare const Context: Readonly<{
  * An unknown context type.
  * @public
  */
-export declare type UnknownContext = Context<unknown>;
+export type UnknownContext = Context<unknown>;
 /**
  * A helper type which can extract a Context value type from a Context type
  * @public
  */
-export declare type ContextType<T extends UnknownContext> = T extends Context<infer Y> ? Y : never;
+export type ContextType<T extends UnknownContext> = T extends Context<infer Y> ? Y : never;
 /**
  * A callback which is provided by a context requester and is called with the value satisfying the request.
  * This callback can be called multiple times by context providers as the requested value is changed.
  * @public
  */
-export declare type ContextCallback<ValueType> = (value: ValueType, dispose?: () => void) => void;
+export type ContextCallback<ValueType> = (value: ValueType, dispose?: () => void) => void;
 /**
  * An event fired by a context requester to signal it desires a named context.
  *

package/dist/dts/di/di.d.ts

@@ -2,8 +2,8 @@
  * Big thanks to https://github.com/fkleuver and the https://github.com/aurelia/aurelia project
  * for the bulk of this code and many of the associated tests.
  */
-import { ContextDecorator } from "../context.js";
-import { Constructable } from "../interfaces.js";
+import { type ContextDecorator } from "../context.js";
+import { type Constructable } from "../interfaces.js";
 /**
  * Represents a custom callback for resolving a request from the container.
  * The handler is the container that is invoking the callback. The requestor
@@ -13,7 +13,7 @@ import { Constructable } from "../interfaces.js";
  * the callback needs a place or key against which to store state across resolutions.
  * @public
  */
-export declare type ResolveCallback<T = any> = (handler: Container, requestor: Container, resolver: Resolver<T>) => T;
+export type ResolveCallback<T = any> = (handler: Container, requestor: Container, resolver: Resolver<T>) => T;
 interface ResolverLike<C, K = any> {
     readonly $isResolver: true;
     resolve(handler: C, requestor: C): Resolved<K>;
@@ -47,7 +47,7 @@ export interface Registration<K = any> {
  * to the requestor.
  * @public
  */
-export declare type Transformer<K> = (instance: Resolved<K>) => Resolved<K>;
+export type Transformer<K> = (instance: Resolved<K>) => Resolved<K>;
 /**
  * Used by the default Resolver to create instances of objects when needed.
  * @public
@@ -274,7 +274,7 @@ export declare class ResolverBuilder<K> {
  * Represents an object that can register itself.
  * @public
  */
-export declare type RegisterSelf<T extends Constructable> = {
+export type RegisterSelf<T extends Constructable> = {
     /**
      * Registers itself with the container.
      * @param container - The container to register with.
@@ -290,18 +290,18 @@ export declare type RegisterSelf<T extends Constructable> = {
  * A key that is used to register dependencies with a dependency injection container.
  * @public
  */
-export declare type Key = PropertyKey | object | ContextDecorator | Constructable | Resolver;
+export type Key = PropertyKey | object | ContextDecorator | Constructable | Resolver;
 /**
  * Represents something resolved from a service locator.
  * @public
  */
-export declare type Resolved<K> = K extends ContextDecorator<infer T> ? T : K extends Constructable ? InstanceType<K> : K extends ResolverLike<any, infer T1> ? T1 extends Constructable ? InstanceType<T1> : T1 : K;
+export type Resolved<K> = K extends ContextDecorator<infer T> ? T : K extends Constructable ? InstanceType<K> : K extends ResolverLike<any, infer T1> ? T1 extends Constructable ? InstanceType<T1> : T1 : K;
 /**
  * A class that declares constructor injected dependencies through
  * a static "inject" field array of keys.
  * @public
  */
-export declare type Injectable<T = {}> = Constructable<T> & {
+export type Injectable<T = {}> = Constructable<T> & {
     inject?: Key[];
 };
 /**
@@ -310,12 +310,12 @@ export declare type Injectable<T = {}> = Constructable<T> & {
  * A container owner is usually an HTMLElement instance.
  * @public
  */
-export declare type ParentLocator = (owner: any) => Container | null;
+export type ParentLocator = (owner: any) => Container | null;
 /**
  * A function capable of asynchronously locating a resolver for a key.
  * @public
  */
-export declare type AsyncRegistrationLocator = (key: Key) => Promise<Registration | null>;
+export type AsyncRegistrationLocator = (key: Key) => Promise<Registration | null>;
 /**
  * Configuration for a dependency injection container.
  * @public
@@ -513,7 +513,7 @@ export declare const DI: Readonly<{
      *
      * @public
      */
-    transient<T extends Constructable<{}>>(target: T & Partial<RegisterSelf<T>>): T & RegisterSelf<T>;
+    transient<T extends Constructable>(target: T & Partial<RegisterSelf<T>>): T & RegisterSelf<T>;
     /**
      * Registers the `target` class as a singleton dependency; the class will only be created once. Each
      * consecutive time the dependency is resolved, the same instance will be returned.
@@ -537,7 +537,7 @@ export declare const DI: Readonly<{
      *
      * @public
      */
-    singleton<T_1 extends Constructable<{}>>(target: T_1 & Partial<RegisterSelf<T_1>>, options?: SingletonOptions): T_1 & RegisterSelf<T_1>;
+    singleton<T_1 extends Constructable>(target: T_1 & Partial<RegisterSelf<T_1>>, options?: SingletonOptions): T_1 & RegisterSelf<T_1>;
 }>;
 /**
  * The key that resolves the dependency injection Container itself.
@@ -596,7 +596,7 @@ export declare function transient<T extends Constructable>(): typeof transientDe
  * @public
  */
 export declare function transient<T extends Constructable>(target: T & Partial<RegisterSelf<T>>): T & RegisterSelf<T>;
-declare type SingletonOptions = {
+type SingletonOptions = {
     scoped: boolean;
 };
 declare function singletonDecorator<T extends Constructable>(target: T & Partial<RegisterSelf<T>>): T & RegisterSelf<T>;
@@ -827,7 +827,7 @@ export declare const Registration: Readonly<{
      * @param key - The key to register the singleton under.
      * @param value - The class to instantiate as a singleton when first requested.
      */
-    singleton<T_1 extends Constructable<{}>>(key: Key, value: T_1): Registration<InstanceType<T_1>>;
+    singleton<T_1 extends Constructable>(key: Key, value: T_1): Registration<InstanceType<T_1>>;
     /**
      * Creates an instance from a class.
      * Every time you request this {@link Key} you will get a new instance.
@@ -840,7 +840,7 @@ export declare const Registration: Readonly<{
      * @param key - The key to register the instance type under.
      * @param value - The class to instantiate each time the key is requested.
      */
-    transient<T_2 extends Constructable<{}>>(key: Key, value: T_2): Registration<InstanceType<T_2>>;
+    transient<T_2 extends Constructable>(key: Key, value: T_2): Registration<InstanceType<T_2>>;
     /**
      * Delegates to a callback function to provide the dependency.
      * Every time you request this {@link Key} the callback will be invoked to provide

package/dist/dts/dom-policy.d.ts

@@ -1,15 +1,15 @@
-import { DOMAspect, DOMPolicy, DOMSink } from "./dom.js";
-import { TrustedTypesPolicy } from "./interfaces.js";
+import { DOMAspect, type DOMSink, type DOMPolicy as IDOMPolicy } from "./dom.js";
+import { type TrustedTypesPolicy } from "./interfaces.js";
 /**
  * A specific DOM sink guard for a node aspect.
  * @public
  */
-export declare type DOMSinkGuards = Record<string, (tagName: string | null, aspect: DOMAspect, aspectName: string, sink: DOMSink) => DOMSink>;
+export type DOMSinkGuards = Record<string, (tagName: string | null, aspect: DOMAspect, aspectName: string, sink: DOMSink) => DOMSink>;
 /**
  * Aspect-specific guards for a DOM Policy.
  * @public
  */
-export declare type DOMAspectGuards = {
+export type DOMAspectGuards = {
     /**
      * Guards for attributes.
      */
@@ -39,12 +39,12 @@ export declare type DOMAspectGuards = {
  * Element-specific guards for a DOM Policy.
  * @public
  */
-export declare type DOMElementGuards = Record<string, DOMAspectGuards>;
+export type DOMElementGuards = Record<string, DOMAspectGuards>;
 /**
  * Guard configuration for a DOM Policy.
  * @public
  */
-export declare type DOMGuards = {
+export type DOMGuards = {
     /**
      * Guards for specific elements.
      */
@@ -58,7 +58,7 @@ export declare type DOMGuards = {
  * Options for creating a DOM Policy.
  * @public
  */
-export declare type DOMPolicyOptions = {
+export type DOMPolicyOptions = {
     /**
      * The trusted type to use for HTML creation.
      */
@@ -78,6 +78,6 @@ declare const DOMPolicy: Readonly<{
      * @param options The options to use in creating the policy.
      * @returns The newly created DOMPolicy.
      */
-    create(options?: DOMPolicyOptions): Readonly<DOMPolicy>;
+    create(options?: DOMPolicyOptions): Readonly<IDOMPolicy>;
 }>;
 export { DOMPolicy };

package/dist/dts/dom.d.ts

@@ -36,12 +36,12 @@ export declare const DOMAspect: Readonly<{
  * The type of HTML aspect to target.
  * @public
  */
-export declare type DOMAspect = (typeof DOMAspect)[Exclude<keyof typeof DOMAspect, "none">];
+export type DOMAspect = (typeof DOMAspect)[Exclude<keyof typeof DOMAspect, "none">];
 /**
  * A function used to send values to a DOM sink.
  * @public
  */
-export declare type DOMSink = (target: Node, aspectName: string, value: any, ...args: any[]) => void;
+export type DOMSink = (target: Node, aspectName: string, value: any, ...args: any[]) => void;
 /**
  * A security policy that FAST can use to interact with the DOM.
  * @public