@bedlamhotel/attrmanager 0.2.0

package/dist/js/attr-manager.cjs

@@ -0,0 +1,138 @@
+/*! attr-manager 0.2.0 — © Christopher Torgalson */
+'use strict';
+
+/**
+ * A class used to create and/or enforce HTMLElement attribute values.
+ */
+class AttrManager {
+    el;
+    /** Unique ID for self-removal from `restorers` array. */
+    id;
+    /** An array of the attributes under management in NormalizedAttr form. */
+    items = [];
+    /** An array of the attribute values (used to restore initial DOM state). */
+    original = [];
+    /** A var used to track the state of the attributes under management. */
+    currentState = false;
+    /** Optional reference to the restorer array for self-removal. */
+    restorers;
+    /**
+     * Generates a unique ID for this instance.
+     */
+    static createId() {
+        return Math.random().toString(36).slice(2, 7);
+    }
+    /**
+     * Constructs a new AttrManager instance.
+     *
+     * @param el
+     *   The HTMLElement to manage.
+     * @param config
+     *   The attribute configuration.
+     * @param restorers
+     *   Optional restorer array for lifecycle management.
+     */
+    constructor(el, config, restorers) {
+        this.el = el;
+        let hasExplicitInitial = false;
+        // Generate unique ID for self-removal from restorers
+        this.id = AttrManager.createId();
+        for (const [name, { whenTrue: trueValue, whenFalse, initial, fixed },] of Object.entries(config)) {
+            if (trueValue === undefined) {
+                throw new Error("AttrManager: each attribute must supply a `whenTrue` value.");
+            }
+            if (initial !== undefined &&
+                !["whenTrue", "whenFalse", null].includes(initial)) {
+                throw new Error("AttrManager: if attributes supply an `initial` value, it must be one of `whenTrue`, `whenFalse`, or `null`.");
+            }
+            const originalVal = el.getAttribute(name);
+            this.original.push([name, originalVal]);
+            const falseValue = whenFalse !== undefined ? whenFalse : originalVal;
+            this.items.push({ name, trueValue, falseValue, fixed: !!fixed });
+            if (initial !== undefined) {
+                this.applyValue(name, initial === "whenTrue" ? trueValue : falseValue);
+                if (!hasExplicitInitial) {
+                    this.currentState = initial === "whenTrue";
+                    hasExplicitInitial = true;
+                }
+            }
+        }
+        // Register restorer with ID for self-removal
+        if (restorers) {
+            this.restorers = restorers;
+            restorers.push({
+                id: this.id,
+                restore: () => this.restore(),
+            });
+        }
+    }
+    /**
+     * Toggles state of attributes managed by this instance.
+     *
+     * @param condition
+     *   The condition to set. If omitted, toggles the current state.
+     */
+    toggle(condition) {
+        this.currentState = condition ?? !this.currentState;
+        for (const { name, trueValue, falseValue, fixed } of this.items) {
+            if (fixed) {
+                continue;
+            }
+            this.applyValue(name, this.currentState ? trueValue : falseValue);
+        }
+    }
+    /**
+     * Restores original state of attributes.
+     *
+     * @param teardown
+     *   If `true` (default), also clears internal state and self-removes from
+     *   `restorers`.
+     */
+    restore(teardown = false) {
+        for (const [name, value] of this.original) {
+            this.applyValue(name, value);
+        }
+        if (teardown) {
+            this.destroy();
+        }
+    }
+    /**
+     * Clears internal state and self-removes from `restorers`.
+     *
+     * Use this to clean up state without affecting the DOM.
+     */
+    destroy() {
+        // Remove self from restorers if registered
+        if (this.restorers) {
+            const index = this.restorers.findIndex((r) => r.id === this.id);
+            if (index > -1) {
+                this.restorers.splice(index, 1);
+            }
+        }
+        // Clear all state
+        this.items = [];
+        this.original = [];
+        this.currentState = false;
+    }
+    /**
+     * Handles actual DOM attribute manipulation for toggle(), restore().
+     *
+     * @param name
+     *   The attribute name.
+     * @param value
+     *   The value to set. Pass `null` to remove the attribute.
+     */
+    applyValue(name, value) {
+        if (this.el.getAttribute(name) === value) {
+            return;
+        }
+        if (value === null) {
+            this.el.removeAttribute(name);
+        }
+        else {
+            this.el.setAttribute(name, value);
+        }
+    }
+}
+
+module.exports = AttrManager;

