@schukai/monster 3.85.0 → 3.85.1

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 
 
+## [3.85.1] - 2024-11-12
+
+### Bug Fixes
+
+- update the copy component [#259](https://gitlab.schukai.com/oss/libraries/javascript/monster/issues/259)
+
+
+
 ## [3.85.0] - 2024-11-05
 
 ### Add Features

package/package.json

@@ -1 +1 @@
-{"author":"schukai GmbH","dependencies":{"@floating-ui/dom":"^1.6.12","@popperjs/core":"^2.11.8"},"description":"Monster is a simple library for creating fast, robust and lightweight websites.","homepage":"https://monsterjs.org/","keywords":["framework","web","dom","css","sass","mobile-first","app","front-end","templates","schukai","core","shopcloud","alvine","monster","buildmap","stack","observer","observable","uuid","node","nodelist","css-in-js","logger","log","theme"],"license":"AGPL 3.0","main":"source/monster.mjs","module":"source/monster.mjs","name":"@schukai/monster","repository":{"type":"git","url":"https://gitlab.schukai.com/oss/libraries/javascript/monster.git"},"type":"module","version":"3.85.0"}
+{"author":"schukai GmbH","dependencies":{"@floating-ui/dom":"^1.6.12","@popperjs/core":"^2.11.8"},"description":"Monster is a simple library for creating fast, robust and lightweight websites.","homepage":"https://monsterjs.org/","keywords":["framework","web","dom","css","sass","mobile-first","app","front-end","templates","schukai","core","shopcloud","alvine","monster","buildmap","stack","observer","observable","uuid","node","nodelist","css-in-js","logger","log","theme"],"license":"AGPL 3.0","main":"source/monster.mjs","module":"source/monster.mjs","name":"@schukai/monster","repository":{"type":"git","url":"https://gitlab.schukai.com/oss/libraries/javascript/monster.git"},"type":"module","version":"3.85.1"}

package/source/components/content/copy.mjs

@@ -8,30 +8,34 @@
  * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
  * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
  * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
-import { instanceSymbol } from "../../constants.mjs";
+import {instanceSymbol} from "../../constants.mjs";
 import {
-	addAttributeToken,
-	removeAttributeToken,
+    addAttributeToken,
+    removeAttributeToken,
 } from "../../dom/attributes.mjs";
 import {
-	ATTRIBUTE_ERRORMESSAGE,
-	ATTRIBUTE_ROLE,
+    ATTRIBUTE_ERRORMESSAGE,
+    ATTRIBUTE_ROLE,
 } from "../../dom/constants.mjs";
-import { CustomElement, getSlottedElements } from "../../dom/customelement.mjs";
+import {CustomElement, getSlottedElements} from "../../dom/customelement.mjs";
 import {
-	assembleMethodSymbol,
-	registerCustomElement,
+    assembleMethodSymbol,
+    registerCustomElement,
 } from "../../dom/customelement.mjs";
-import { getDocument } from "../../dom/util.mjs";
-import { STYLE_DISPLAY_MODE_BLOCK } from "../form/constants.mjs";
-import { CopyStyleSheet } from "./stylesheet/copy.mjs";
-import { fireCustomEvent } from "../../dom/events.mjs";
-import { positionPopper } from "../form/util/floating-ui.mjs";
-import { DeadMansSwitch } from "../../util/deadmansswitch.mjs";
+import {getDocument} from "../../dom/util.mjs";
+import {isString} from "../../types/is.mjs";
+import {validateString} from "../../types/validate.mjs";
+import {STYLE_DISPLAY_MODE_BLOCK} from "../form/constants.mjs";
+import {CopyStyleSheet} from "./stylesheet/copy.mjs";
+import {fireCustomEvent} from "../../dom/events.mjs";
+import {positionPopper} from "../form/util/floating-ui.mjs";
+import {DeadMansSwitch} from "../../util/deadmansswitch.mjs";
 
-export { Copy };
+export {Copy};
 
 /**
  * @private
@@ -39,6 +43,12 @@ export { Copy };
  */
 const timerCallbackSymbol = Symbol("timerCallback");
 
+/**
+ * @private
+ * @type {symbol}
+ */
+const timerDelaySymbol = Symbol("timerDelay");
+
 /**
  * @private
  * @type {symbol}
@@ -83,248 +93,265 @@ const resizeObserverSymbol = Symbol("resizeObserver");
  * @summary A beautiful Copy that can make your life easier and also looks good.
  */
 class Copy extends CustomElement {
-	/**
-	 * This method is called by the `instanceof` operator.
-	 * @return {symbol}
-	 */
-	static get [instanceSymbol]() {
-		return Symbol.for("@schukai/monster/components/content/copy@@instance");
-	}
-
-	/**
-	 *
-	 * @return {Components.Content.Copy
-	 * @fires monster-copy-clicked This event is fired when the copy button is clicked.
-	 * @fires monster-copy-success This event is fired when the copy action is successful.
-	 * @fires monster-copy-error This event is fired when the copy action fails.
-	 */
-	[assembleMethodSymbol]() {
-		super[assembleMethodSymbol]();
-		initControlReferences.call(this);
-		initEventHandler.call(this);
-		return this;
-	}
-
-	/**
-	 * This method is called when the element is connected to the dom.
-	 *
-	 * @return {void}
-	 */
-	connectedCallback() {
-		super.connectedCallback();
-
-		const document = getDocument();
-
-		for (const [, type] of Object.entries(["click", "touch"])) {
-			// close on outside ui-events
-			document.addEventListener(type, this[closeEventHandler]);
-		}
-
-		updatePopper.call(this);
-		attachResizeObserver.call(this);
-	}
-
-	/**
-	 * This method is called when the element is disconnected from the dom.
-	 *
-	 * @return {void}
-	 */
-	disconnectedCallback() {
-		super.disconnectedCallback();
-
-		// close on outside ui-events
-		for (const [, type] of Object.entries(["click", "touch"])) {
-			document.removeEventListener(type, this[closeEventHandler]);
-		}
-
-		disconnectResizeObserver.call(this);
-	}
-
-	/**
-	 * To set the options via the HTML Tag, the attribute `data-monster-options` must be used.
-	 * @see {@link https://monsterjs.org/en/doc/#configurate-a-monster-control}
-	 *
-	 * The individual configuration values can be found in the table.
-	 *
-	 * @property {Object} templates Template definitions
-	 * @property {string} templates.main Main template
-	 * @property {Object} actions Callbacks
-	 * @property {string} actions.click="throw Error" Callback when clicked
-	 * @property {Object} features Features
-	 * @property {boolean} features.stripTags=true Strip tags from the copied text
-	 * @property {boolean} features.preventOpenEventSent=false Prevent open event from being sent
-	 * @property {Object} popper Popper configuration
-	 * @property {string} popper.placement="top" Popper placement
-	 * @property {string[]} popper.middleware=["autoPlacement", "shift", "offset:15", "arrow"] Popper middleware
-	 * @property {boolean} disabled=false Disabled state
-	 */
-	get defaults() {
-		return Object.assign({}, super.defaults, {
-			templates: {
-				main: getTemplate(),
-			},
-			disabled: false,
-			features: {
-				stripTags: true,
-				preventOpenEventSent: false,
-			},
-			popper: {
-				placement: "top",
-				middleware: ["autoPlacement", "shift", "offset:15", "arrow"],
-			},
-		});
-	}
-
-	/**
-	 * @return {string}
-	 */
-	static getTag() {
-		return "monster-copy";
-	}
-
-	/**
-	 * @return {CSSStyleSheet[]}
-	 */
-	static getCSSStyleSheet() {
-		return [CopyStyleSheet];
-	}
-
-	/**
-	 * With this method, you can show the popper.
-	 *
-	 * @return {Copy}
-	 */
-	showDialog() {
-		show.call(this);
-		return this;
-	}
-
-	/**
-	 * With this method, you can hide the popper.
-	 *
-	 * @return {Copy}
-	 */
-	hideDialog() {
-		hide.call(this);
-		return this;
-	}
-
-	/**
-	 * With this method, you can toggle the popper.
-	 *
-	 * @return {Copy}
-	 */
-	toggleDialog() {
-		if (this[popperElementSymbol].style.display === STYLE_DISPLAY_MODE_BLOCK) {
-			this.hideDialog();
-		} else {
-			this.showDialog();
-		}
-		return this;
-	}
+    /**
+     * This method is called by the `instanceof` operator.
+     * @return {symbol}
+     */
+    static get [instanceSymbol]() {
+        return Symbol.for("@schukai/monster/components/content/copy@@instance");
+    }
+
+    /**
+     *
+     * @return {Components.Content.Copy
+     * @fires monster-copy-clicked This event is fired when the copy button is clicked.
+     * @fires monster-copy-success This event is fired when the copy action is successful.
+     * @fires monster-copy-error This event is fired when the copy action fails.
+     */
+    [assembleMethodSymbol]() {
+        super[assembleMethodSymbol]();
+        initControlReferences.call(this);
+        initEventHandler.call(this);
+        return this;
+    }
+
+    /**
+     * This method is called when the element is connected to the dom.
+     *
+     * @return {void}
+     */
+    connectedCallback() {
+        super.connectedCallback();
+
+        const document = getDocument();
+
+        for (const [, type] of Object.entries(["click", "touch"])) {
+            // close on outside ui-events
+            document.addEventListener(type, this[closeEventHandler]);
+        }
+
+        updatePopper.call(this);
+        attachResizeObserver.call(this);
+    }
+
+    /**
+     * This method is called when the element is disconnected from the dom.
+     *
+     * @return {void}
+     */
+    disconnectedCallback() {
+        super.disconnectedCallback();
+
+        // close on outside ui-events
+        for (const [, type] of Object.entries(["click", "touch"])) {
+            document.removeEventListener(type, this[closeEventHandler]);
+        }
+
+        disconnectResizeObserver.call(this);
+    }
+
+    /**
+     * To set the options via the HTML Tag, the attribute `data-monster-options` must be used.
+     * @see {@link https://monsterjs.org/en/doc/#configurate-a-monster-control}
+     *
+     * The individual configuration values can be found in the table.
+     *
+     * @property {Object} templates Template definitions
+     * @property {string} templates.main Main template
+     * @property {Object} actions Callbacks
+     * @property {string} actions.click="throw Error" Callback when clicked
+     * @property {Object} features Features
+     * @property {boolean} features.stripTags=true Strip tags from the copied text
+     * @property {boolean} features.preventOpenEventSent=false Prevent open event from being sent
+     * @property {Object} popper Popper configuration
+     * @property {string} popper.placement="top" Popper placement
+     * @property {string[]} popper.middleware=["autoPlacement", "shift", "offset:15", "arrow"] Popper middleware
+     * @property {boolean} disabled=false Disabled state
+     */
+    get defaults() {
+        return Object.assign({}, super.defaults, {
+            templates: {
+                main: getTemplate(),
+            },
+            disabled: false,
+            features: {
+                stripTags: true,
+                preventOpenEventSent: false,
+            },
+            popper: {
+                placement: "top",
+                middleware: ["autoPlacement", "offset:-1", "arrow"],
+            },
+        });
+    }
+
+    /**
+     * @return {string}
+     */
+    static getTag() {
+        return "monster-copy";
+    }
+
+    /**
+     * @return {CSSStyleSheet[]}
+     */
+    static getCSSStyleSheet() {
+        return [CopyStyleSheet];
+    }
+
+    /**
+     * With this method, you can show the popper.
+     *
+     * @return {Copy}
+     */
+    showDialog() {
+        if (this[timerDelaySymbol] instanceof DeadMansSwitch) {
+            try {
+                this[timerDelaySymbol].defuse();
+            } catch (e) {
+            }
+        }
+
+        this[timerDelaySymbol] = new DeadMansSwitch(500, () => {
+            show.call(this);
+        });
+
+        return this;
+    }
+
+    /**
+     * With this method, you can hide the popper.
+     *
+     * @return {Copy}
+     */
+    hideDialog() {
+        if (this[timerDelaySymbol] instanceof DeadMansSwitch) {
+            try {
+                this[timerDelaySymbol].defuse();
+            } catch (e) {
+            }
+        }
+
+        hide.call(this);
+        return this;
+    }
+
+    /**
+     * With this method, you can toggle the popper.
+     *
+     * @return {Copy}
+     */
+    toggleDialog() {
+        if (this[popperElementSymbol].style.display === STYLE_DISPLAY_MODE_BLOCK) {
+            this.hideDialog();
+        } else {
+            this.showDialog();
+        }
+        return this;
+    }
 }
 
 /**
  * @private
  */
 function attachResizeObserver() {
-	// against flickering
-	this[resizeObserverSymbol] = new ResizeObserver((entries) => {
-		if (this[timerCallbackSymbol] instanceof DeadMansSwitch) {
-			try {
-				this[timerCallbackSymbol].touch();
-				return;
-			} catch (e) {
-				delete this[timerCallbackSymbol];
-			}
-		}
-
-		this[timerCallbackSymbol] = new DeadMansSwitch(200, () => {
-			updatePopper.call(this);
-		});
-	});
-
-	this[resizeObserverSymbol].observe(this.parentElement);
+    // against flickering
+    this[resizeObserverSymbol] = new ResizeObserver((entries) => {
+        if (this[timerCallbackSymbol] instanceof DeadMansSwitch) {
+            try {
+                this[timerCallbackSymbol].touch();
+                return;
+            } catch (e) {
+                delete this[timerCallbackSymbol];
+            }
+        }
+
+        this[timerCallbackSymbol] = new DeadMansSwitch(200, () => {
+            updatePopper.call(this);
+        });
+    });
+
+    this[resizeObserverSymbol].observe(this.parentElement);
 }
 
 /**
  * @private
  */
 function disconnectResizeObserver() {
-	if (this[resizeObserverSymbol] instanceof ResizeObserver) {
-		this[resizeObserverSymbol].disconnect();
-	}
+    if (this[resizeObserverSymbol] instanceof ResizeObserver) {
+        this[resizeObserverSymbol].disconnect();
+    }
 }
 
 /**
  * @private
  */
 function hide() {
-	const self = this;
+    const self = this;
 
-	fireCustomEvent(self, "monster-popper-hide", {
-		self,
-	});
+    fireCustomEvent(self, "monster-popper-hide", {
+        self,
+    });
 
-	self[popperElementSymbol].style.display = "none";
-	removeAttributeToken(self[controlElementSymbol], "class", "open");
+    self[popperElementSymbol].style.display = "none";
+    removeAttributeToken(self[controlElementSymbol], "class", "open");
 
-	setTimeout(() => {
-		fireCustomEvent(self, "monster-popper-hidden", {
-			self,
-		});
-	}, 0);
+    setTimeout(() => {
+        fireCustomEvent(self, "monster-popper-hidden", {
+            self,
+        });
+    }, 0);
 }
 
 /**
  * @private
  */
 function show() {
-	const self = this;
+    const self = this;
 
-	if (self.getOption("disabled", false) === true) {
-		return;
-	}
+    if (self.getOption("disabled", false) === true) {
+        return;
+    }
 
-	if (self[popperElementSymbol].style.display === STYLE_DISPLAY_MODE_BLOCK) {
-		return;
-	}
+    if (self[popperElementSymbol].style.display === STYLE_DISPLAY_MODE_BLOCK) {
+        return;
+    }
 
-	fireCustomEvent(self, "monster-popper-open", {
-		self,
-	});
+    fireCustomEvent(self, "monster-popper-open", {
+        self,
+    });
 
-	self[popperElementSymbol].style.visibility = "hidden";
-	self[popperElementSymbol].style.display = STYLE_DISPLAY_MODE_BLOCK;
+    self[popperElementSymbol].style.visibility = "hidden";
+    self[popperElementSymbol].style.display = STYLE_DISPLAY_MODE_BLOCK;
 
-	addAttributeToken(self[controlElementSymbol], "class", "open");
-	updatePopper.call(self);
+    addAttributeToken(self[controlElementSymbol], "class", "open");
+    updatePopper.call(self);
 
-	setTimeout(() => {
-		fireCustomEvent(self, "monster-popper-opened", {
-			self,
-		});
-	}, 0);
+    setTimeout(() => {
+        fireCustomEvent(self, "monster-popper-opened", {
+            self,
+        });
+    }, 0);
 }
 
 /**
  * @private
  */
 function updatePopper() {
-	if (this[popperElementSymbol].style.display !== STYLE_DISPLAY_MODE_BLOCK) {
-		return;
-	}
-
-	if (this.getOption("disabled", false) === true) {
-		return;
-	}
-
-	positionPopper.call(
-		this,
-		this[controlElementSymbol],
-		this[popperElementSymbol],
-		this.getOption("popper", {}),
-	);
+    if (this[popperElementSymbol].style.display !== STYLE_DISPLAY_MODE_BLOCK) {
+        return;
+    }
+
+    if (this.getOption("disabled", false) === true) {
+        return;
+    }
+
+    positionPopper.call(
+        this,
+        this[controlElementSymbol],
+        this[popperElementSymbol],
+        this.getOption("popper", {}),
+    );
 }
 
 /**
@@ -332,92 +359,126 @@ function updatePopper() {
  * @return {initEventHandler}
  */
 function initEventHandler() {
-	const self = this;
-
-	this[closeEventHandler] = (event) => {
-		const path = event.composedPath();
-
-		for (const [, element] of Object.entries(path)) {
-			if (element === this) {
-				return;
-			}
-		}
-		hide.call(this);
-	};
-
-	const type = "click";
-
-	this[controlElementSymbol].addEventListener("mouseenter", (event) => {
-		if (this.getOption("features.preventOpenEventSent") === true) {
-			event.preventDefault();
-		}
-		this.showDialog();
-	});
-
-	this[controlElementSymbol].addEventListener("focus", (event) => {
-		if (this.getOption("features.preventOpenEventSent") === true) {
-			event.preventDefault();
-		}
-		this.showDialog();
-	});
-	this[controlElementSymbol].addEventListener("blur", (event) => {
-		if (this.getOption("features.preventOpenEventSent") === true) {
-			event.preventDefault();
-		}
-		this.hideDialog();
-	});
-
-	this[copyButtonElementSymbol].addEventListener(type, function (event) {
-		fireCustomEvent(self, "monster-copy-clicked", {
-			element: self,
-		});
-
-		const nodes = getSlottedElements.call(self, ":scope");
-
-		let text = "";
-		for (const node of nodes) {
-			if (self.getOption("features.stripTags")) {
-				text += node.textContent;
-			} else {
-				text += node.outerHTML;
-			}
-		}
-
-		navigator.clipboard
-			.writeText(text)
-			.then(function () {
-				self[copyButtonElementSymbol]
-					.querySelector("use")
-					.setAttribute("href", "#copy-success");
-				setTimeout(() => {
-					self[copyButtonElementSymbol]
-						.querySelector("use")
-						.setAttribute("href", "#copy");
-				}, 2000);
-
-				fireCustomEvent(self, "monster-copy-success", {
-					element: self,
-				});
-			})
-			.catch(function (e) {
-				self[copyButtonElementSymbol]
-					.querySelector("use")
-					.setAttribute("href", "#copy-error");
-				setTimeout(() => {
-					self[copyButtonElementSymbol]
-						.querySelector("use")
-						.setAttribute("href", "#copy");
-				}, 2000);
-
-				fireCustomEvent(self, "monster-copy-error", {
-					element: self,
-				});
-
-				addAttributeToken(self, ATTRIBUTE_ERRORMESSAGE, "" + e);
-			});
-	});
-
-	return this;
+    const self = this;
+
+    this[closeEventHandler] = (event) => {
+        const path = event.composedPath();
+
+        for (const [, element] of Object.entries(path)) {
+            if (element === this) {
+                return;
+            }
+        }
+        hide.call(this);
+    };
+
+    const type = "click";
+
+    this[controlElementSymbol].addEventListener("mouseenter", (event) => {
+        if (this.getOption("features.preventOpenEventSent") === true) {
+            event.preventDefault();
+        }
+        this.showDialog();
+    });
+
+    this[controlElementSymbol].addEventListener("mouseleave", (event) => {
+        if (this.getOption("features.preventOpenEventSent") === true) {
+            event.preventDefault();
+        }
+        this.hideDialog();
+    });
+
+    this[controlElementSymbol].addEventListener("focus", (event) => {
+        if (this.getOption("features.preventOpenEventSent") === true) {
+            event.preventDefault();
+        }
+        this.showDialog();
+    });
+    this[controlElementSymbol].addEventListener("blur", (event) => {
+        if (this.getOption("features.preventOpenEventSent") === true) {
+            event.preventDefault();
+        }
+        this.hideDialog();
+    });
+
+    this[copyButtonElementSymbol].addEventListener(type, function (event) {
+        fireCustomEvent(self, "monster-copy-clicked", {
+            element: self,
+        });
+
+        const text = getSlottedCopyContent.call(self);
+
+        navigator.clipboard
+            .writeText(text)
+            .then(function () {
+                self[copyButtonElementSymbol]
+                    .querySelector("use")
+                    .setAttribute("href", "#copy-success");
+                setTimeout(() => {
+                    self[copyButtonElementSymbol]
+                        .querySelector("use")
+                        .setAttribute("href", "#copy");
+                }, 2000);
+
+                fireCustomEvent(self, "monster-copy-success", {
+                    element: self,
+                });
+            })
+            .catch(function (e) {
+                self[copyButtonElementSymbol]
+                    .querySelector("use")
+                    .setAttribute("href", "#copy-error");
+                setTimeout(() => {
+                    self[copyButtonElementSymbol]
+                        .querySelector("use")
+                        .setAttribute("href", "#copy");
+                }, 2000);
+
+                fireCustomEvent(self, "monster-copy-error", {
+                    element: self,
+                });
+
+                addAttributeToken(self, ATTRIBUTE_ERRORMESSAGE, "" + e);
+            });
+    });
+
+    return this;
+}
+
+/**
+ * @private
+ * @returns {Set<any>|string}
+ */
+function getSlottedCopyContent() {
+    const self = this;
+    const result = new Set();
+
+    if (!(this.shadowRoot instanceof ShadowRoot)) {
+        return result;
+    }
+
+    const slots = this.shadowRoot.querySelectorAll("slot");
+
+    let text = "";
+    for (const [, slot] of Object.entries(slots)) {
+        slot.assignedNodes().forEach(function (node) {
+            if (
+                node instanceof HTMLElement ||
+                node instanceof SVGElement ||
+                node instanceof MathMLElement
+            ) {
+                if (self.getOption("features.stripTags")) {
+                    text += node.textContent.trim();
+                } else {
+                    text += node.outerHTML.trim();
+                }
+            } else {
+                text += node.textContent.trim();
+            }
+        });
+    }
+
+    return text;
 }
 
 /**
@@ -425,17 +486,17 @@ function initEventHandler() {
  * @return {void}
  */
 function initControlReferences() {
-	this[controlElementSymbol] = this.shadowRoot.querySelector(
-		`[${ATTRIBUTE_ROLE}="control"]`,
-	);
+    this[controlElementSymbol] = this.shadowRoot.querySelector(
+        `[${ATTRIBUTE_ROLE}="control"]`,
+    );
 
-	this[copyButtonElementSymbol] = this.shadowRoot.querySelector(
-		`[${ATTRIBUTE_ROLE}="button"]`,
-	);
+    this[copyButtonElementSymbol] = this.shadowRoot.querySelector(
+        `[${ATTRIBUTE_ROLE}="button"]`,
+    );
 
-	this[popperElementSymbol] = this.shadowRoot.querySelector(
-		`[${ATTRIBUTE_ROLE}="popper"]`,
-	);
+    this[popperElementSymbol] = this.shadowRoot.querySelector(
+        `[${ATTRIBUTE_ROLE}="popper"]`,
+    );
 }
 
 /**
@@ -443,14 +504,15 @@ function initControlReferences() {
  * @return {string}
  */
 function getTemplate() {
-	// language=HTML
-	return `
+    // language=HTML
+    return `
         <div data-monster-role="control" part="control">
             <slot></slot>
             <div data-monster-role="popper" part="popper" tabindex="-1" class="monster-color-primary-1">
                 <div data-monster-role="arrow"></div>
                 <button data-monster-role="button" part="button">
-                    <svg data-monster-role="icon-map"><defs>
+                    <svg data-monster-role="icon-map">
+                        <defs>
                             <g id="copy">
                                 <path d="M4 1.5H3a2 2 0 0 0-2 2V14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V3.5a2 2 0 0 0-2-2h-1v1h1a1 1 0 0 1 1 1V14a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V3.5a1 1 0 0 1 1-1h1z"/>
                                 <path d="M9.5 1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5zm-3-1A1.5 1.5 0 0 0 5 1.5v1A1.5 1.5 0 0 0 6.5 4h3A1.5 1.5 0 0 0 11 2.5v-1A1.5 1.5 0 0 0 9.5 0z"/>
@@ -471,7 +533,11 @@ function getTemplate() {
                             </g>
 
                         </defs>
-                    </svg><svg data-monster-role="icon" xmlns="http://www.w3.org/2000/svg" width="25" height="25" viewBox="0 0 16 16"><use href="#copy"></use></svg>
+                    </svg>
+                    <svg data-monster-role="icon" xmlns="http://www.w3.org/2000/svg" width="25" height="25"
+                         viewBox="0 0 16 16">
+                        <use href="#copy"></use>
+                    </svg>
                 </button>
             </div>
         </div>`;

package/source/util/deadmansswitch.mjs

@@ -63,11 +63,23 @@ class DeadMansSwitch extends Base {
 		}
 
 		clearTimeout(this[internalSymbol]["timer"]);
-
 		initCallback.call(this);
 
 		return this;
 	}
+
+	/**
+	 * @throws {Error} has already run
+	 * @returns {DeadMansSwitch}
+	 */
+	defuse() {
+		if (this[internalSymbol]["isAlreadyRun"] === true) {
+			throw new Error("has already run");
+		}
+
+		clearTimeout(this[internalSymbol]["timer"]);
+		return this;
+	}
 }
 
 /**