@microsoft/fast-element 2.0.0-beta.16 → 2.0.0-beta.18

package/docs/api-report.md

@@ -31,24 +31,9 @@ export const ArrayObserver: Readonly<{
     readonly enable: () => void;
 }>;
 
-// @public
-export const Aspect: Readonly<{
-    readonly none: 0;
-    readonly attribute: 1;
-    readonly booleanAttribute: 2;
-    readonly property: 3;
-    readonly content: 4;
-    readonly tokenList: 5;
-    readonly event: 6;
-    readonly assign: (directive: Aspected, value?: string) => void;
-}>;
-
-// @public
-export type Aspect = typeof Aspect[Exclude<keyof typeof Aspect, "assign" | "none">];
-
 // @public
 export interface Aspected {
-    aspectType: Aspect;
+    aspectType: DOMAspect;
     dataBinding?: Binding;
     sourceAspect: string;
     targetAspect: string;
@@ -96,17 +81,19 @@ export class AttributeDefinition implements Accessor {
 export type AttributeMode = typeof reflectMode | typeof booleanMode | "fromView";
 
 // @public
-export function bind<T = any>(expression: Expression<T>, isVolatile?: boolean): Binding<T>;
+export function bind<T = any>(expression: Expression<T>, policy?: DOMPolicy, isVolatile?: boolean): Binding<T>;
 
 // @public
 export abstract class Binding<TSource = any, TReturn = any, TParent = any> {
-    constructor(evaluate: Expression<TSource, TReturn, TParent>, isVolatile?: boolean);
+    constructor(evaluate: Expression<TSource, TReturn, TParent>, policy?: DOMPolicy | undefined, isVolatile?: boolean);
     abstract createObserver(directive: HTMLDirective, subscriber: Subscriber): ExpressionObserver<TSource, TReturn, TParent>;
     // (undocumented)
     evaluate: Expression<TSource, TReturn, TParent>;
     // (undocumented)
     isVolatile: boolean;
     options?: any;
+    // (undocumented)
+    policy?: DOMPolicy | undefined;
 }
 
 // @public
@@ -142,14 +129,17 @@ export type ChildrenDirectiveOptions<T = any> = ChildListDirectiveOptions<T> | S
 // @public
 export type CompilationStrategy = (
 html: string | HTMLTemplateElement,
-factories: Record<string, ViewBehaviorFactory>) => HTMLTemplateCompilationResult;
+factories: Record<string, ViewBehaviorFactory>,
+policy: DOMPolicy) => HTMLTemplateCompilationResult;
+
+// @public
+export type CompiledViewBehaviorFactory = Required<ViewBehaviorFactory>;
 
 // @public
 export const Compiler: {
-    setHTMLPolicy(policy: TrustedTypesPolicy): void;
-    compile<TSource = any, TParent = any>(html: string | HTMLTemplateElement, directives: Record<string, ViewBehaviorFactory>): HTMLTemplateCompilationResult<TSource, TParent>;
+    compile<TSource = any, TParent = any>(html: string | HTMLTemplateElement, factories: Record<string, ViewBehaviorFactory>, policy?: DOMPolicy): HTMLTemplateCompilationResult<TSource, TParent>;
     setDefaultStrategy(strategy: CompilationStrategy): void;
-    aggregate(parts: (string | ViewBehaviorFactory)[]): ViewBehaviorFactory;
+    aggregate(parts: (string | ViewBehaviorFactory)[], policy?: DOMPolicy): ViewBehaviorFactory;
 };
 
 // @public
@@ -224,6 +214,16 @@ export type CSSTemplateTag = ((strings: TemplateStringsArray, ...values: (Compos
 // @public
 export function customElement(nameOrDef: string | PartialFASTElementDefinition): (type: Constructable<HTMLElement>) => void;
 
+// @public
+export function dangerousHTML<TSource = any, TParent = any>(html: string): CaptureType<TSource, TParent>;
+
+// @public
+export class DangerousHTMLDirective implements HTMLDirective {
+    constructor(html: string);
+    // (undocumented)
+    createHTML(): string;
+}
+
 // @public
 export type DecoratorAttributeConfiguration = Omit<AttributeConfiguration, "property">;
 
@@ -237,10 +237,35 @@ export const DOM: Readonly<{
     queueUpdate: (callable: Callable) => void;
     nextUpdate: () => Promise<void>;
     processUpdates: () => void;
+    readonly policy: DOMPolicy;
+    setPolicy(value: DOMPolicy): void;
     setAttribute(element: HTMLElement, attributeName: string, value: any): void;
     setBooleanAttribute(element: HTMLElement, attributeName: string, value: boolean): void;
 }>;
 
+// @public
+export const DOMAspect: Readonly<{
+    readonly none: 0;
+    readonly attribute: 1;
+    readonly booleanAttribute: 2;
+    readonly property: 3;
+    readonly content: 4;
+    readonly tokenList: 5;
+    readonly event: 6;
+}>;
+
+// @public
+export type DOMAspect = typeof DOMAspect[Exclude<keyof typeof DOMAspect, "none">];
+
+// @public
+export interface DOMPolicy {
+    createHTML(value: string): string;
+    protect(tagName: string | null, aspect: DOMAspect, aspectName: string, sink: DOMSink): DOMSink;
+}
+
+// @public
+export type DOMSink = (target: Node, aspectName: string, value: any, ...args: any[]) => void;
+
 // @public
 export class ElementController<TElement extends HTMLElement = HTMLElement> extends PropertyChangeNotifier implements HostController<TElement> {
     // @internal
@@ -262,6 +287,8 @@ export class ElementController<TElement extends HTMLElement = HTMLElement> exten
     readonly source: TElement;
     get template(): ElementViewTemplate<TElement> | null;
     set template(value: ElementViewTemplate<TElement> | null);
+    // @internal
+    toJSON: () => undefined;
     readonly view: ElementView<TElement> | null;
 }
 
@@ -441,7 +468,7 @@ export function html<TSource = any, TParent = any>(strings: TemplateStringsArray
 // @public
 export class HTMLBindingDirective implements HTMLDirective, ViewBehaviorFactory, ViewBehavior, Aspected {
     constructor(dataBinding: Binding);
-    aspectType: Aspect;
+    aspectType: DOMAspect;
     // @internal (undocumented)
     bind(controller: ViewController): void;
     createBehavior(): ViewBehavior;
@@ -453,9 +480,11 @@ export class HTMLBindingDirective implements HTMLDirective, ViewBehaviorFactory,
     // @internal (undocumented)
     handleEvent(event: Event): void;
     id: string;
-    nodeId: string;
+    policy: DOMPolicy;
     sourceAspect: string;
     targetAspect: string;
+    targetNodeId: string;
+    targetTagName: string | null;
     // @internal (undocumented)
     unbind(controller: ViewController): void;
 }
@@ -470,6 +499,7 @@ export const HTMLDirective: Readonly<{
     getForInstance: (object: any) => HTMLDirectiveDefinition<Constructable<HTMLDirective>> | undefined;
     getByType: (key: Function) => HTMLDirectiveDefinition<Constructable<HTMLDirective>> | undefined;
     define<TType extends Constructable<HTMLDirective>>(type: TType, options?: PartialHTMLDirectiveDefinition): TType;
+    assignAspect(directive: Aspected, value?: string): void;
 }>;
 
 // @public
@@ -487,7 +517,7 @@ export interface HTMLTemplateCompilationResult<TSource = any, TParent = any> {
 
 // @public
 export class HTMLView<TSource = any, TParent = any> implements ElementView<TSource, TParent>, SyntheticView<TSource, TParent>, ExecutionContext<TParent> {
-    constructor(fragment: DocumentFragment, factories: ReadonlyArray<ViewBehaviorFactory>, targets: ViewBehaviorTargets);
+    constructor(fragment: DocumentFragment, factories: ReadonlyArray<CompiledViewBehaviorFactory>, targets: ViewBehaviorTargets);
     appendTo(node: Node): void;
     bind(source: TSource, context?: ExecutionContext<TParent>): void;
     context: ExecutionContext<TParent>;
@@ -518,6 +548,8 @@ export class HTMLView<TSource = any, TParent = any> implements ElementView<TSour
     readonly sourceLifetime: SourceLifetime;
     // (undocumented)
     readonly targets: ViewBehaviorTargets;
+    // @internal
+    toJSON: () => undefined;
     unbind(): void;
 }
 
@@ -559,7 +591,10 @@ export abstract class NodeObservationDirective<T extends NodeBehaviorOptions> ex
     protected abstract disconnect(target: any): void;
     protected abstract getNodes(target: any): Node[];
     protected getSource(target: Node): any;
+    get id(): string;
+    set id(value: string);
     protected abstract observe(target: any): void;
+    targetNodeId: string;
     unbind(controller: ViewController): void;
     protected updateTarget(source: any, value: ReadonlyArray<any>): void;
 }
@@ -601,7 +636,7 @@ export interface ObservationRecord {
 }
 
 // @public
-export function oneTime<T = any>(expression: Expression<T>): Binding<T>;
+export function oneTime<T = any>(expression: Expression<T>, policy?: DOMPolicy): Binding<T>;
 
 // @public
 export const Parser: Readonly<{
@@ -639,6 +674,7 @@ export const ref: <TSource = any, TParent = any>(propertyName: keyof TSource & s
 // @public
 export class RefDirective extends StatelessAttachedAttributeDirective<string> {
     bind(controller: ViewController): void;
+    targetNodeId: string;
 }
 
 // @public
@@ -661,10 +697,9 @@ export class RepeatDirective<TSource = any> implements HTMLDirective, ViewBehavi
     createHTML(add: AddViewBehaviorFactory): string;
     // (undocumented)
     readonly dataBinding: Binding<TSource>;
-    id: string;
-    nodeId: string;
     // (undocumented)
     readonly options: RepeatOptions;
+    targetNodeId: string;
     // (undocumented)
     readonly templateBinding: Binding<TSource, SyntheticViewTemplate>;
 }
@@ -754,10 +789,10 @@ export abstract class StatelessAttachedAttributeDirective<TOptions> implements H
     abstract bind(controller: ViewController): void;
     createBehavior(): ViewBehavior;
     createHTML(add: AddViewBehaviorFactory): string;
-    id: string;
-    nodeId: string;
     // (undocumented)
     protected options: TOptions;
+    // @internal
+    toJSON: () => undefined;
 }
 
 // @public
@@ -811,16 +846,6 @@ export interface SyntheticViewTemplate<TSource = any, TParent = any> {
 // @public
 export type TemplateValue<TSource, TParent = any> = Expression<TSource, any, TParent> | Binding<TSource, any, TParent> | HTMLDirective | CaptureType<TSource, TParent>;
 
-// @public
-export type TrustedTypes = {
-    createPolicy(name: string, rules: TrustedTypesPolicy): TrustedTypesPolicy;
-};
-
-// @public
-export type TrustedTypesPolicy = {
-    createHTML(html: string): string;
-};
-
 // Warning: (ae-internal-missing-underscore) The name "TypeDefinition" should be prefixed with an underscore because the declaration is marked as @internal
 //
 // @internal
@@ -874,23 +899,12 @@ export interface ViewBehavior<TSource = any, TParent = any> {
 // @public
 export interface ViewBehaviorFactory {
     createBehavior(): ViewBehavior;
-    id: string;
-    nodeId: string;
-}
-
-// @public
-export interface ViewBehaviorOrchestrator<TSource = any, TParent = any> extends ViewController<TSource, TParent>, HostBehavior<TSource> {
-    addBehavior(behavior: ViewBehavior): void;
-    addBehaviorFactory(factory: ViewBehaviorFactory, target: Node): void;
-    // (undocumented)
-    addTarget(nodeId: string, target: Node): void;
+    id?: string;
+    policy?: DOMPolicy;
+    targetNodeId?: string;
+    targetTagName?: string | null;
 }
 
-// @public
-export const ViewBehaviorOrchestrator: Readonly<{
-    create<TSource = any, TParent = any>(source: TSource): ViewBehaviorOrchestrator<TSource, TParent>;
-}>;
-
 // @public
 export type ViewBehaviorTargets = {
     [id: string]: Node;
@@ -903,11 +917,15 @@ export interface ViewController<TSource = any, TParent = any> extends Expression
 
 // @public
 export class ViewTemplate<TSource = any, TParent = any> implements ElementViewTemplate<TSource, TParent>, SyntheticViewTemplate<TSource, TParent> {
-    constructor(html: string | HTMLTemplateElement, factories: Record<string, ViewBehaviorFactory>);
+    constructor(html: string | HTMLTemplateElement, factories?: Record<string, ViewBehaviorFactory>, policy?: DOMPolicy | undefined);
     create(hostBindingTarget?: Element): HTMLView<TSource, TParent>;
+    static create<TSource = any, TParent = any>(strings: string[], values: TemplateValue<TSource, TParent>[], policy?: DOMPolicy): ViewTemplate<TSource, TParent>;
     readonly factories: Record<string, ViewBehaviorFactory>;
     readonly html: string | HTMLTemplateElement;
     render(source: TSource, host: Node, hostBindingTarget?: Element): HTMLView<TSource, TParent>;
+    // @internal
+    toJSON: () => undefined;
+    withPolicy(policy: DOMPolicy): this;
 }
 
 // @public

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@microsoft/fast-element",
   "description": "A library for constructing Web Components",
-  "version": "2.0.0-beta.16",
+  "version": "2.0.0-beta.18",
   "author": {
     "name": "Microsoft",
     "url": "https://discord.gg/FcSNfg4"
@@ -78,6 +78,10 @@
       "types": "./dist/dts/pending-task.d.ts",
       "default": "./dist/esm/pending-task.js"
     },
+    "./dom-policy": {
+      "types": "./dist/dts/dom-policy.d.ts",
+      "default": "./dist/esm/dom-policy.js"
+    },
     "./package.json": "./package.json"
   },
   "unpkg": "dist/fast-element.min.js",

package/yarn-error.log

@@ -0,0 +1,177 @@
+Arguments: 
+  /Users/christopherholt/.nvm/versions/node/v16.14.2/bin/node /Users/christopherholt/repos/fast-dna/.yarn/releases/yarn-1.22.11.cjs clean:dist
+
+PATH: 
+  /Users/christopherholt/repos/fast-dna/packages/web-components/fast-element/node_modules/.bin:/Users/christopherholt/repos/fast-dna/packages/web-components/node_modules/.bin:/Users/christopherholt/repos/fast-dna/packages/node_modules/.bin:/Users/christopherholt/repos/fast-dna/node_modules/.bin:/Users/christopherholt/repos/node_modules/.bin:/Users/christopherholt/node_modules/.bin:/Users/node_modules/.bin:/node_modules/.bin:/Users/christopherholt/.nvm/versions/node/v16.14.2/lib/node_modules/npm/node_modules/@npmcli/run-script/lib/node-gyp-bin:/Users/christopherholt/.nvm/versions/node/v16.14.2/bin:/usr/local/opt/openssl/bin:/usr/local/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin
+
+Yarn version: 
+  1.22.11
+
+Node version: 
+  16.14.2
+
+Platform: 
+  darwin x64
+
+Trace: 
+  SyntaxError: /Users/christopherholt/repos/fast-dna/package.json: Unexpected token / in JSON at position 353
+      at JSON.parse (<anonymous>)
+      at /Users/christopherholt/repos/fast-dna/.yarn/releases/yarn-1.22.11.cjs:1098:57
+      at Generator.next (<anonymous>)
+      at step (/Users/christopherholt/repos/fast-dna/.yarn/releases/yarn-1.22.11.cjs:310:30)
+      at /Users/christopherholt/repos/fast-dna/.yarn/releases/yarn-1.22.11.cjs:321:13
+
+npm manifest: 
+  {
+    "name": "@microsoft/fast-element",
+    "description": "A library for constructing Web Components",
+    "version": "2.0.0-beta.14",
+    "author": {
+      "name": "Microsoft",
+      "url": "https://discord.gg/FcSNfg4"
+    },
+    "homepage": "https://www.fast.design/",
+    "license": "MIT",
+    "repository": {
+      "type": "git",
+      "url": "git+https://github.com/Microsoft/fast.git",
+      "directory": "packages/web-components/fast-element"
+    },
+    "bugs": {
+      "url": "https://github.com/Microsoft/fast/issues/new/choose"
+    },
+    "type": "module",
+    "main": "dist/esm/index.js",
+    "types": "dist/dts/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/dts/index.d.ts",
+        "production": "./dist/esm/index.js",
+        "development": "./dist/esm/index.debug.js",
+        "default": "./dist/esm/index.js"
+      },
+      "./debug": {
+        "types": "./dist/dts/debug.d.ts",
+        "default": "./dist/esm/debug.js"
+      },
+      "./binding/two-way": {
+        "types": "./dist/dts/templating/binding-two-way.d.ts",
+        "default": "./dist/esm/templating/binding-two-way.js"
+      },
+      "./binding/signal": {
+        "types": "./dist/dts/templating/binding-signal.d.ts",
+        "default": "./dist/esm/templating/binding-signal.js"
+      },
+      "./render": {
+        "types": "./dist/dts/templating/render.d.ts",
+        "default": "./dist/esm/templating/render.js"
+      },
+      "./utilities": {
+        "types": "./dist/dts/utilities.d.ts",
+        "default": "./dist/esm/utilities.js"
+      },
+      "./state": {
+        "types": "./dist/dts/state/exports.d.ts",
+        "default": "./dist/esm/state/exports.js"
+      },
+      "./context": {
+        "types": "./dist/dts/context.d.ts",
+        "default": "./dist/esm/context.js"
+      },
+      "./metadata": {
+        "types": "./dist/dts/metadata.d.ts",
+        "default": "./dist/esm/metadata.js"
+      },
+      "./testing": {
+        "types": "./dist/dts/testing/exports.d.ts",
+        "default": "./dist/esm/testing/exports.js"
+      },
+      "./di": {
+        "types": "./dist/dts/di/di.d.ts",
+        "default": "./dist/esm/di/di.js"
+      },
+      "./pending-task": {
+        "types": "./dist/dts/pending-task.d.ts",
+        "default": "./dist/esm/pending-task.js"
+      },
+      "./package.json": "./package.json"
+    },
+    "unpkg": "dist/fast-element.min.js",
+    "sideEffects": [
+      "./dist/esm/debug.js",
+      "./dist/esm/polyfills.js"
+    ],
+    "scripts": {
+      "clean:dist": "node ../../../build/clean.js dist",
+      "doc": "api-extractor run --local",
+      "doc:ci": "api-extractor run",
+      "build": "yarn build:tsc && yarn build:rollup && yarn doc",
+      "build:rollup": "rollup -c",
+      "build:tsc": "tsc -p ./tsconfig.json",
+      "dev": "tsc -p ./tsconfig.json -w",
+      "tdd": "yarn dev & yarn test-chrome:watch",
+      "prepare": "yarn clean:dist && yarn build",
+      "prettier": "prettier --config ../../../.prettierrc --write \"**/*.ts\"",
+      "prettier:diff": "prettier --config ../../../.prettierrc \"**/*.ts\" --list-different",
+      "eslint": "eslint . --ext .ts",
+      "eslint:fix": "eslint . --ext .ts --fix",
+      "test": "yarn eslint && yarn test-chrome:verbose && yarn doc:ci",
+      "test-node": "mocha --reporter min --exit dist/esm/__test__/setup-node.js './dist/esm/**/*.spec.js'",
+      "test-node:verbose": "mocha --reporter spec --exit dist/esm/__test__/setup-node.js './dist/esm/**/*.spec.js'",
+      "test-chrome": "karma start karma.conf.cjs --browsers=ChromeHeadlessOpt --single-run --coverage",
+      "test-chrome:verbose": "karma start karma.conf.cjs --browsers=ChromeHeadlessOpt --single-run --coverage --reporter=mocha",
+      "test-chrome:watch": "karma start karma.conf.cjs --browsers=ChromeHeadlessOpt --coverage --watch-extensions js",
+      "test-chrome:debugger": "karma start karma.conf.cjs --browsers=ChromeDebugging",
+      "test-chrome:verbose:watch": "karma start karma.conf.cjs --browsers=ChromeHeadlessOpt --coverage --watch-extensions js --reporter=mocha",
+      "test-chrome:verbose:debugger": "karma start karma.conf.cjs --browsers=ChromeDebugging --reporter=mocha",
+      "test-firefox": "karma start karma.conf.cjs --browsers=FirefoxHeadless --single-run --coverage",
+      "test-firefox:verbose": "karma start karma.conf.cjs --browsers=FirefoxHeadless --single-run --coverage --reporter=mocha"
+    },
+    "devDependencies": {
+      "@microsoft/api-extractor": "7.24.2",
+      "@types/chai": "^4.2.11",
+      "@types/chai-spies": "^1.0.3",
+      "@types/karma": "^6.3.3",
+      "@types/mocha": "^7.0.2",
+      "@types/webpack-env": "^1.15.2",
+      "chai": "^4.2.0",
+      "chai-spies": "^1.0.0",
+      "esm": "^3.2.25",
+      "ignore-loader": "^0.1.2",
+      "istanbul": "^0.4.5",
+      "istanbul-instrumenter-loader": "^3.0.1",
+      "jsdom": "^16.2.2",
+      "jsdom-global": "3.0.2",
+      "karma": "^6.4.1",
+      "karma-chrome-launcher": "^3.1.0",
+      "karma-coverage": "^2.0.2",
+      "karma-coverage-istanbul-reporter": "^3.0.0",
+      "karma-firefox-launcher": "^2.1.0",
+      "karma-mocha": "^2.0.1",
+      "karma-mocha-reporter": "^2.2.5",
+      "karma-source-map-support": "^1.4.0",
+      "karma-sourcemap-loader": "^0.3.7",
+      "karma-webpack": "^5.0.0",
+      "mocha": "^7.1.2",
+      "prettier": "2.0.2",
+      "rollup": "^2.71.1",
+      "rollup-plugin-filesize": "^9.1.2",
+      "rollup-plugin-terser": "^7.0.2",
+      "@rollup/plugin-typescript": "^8.3.2",
+      "source-map": "^0.7.3",
+      "source-map-loader": "^0.2.4",
+      "ts-loader": "^7.0.2",
+      "ts-node": "^8.9.1",
+      "tsconfig-paths": "^3.9.0",
+      "tslib": "^2.4.0",
+      "typescript": "^4.7.0",
+      "webpack": "^5.72.0",
+      "webpack-cli": "^4.9.2"
+    }
+  }
+
+yarn manifest: 
+  No manifest
+
+Lockfile: 
+  No lockfile

package/dist/dts/templating/dom.d.ts

@@ -1,41 +0,0 @@
-import type { Callable } from "../interfaces.js";
-/**
- * Common DOM APIs.
- * @public
- */
-export declare const DOM: Readonly<{
-    /**
-     * @deprecated
-     * Use Updates.enqueue().
-     */
-    queueUpdate: (callable: Callable) => void;
-    /**
-     * @deprecated
-     * Use Updates.next()
-     */
-    nextUpdate: () => Promise<void>;
-    /**
-     * @deprecated
-     * Use Updates.process()
-     */
-    processUpdates: () => void;
-    /**
-     * Sets an attribute value on an element.
-     * @param element - The element to set the attribute value on.
-     * @param attributeName - The attribute name to set.
-     * @param value - The value of the attribute to set.
-     * @remarks
-     * If the value is `null` or `undefined`, the attribute is removed, otherwise
-     * it is set to the provided value using the standard `setAttribute` API.
-     */
-    setAttribute(element: HTMLElement, attributeName: string, value: any): void;
-    /**
-     * Sets a boolean attribute value.
-     * @param element - The element to set the boolean attribute value on.
-     * @param attributeName - The attribute name to set.
-     * @param value - The value of the attribute to set.
-     * @remarks
-     * If the value is true, the attribute is added; otherwise it is removed.
-     */
-    setBooleanAttribute(element: HTMLElement, attributeName: string, value: boolean): void;
-}>;

package/dist/esm/templating/dom.js

@@ -1,49 +0,0 @@
-import { Updates } from "../observation/update-queue.js";
-/**
- * Common DOM APIs.
- * @public
- */
-export const DOM = Object.freeze({
-    /**
-     * @deprecated
-     * Use Updates.enqueue().
-     */
-    queueUpdate: Updates.enqueue,
-    /**
-     * @deprecated
-     * Use Updates.next()
-     */
-    nextUpdate: Updates.next,
-    /**
-     * @deprecated
-     * Use Updates.process()
-     */
-    processUpdates: Updates.process,
-    /**
-     * Sets an attribute value on an element.
-     * @param element - The element to set the attribute value on.
-     * @param attributeName - The attribute name to set.
-     * @param value - The value of the attribute to set.
-     * @remarks
-     * If the value is `null` or `undefined`, the attribute is removed, otherwise
-     * it is set to the provided value using the standard `setAttribute` API.
-     */
-    setAttribute(element, attributeName, value) {
-        value === null || value === undefined
-            ? element.removeAttribute(attributeName)
-            : element.setAttribute(attributeName, value);
-    },
-    /**
-     * Sets a boolean attribute value.
-     * @param element - The element to set the boolean attribute value on.
-     * @param attributeName - The attribute name to set.
-     * @param value - The value of the attribute to set.
-     * @remarks
-     * If the value is true, the attribute is added; otherwise it is removed.
-     */
-    setBooleanAttribute(element, attributeName, value) {
-        value
-            ? element.setAttribute(attributeName, "")
-            : element.removeAttribute(attributeName);
-    },
-});