package/dist/js/attr-manager.d.ts

@@ -0,0 +1,100 @@
+/**
+ * A type used to define possible values for AttrConfig's `initial` prop.
+ */
+export type AttrInitialValue = "whenTrue" | "whenFalse" | null;
+/**
+ * A type used to define the config option used by the constructor.
+ */
+export type AttrConfig = Record<string, {
+    /** The value set for an attribute when currentState is `true`. */
+    whenTrue: string | null;
+    /** The value set for an attribute when currentState is `false`. */
+    whenFalse?: string | null;
+    /** The value set for an attribute in the constructor. */
+    initial?: AttrInitialValue;
+    /** Whether this attribute will be ignored by `.toggle()`. */
+    fixed?: boolean;
+}>;
+/**
+ * An internal type: guarantees `falseValue` is never undefined.
+ */
+export interface NormalizedAttr {
+    /** The value set for an attribute when currentState is `true`. */
+    trueValue: string | null;
+    /** The value set for an attribute when currentState is `false`. */
+    falseValue: string | null;
+    /** The name of the attribute under management. */
+    name: string;
+    /** Whether this attribute will be ignored by `.toggle()`. */
+    fixed: boolean;
+}
+/**
+ * An entry in the `restorers` array.
+ */
+export interface RestorerEntry {
+    /** Unique ID for self-removal. */
+    id: string;
+    /** Restore method. */
+    restore: () => void;
+}
+/**
+ * A class used to create and/or enforce HTMLElement attribute values.
+ */
+export default class AttrManager {
+    private readonly el;
+    /** Unique ID for self-removal from `restorers` array. */
+    private readonly id;
+    /** An array of the attributes under management in NormalizedAttr form. */
+    private items;
+    /** An array of the attribute values (used to restore initial DOM state). */
+    private original;
+    /** A var used to track the state of the attributes under management. */
+    private currentState;
+    /** Optional reference to the restorer array for self-removal. */
+    private readonly restorers?;
+    /**
+     * Generates a unique ID for this instance.
+     */
+    private static createId;
+    /**
+     * Constructs a new AttrManager instance.
+     *
+     * @param el
+     *   The HTMLElement to manage.
+     * @param config
+     *   The attribute configuration.
+     * @param restorers
+     *   Optional restorer array for lifecycle management.
+     */
+    constructor(el: HTMLElement, config: AttrConfig, restorers?: RestorerEntry[]);
+    /**
+     * Toggles state of attributes managed by this instance.
+     *
+     * @param condition
+     *   The condition to set. If omitted, toggles the current state.
+     */
+    toggle(condition?: boolean): void;
+    /**
+     * Restores original state of attributes.
+     *
+     * @param teardown
+     *   If `true` (default), also clears internal state and self-removes from
+     *   `restorers`.
+     */
+    restore(teardown?: boolean): void;
+    /**
+     * Clears internal state and self-removes from `restorers`.
+     *
+     * Use this to clean up state without affecting the DOM.
+     */
+    destroy(): void;
+    /**
+     * Handles actual DOM attribute manipulation for toggle(), restore().
+     *
+     * @param name
+     *   The attribute name.
+     * @param value
+     *   The value to set. Pass `null` to remove the attribute.
+     */
+    private applyValue;
+}

package/dist/js/attr-manager.esm.js

@@ -0,0 +1,136 @@
+/*! attr-manager 0.2.0 — © Christopher Torgalson */
+/**
+ * A class used to create and/or enforce HTMLElement attribute values.
+ */
+class AttrManager {
+    el;
+    /** Unique ID for self-removal from `restorers` array. */
+    id;
+    /** An array of the attributes under management in NormalizedAttr form. */
+    items = [];
+    /** An array of the attribute values (used to restore initial DOM state). */
+    original = [];
+    /** A var used to track the state of the attributes under management. */
+    currentState = false;
+    /** Optional reference to the restorer array for self-removal. */
+    restorers;
+    /**
+     * Generates a unique ID for this instance.
+     */
+    static createId() {
+        return Math.random().toString(36).slice(2, 7);
+    }
+    /**
+     * Constructs a new AttrManager instance.
+     *
+     * @param el
+     *   The HTMLElement to manage.
+     * @param config
+     *   The attribute configuration.
+     * @param restorers
+     *   Optional restorer array for lifecycle management.
+     */
+    constructor(el, config, restorers) {
+        this.el = el;
+        let hasExplicitInitial = false;
+        // Generate unique ID for self-removal from restorers
+        this.id = AttrManager.createId();
+        for (const [name, { whenTrue: trueValue, whenFalse, initial, fixed },] of Object.entries(config)) {
+            if (trueValue === undefined) {
+                throw new Error("AttrManager: each attribute must supply a `whenTrue` value.");
+            }
+            if (initial !== undefined &&
+                !["whenTrue", "whenFalse", null].includes(initial)) {
+                throw new Error("AttrManager: if attributes supply an `initial` value, it must be one of `whenTrue`, `whenFalse`, or `null`.");
+            }
+            const originalVal = el.getAttribute(name);
+            this.original.push([name, originalVal]);
+            const falseValue = whenFalse !== undefined ? whenFalse : originalVal;
+            this.items.push({ name, trueValue, falseValue, fixed: !!fixed });
+            if (initial !== undefined) {
+                this.applyValue(name, initial === "whenTrue" ? trueValue : falseValue);
+                if (!hasExplicitInitial) {
+                    this.currentState = initial === "whenTrue";
+                    hasExplicitInitial = true;
+                }
+            }
+        }
+        // Register restorer with ID for self-removal
+        if (restorers) {
+            this.restorers = restorers;
+            restorers.push({
+                id: this.id,
+                restore: () => this.restore(),
+            });
+        }
+    }
+    /**
+     * Toggles state of attributes managed by this instance.
+     *
+     * @param condition
+     *   The condition to set. If omitted, toggles the current state.
+     */
+    toggle(condition) {
+        this.currentState = condition ?? !this.currentState;
+        for (const { name, trueValue, falseValue, fixed } of this.items) {
+            if (fixed) {
+                continue;
+            }
+            this.applyValue(name, this.currentState ? trueValue : falseValue);
+        }
+    }
+    /**
+     * Restores original state of attributes.
+     *
+     * @param teardown
+     *   If `true` (default), also clears internal state and self-removes from
+     *   `restorers`.
+     */
+    restore(teardown = false) {
+        for (const [name, value] of this.original) {
+            this.applyValue(name, value);
+        }
+        if (teardown) {
+            this.destroy();
+        }
+    }
+    /**
+     * Clears internal state and self-removes from `restorers`.
+     *
+     * Use this to clean up state without affecting the DOM.
+     */
+    destroy() {
+        // Remove self from restorers if registered
+        if (this.restorers) {
+            const index = this.restorers.findIndex((r) => r.id === this.id);
+            if (index > -1) {
+                this.restorers.splice(index, 1);
+            }
+        }
+        // Clear all state
+        this.items = [];
+        this.original = [];
+        this.currentState = false;
+    }
+    /**
+     * Handles actual DOM attribute manipulation for toggle(), restore().
+     *
+     * @param name
+     *   The attribute name.
+     * @param value
+     *   The value to set. Pass `null` to remove the attribute.
+     */
+    applyValue(name, value) {
+        if (this.el.getAttribute(name) === value) {
+            return;
+        }
+        if (value === null) {
+            this.el.removeAttribute(name);
+        }
+        else {
+            this.el.setAttribute(name, value);
+        }
+    }
+}
+
+export { AttrManager as default };

package/dist/js/attr-manager.esm.min.js

@@ -0,0 +1,2 @@
+/*! attr-manager 0.2.0 — © Christopher Torgalson */
+class AttrManager{el;id;items=[];original=[];currentState=!1;restorers;static createId(){return Math.random().toString(36).slice(2,7)}constructor(t,e,r){this.el=t;let i=!1;this.id=AttrManager.createId();for(const[r,{whenTrue:s,whenFalse:a,initial:n,fixed:l}]of Object.entries(e)){if(void 0===s)throw new Error("AttrManager: each attribute must supply a `whenTrue` value.");if(void 0!==n&&!["whenTrue","whenFalse",null].includes(n))throw new Error("AttrManager: if attributes supply an `initial` value, it must be one of `whenTrue`, `whenFalse`, or `null`.");const e=t.getAttribute(r);this.original.push([r,e]);const o=void 0!==a?a:e;this.items.push({name:r,trueValue:s,falseValue:o,fixed:!!l}),void 0!==n&&(this.applyValue(r,"whenTrue"===n?s:o),i||(this.currentState="whenTrue"===n,i=!0))}r&&(this.restorers=r,r.push({id:this.id,restore:()=>this.restore()}))}toggle(t){this.currentState=t??!this.currentState;for(const{name:t,trueValue:e,falseValue:r,fixed:i}of this.items)i||this.applyValue(t,this.currentState?e:r)}restore(t=!1){for(const[t,e]of this.original)this.applyValue(t,e);t&&this.destroy()}destroy(){if(this.restorers){const t=this.restorers.findIndex(t=>t.id===this.id);t>-1&&this.restorers.splice(t,1)}this.items=[],this.original=[],this.currentState=!1}applyValue(t,e){this.el.getAttribute(t)!==e&&(null===e?this.el.removeAttribute(t):this.el.setAttribute(t,e))}}export{AttrManager as default};

package/dist/js/attr-manager.js

@@ -0,0 +1,144 @@
+/*! attr-manager 0.2.0 — © Christopher Torgalson */
+(function (global, factory) {
+    typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
+    typeof define === 'function' && define.amd ? define(factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.AttrManager = factory());
+})(this, (function () { 'use strict';
+
+    /**
+     * A class used to create and/or enforce HTMLElement attribute values.
+     */
+    class AttrManager {
+        el;
+        /** Unique ID for self-removal from `restorers` array. */
+        id;
+        /** An array of the attributes under management in NormalizedAttr form. */
+        items = [];
+        /** An array of the attribute values (used to restore initial DOM state). */
+        original = [];
+        /** A var used to track the state of the attributes under management. */
+        currentState = false;
+        /** Optional reference to the restorer array for self-removal. */
+        restorers;
+        /**
+         * Generates a unique ID for this instance.
+         */
+        static createId() {
+            return Math.random().toString(36).slice(2, 7);
+        }
+        /**
+         * Constructs a new AttrManager instance.
+         *
+         * @param el
+         *   The HTMLElement to manage.
+         * @param config
+         *   The attribute configuration.
+         * @param restorers
+         *   Optional restorer array for lifecycle management.
+         */
+        constructor(el, config, restorers) {
+            this.el = el;
+            let hasExplicitInitial = false;
+            // Generate unique ID for self-removal from restorers
+            this.id = AttrManager.createId();
+            for (const [name, { whenTrue: trueValue, whenFalse, initial, fixed },] of Object.entries(config)) {
+                if (trueValue === undefined) {
+                    throw new Error("AttrManager: each attribute must supply a `whenTrue` value.");
+                }
+                if (initial !== undefined &&
+                    !["whenTrue", "whenFalse", null].includes(initial)) {
+                    throw new Error("AttrManager: if attributes supply an `initial` value, it must be one of `whenTrue`, `whenFalse`, or `null`.");
+                }
+                const originalVal = el.getAttribute(name);
+                this.original.push([name, originalVal]);
+                const falseValue = whenFalse !== undefined ? whenFalse : originalVal;
+                this.items.push({ name, trueValue, falseValue, fixed: !!fixed });
+                if (initial !== undefined) {
+                    this.applyValue(name, initial === "whenTrue" ? trueValue : falseValue);
+                    if (!hasExplicitInitial) {
+                        this.currentState = initial === "whenTrue";
+                        hasExplicitInitial = true;
+                    }
+                }
+            }
+            // Register restorer with ID for self-removal
+            if (restorers) {
+                this.restorers = restorers;
+                restorers.push({
+                    id: this.id,
+                    restore: () => this.restore(),
+                });
+            }
+        }
+        /**
+         * Toggles state of attributes managed by this instance.
+         *
+         * @param condition
+         *   The condition to set. If omitted, toggles the current state.
+         */
+        toggle(condition) {
+            this.currentState = condition ?? !this.currentState;
+            for (const { name, trueValue, falseValue, fixed } of this.items) {
+                if (fixed) {
+                    continue;
+                }
+                this.applyValue(name, this.currentState ? trueValue : falseValue);
+            }
+        }
+        /**
+         * Restores original state of attributes.
+         *
+         * @param teardown
+         *   If `true` (default), also clears internal state and self-removes from
+         *   `restorers`.
+         */
+        restore(teardown = false) {
+            for (const [name, value] of this.original) {
+                this.applyValue(name, value);
+            }
+            if (teardown) {
+                this.destroy();
+            }
+        }
+        /**
+         * Clears internal state and self-removes from `restorers`.
+         *
+         * Use this to clean up state without affecting the DOM.
+         */
+        destroy() {
+            // Remove self from restorers if registered
+            if (this.restorers) {
+                const index = this.restorers.findIndex((r) => r.id === this.id);
+                if (index > -1) {
+                    this.restorers.splice(index, 1);
+                }
+            }
+            // Clear all state
+            this.items = [];
+            this.original = [];
+            this.currentState = false;
+        }
+        /**
+         * Handles actual DOM attribute manipulation for toggle(), restore().
+         *
+         * @param name
+         *   The attribute name.
+         * @param value
+         *   The value to set. Pass `null` to remove the attribute.
+         */
+        applyValue(name, value) {
+            if (this.el.getAttribute(name) === value) {
+                return;
+            }
+            if (value === null) {
+                this.el.removeAttribute(name);
+            }
+            else {
+                this.el.setAttribute(name, value);
+            }
+        }
+    }
+
+    return AttrManager;
+
+}));

package/dist/js/attr-manager.min.cjs

@@ -0,0 +1,2 @@
+/*! attr-manager 0.2.0 — © Christopher Torgalson */
+class AttrManager{el;id;items=[];original=[];currentState=!1;restorers;static createId(){return Math.random().toString(36).slice(2,7)}constructor(t,e,r){this.el=t;let i=!1;this.id=AttrManager.createId();for(const[r,{whenTrue:s,whenFalse:a,initial:n,fixed:l}]of Object.entries(e)){if(void 0===s)throw new Error("AttrManager: each attribute must supply a `whenTrue` value.");if(void 0!==n&&!["whenTrue","whenFalse",null].includes(n))throw new Error("AttrManager: if attributes supply an `initial` value, it must be one of `whenTrue`, `whenFalse`, or `null`.");const e=t.getAttribute(r);this.original.push([r,e]);const o=void 0!==a?a:e;this.items.push({name:r,trueValue:s,falseValue:o,fixed:!!l}),void 0!==n&&(this.applyValue(r,"whenTrue"===n?s:o),i||(this.currentState="whenTrue"===n,i=!0))}r&&(this.restorers=r,r.push({id:this.id,restore:()=>this.restore()}))}toggle(t){this.currentState=t??!this.currentState;for(const{name:t,trueValue:e,falseValue:r,fixed:i}of this.items)i||this.applyValue(t,this.currentState?e:r)}restore(t=!1){for(const[t,e]of this.original)this.applyValue(t,e);t&&this.destroy()}destroy(){if(this.restorers){const t=this.restorers.findIndex(t=>t.id===this.id);t>-1&&this.restorers.splice(t,1)}this.items=[],this.original=[],this.currentState=!1}applyValue(t,e){this.el.getAttribute(t)!==e&&(null===e?this.el.removeAttribute(t):this.el.setAttribute(t,e))}}module.exports=AttrManager;

package/dist/js/attr-manager.min.js

@@ -0,0 +1,2 @@
+/*! attr-manager 0.2.0 — © Christopher Torgalson */
+var global,factory;global=this,factory=function(){class AttrManager{el;id;items=[];original=[];currentState=!1;restorers;static createId(){return Math.random().toString(36).slice(2,7)}constructor(t,e,r){this.el=t;let i=!1;this.id=AttrManager.createId();for(const[r,{whenTrue:s,whenFalse:a,initial:o,fixed:n}]of Object.entries(e)){if(void 0===s)throw new Error("AttrManager: each attribute must supply a `whenTrue` value.");if(void 0!==o&&!["whenTrue","whenFalse",null].includes(o))throw new Error("AttrManager: if attributes supply an `initial` value, it must be one of `whenTrue`, `whenFalse`, or `null`.");const e=t.getAttribute(r);this.original.push([r,e]);const l=void 0!==a?a:e;this.items.push({name:r,trueValue:s,falseValue:l,fixed:!!n}),void 0!==o&&(this.applyValue(r,"whenTrue"===o?s:l),i||(this.currentState="whenTrue"===o,i=!0))}r&&(this.restorers=r,r.push({id:this.id,restore:()=>this.restore()}))}toggle(t){this.currentState=t??!this.currentState;for(const{name:t,trueValue:e,falseValue:r,fixed:i}of this.items)i||this.applyValue(t,this.currentState?e:r)}restore(t=!1){for(const[t,e]of this.original)this.applyValue(t,e);t&&this.destroy()}destroy(){if(this.restorers){const t=this.restorers.findIndex(t=>t.id===this.id);t>-1&&this.restorers.splice(t,1)}this.items=[],this.original=[],this.currentState=!1}applyValue(t,e){this.el.getAttribute(t)!==e&&(null===e?this.el.removeAttribute(t):this.el.setAttribute(t,e))}}return AttrManager},"object"==typeof exports&&"undefined"!=typeof module?module.exports=factory():"function"==typeof define&&define.amd?define(factory):(global="undefined"!=typeof globalThis?globalThis:global||self).AttrManager=factory();

package/dist/js/bh-attrmanager.cjs

@@ -0,0 +1,2 @@
+/*! bh-attrmanager 0.0.0 — © Christopher Torgalson */
+class BhAttrManager{el;id;items=[];original=[];currentState=!1;restorers;static createId(){return Math.random().toString(36).slice(2,7)}constructor(t,e,r){this.el=t;let i=!1;this.id=BhAttrManager.createId();for(const[r,{whenTrue:s,whenFalse:a,initial:n,fixed:h}]of Object.entries(e)){if(void 0===s)throw new Error("BhAttrManager: each attribute must supply a `whenTrue` value.");if(void 0!==n&&!["whenTrue","whenFalse",null].includes(n))throw new Error("BhAttrManager: if attributes supply an `initial` value, it must be one of `whenTrue`, `whenFalse`, or `null`.");const e=t.getAttribute(r);this.original.push([r,e]);const l=void 0!==a?a:e;this.items.push({name:r,trueValue:s,falseValue:l,fixed:!!h}),void 0!==n&&(this.applyValue(r,"whenTrue"===n?s:l),i||(this.currentState="whenTrue"===n,i=!0))}r&&(this.restorers=r,r.push({id:this.id,restore:()=>this.restore()}))}toggle(t){this.currentState=t??!this.currentState;for(const{name:t,trueValue:e,falseValue:r,fixed:i}of this.items)i||this.applyValue(t,this.currentState?e:r)}restore(t=!1){for(const[t,e]of this.original)this.applyValue(t,e);t&&this.destroy()}destroy(){if(this.restorers){const t=this.restorers.findIndex(t=>t.id===this.id);t>-1&&this.restorers.splice(t,1)}this.items=[],this.original=[],this.currentState=!1}applyValue(t,e){this.el.getAttribute(t)!==e&&(null===e?this.el.removeAttribute(t):this.el.setAttribute(t,e))}}module.exports=BhAttrManager;

package/dist/js/bh-attrmanager.d.ts

@@ -0,0 +1,100 @@
+/**
+ * A type used to define possible values for BhAttrConfig's `initial` prop.
+ */
+export type BhAttrInitialValue = "whenTrue" | "whenFalse" | null;
+/**
+ * A type used to define the config option used by the constructor.
+ */
+export type BhAttrConfig = Record<string, {
+    /** The value set for an attribute when currentState is `true`. */
+    whenTrue: string | null;
+    /** The value set for an attribute when currentState is `false`. */
+    whenFalse?: string | null;
+    /** The value set for an attribute in the constructor. */
+    initial?: BhAttrInitialValue;
+    /** Whether this attribute will be ignored by `.toggle()`. */
+    fixed?: boolean;
+}>;
+/**
+ * An internal type: guarantees `falseValue` is never undefined.
+ */
+export interface BhNormalizedAttr {
+    /** The value set for an attribute when currentState is `true`. */
+    trueValue: string | null;
+    /** The value set for an attribute when currentState is `false`. */
+    falseValue: string | null;
+    /** The name of the attribute under management. */
+    name: string;
+    /** Whether this attribute will be ignored by `.toggle()`. */
+    fixed: boolean;
+}
+/**
+ * An entry in the `restorers` array.
+ */
+export interface BhAttrRestorerEntry {
+    /** Unique ID for self-removal. */
+    id: string;
+    /** Restore method. */
+    restore: () => void;
+}
+/**
+ * A class used to create and/or enforce HTMLElement attribute values.
+ */
+export default class BhAttrManager {
+    private readonly el;
+    /** Unique ID for self-removal from `restorers` array. */
+    private readonly id;
+    /** An array of the attributes under management in BhNormalizedAttr form. */
+    private items;
+    /** An array of the attribute values (used to restore initial DOM state). */
+    private original;
+    /** A var used to track the state of the attributes under management. */
+    private currentState;
+    /** Optional reference to the restorer array for self-removal. */
+    private readonly restorers?;
+    /**
+     * Generates a unique ID for this instance.
+     */
+    private static createId;
+    /**
+     * Constructs a new BhAttrManager instance.
+     *
+     * @param el
+     *   The HTMLElement to manage.
+     * @param config
+     *   The attribute configuration.
+     * @param restorers
+     *   Optional restorer array for lifecycle management.
+     */
+    constructor(el: HTMLElement, config: BhAttrConfig, restorers?: BhAttrRestorerEntry[]);
+    /**
+     * Toggles state of attributes managed by this instance.
+     *
+     * @param condition
+     *   The condition to set. If omitted, toggles the current state.
+     */
+    toggle(condition?: boolean): void;
+    /**
+     * Restores original state of attributes.
+     *
+     * @param teardown
+     *   If `true` (default), also clears internal state and self-removes from
+     *   `restorers`.
+     */
+    restore(teardown?: boolean): void;
+    /**
+     * Clears internal state and self-removes from `restorers`.
+     *
+     * Use this to clean up state without affecting the DOM.
+     */
+    destroy(): void;
+    /**
+     * Handles actual DOM attribute manipulation for toggle(), restore().
+     *
+     * @param name
+     *   The attribute name.
+     * @param value
+     *   The value to set. Pass `null` to remove the attribute.
+     */
+    private applyValue;
+}

package/dist/js/bh-attrmanager.esm.js

@@ -0,0 +1,2 @@
+/*! bh-attrmanager 0.0.0 — © Christopher Torgalson */
+class BhAttrManager{el;id;items=[];original=[];currentState=!1;restorers;static createId(){return Math.random().toString(36).slice(2,7)}constructor(t,e,r){this.el=t;let i=!1;this.id=BhAttrManager.createId();for(const[r,{whenTrue:s,whenFalse:a,initial:n,fixed:h}]of Object.entries(e)){if(void 0===s)throw new Error("BhAttrManager: each attribute must supply a `whenTrue` value.");if(void 0!==n&&!["whenTrue","whenFalse",null].includes(n))throw new Error("BhAttrManager: if attributes supply an `initial` value, it must be one of `whenTrue`, `whenFalse`, or `null`.");const e=t.getAttribute(r);this.original.push([r,e]);const l=void 0!==a?a:e;this.items.push({name:r,trueValue:s,falseValue:l,fixed:!!h}),void 0!==n&&(this.applyValue(r,"whenTrue"===n?s:l),i||(this.currentState="whenTrue"===n,i=!0))}r&&(this.restorers=r,r.push({id:this.id,restore:()=>this.restore()}))}toggle(t){this.currentState=t??!this.currentState;for(const{name:t,trueValue:e,falseValue:r,fixed:i}of this.items)i||this.applyValue(t,this.currentState?e:r)}restore(t=!1){for(const[t,e]of this.original)this.applyValue(t,e);t&&this.destroy()}destroy(){if(this.restorers){const t=this.restorers.findIndex(t=>t.id===this.id);t>-1&&this.restorers.splice(t,1)}this.items=[],this.original=[],this.currentState=!1}applyValue(t,e){this.el.getAttribute(t)!==e&&(null===e?this.el.removeAttribute(t):this.el.setAttribute(t,e))}}export{BhAttrManager as default};