@y14e/attribute-utils 2.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Yusuke Kamiyamane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# Attribute Utils
+
+For internal use.

package/dist/index.cjs

@@ -0,0 +1,93 @@
+'use strict';
+
+// src/index.ts
+var DEFAULT_PARSER = (value) => value.split(/\s+/);
+var DEFAULT_SERIALIZER = (tokens) => tokens.join(" ");
+function addAttributeToken(element, name, token, options = {}) {
+  const value = element.getAttribute(name)?.trim();
+  const {
+    caseInsensitive = false,
+    parse = DEFAULT_PARSER,
+    serialize = DEFAULT_SERIALIZER
+  } = options;
+  const tokens = value ? parse(value).filter(Boolean) : [];
+  if (caseInsensitive) {
+    const lower = token.toLowerCase();
+    if (tokens.every((token2) => token2.toLowerCase() !== lower)) {
+      tokens.push(token);
+      element.setAttribute(name, serialize(tokens));
+    }
+  } else {
+    const set = new Set(tokens);
+    set.add(token);
+    element.setAttribute(name, serialize([...set]));
+  }
+}
+function removeAttributeToken(element, name, token, options = {}) {
+  const value = element.getAttribute(name)?.trim();
+  if (!value) {
+    return;
+  }
+  const {
+    caseInsensitive = false,
+    parse = DEFAULT_PARSER,
+    serialize = DEFAULT_SERIALIZER
+  } = options;
+  const tokens = parse(value).filter(Boolean);
+  if (!tokens.length) {
+    return;
+  }
+  if (caseInsensitive) {
+    const lower = token.toLowerCase();
+    const filtered = tokens.filter((token2) => token2.toLowerCase() !== lower);
+    if (filtered.length !== tokens.length) {
+      filtered.length ? element.setAttribute(name, serialize(filtered)) : element.removeAttribute(name);
+    }
+  } else {
+    const set = new Set(tokens);
+    set.delete(token);
+    if (set.size !== tokens.length) {
+      set.size ? element.setAttribute(name, serialize([...set])) : element.removeAttribute(name);
+    }
+  }
+}
+var snapshots = /* @__PURE__ */ new WeakMap();
+function restoreAttributes(element_or_elements) {
+  for (const element of Array.isArray(element_or_elements) ? element_or_elements : [element_or_elements]) {
+    const snapshot = snapshots.get(element);
+    if (!snapshot) {
+      continue;
+    }
+    for (const [name, value] of snapshot.entries()) {
+      value === null ? element.removeAttribute(name) : element.setAttribute(name, value);
+    }
+    snapshots.delete(element);
+  }
+}
+function saveAttributes(element_or_elements, name_or_names) {
+  const names = Array.isArray(name_or_names) ? name_or_names : [name_or_names];
+  (Array.isArray(element_or_elements) ? element_or_elements : [element_or_elements]).forEach((element) => {
+    let snapshot = snapshots.get(element);
+    if (!snapshot) {
+      snapshot = /* @__PURE__ */ new Map();
+      snapshots.set(element, snapshot);
+    }
+    names.forEach((name) => {
+      snapshot.set(name, element.getAttribute(name));
+    });
+  });
+}
+/**
+ * Attribute Utils
+ *
+ * @version 2.0.4
+ * @author Yusuke Kamiyamane
+ * @license MIT
+ * @copyright Copyright (c) Yusuke Kamiyamane
+ * @see {@link https://github.com/y14e/attribute-utils}
+ */
+
+exports.addAttributeToken = addAttributeToken;
+exports.removeAttributeToken = removeAttributeToken;
+exports.restoreAttributes = restoreAttributes;
+exports.saveAttributes = saveAttributes;

package/dist/index.d.cts

@@ -0,0 +1,20 @@
+/**
+ * Attribute Utils
+ *
+ * @version 2.0.4
+ * @author Yusuke Kamiyamane
+ * @license MIT
+ * @copyright Copyright (c) Yusuke Kamiyamane
+ * @see {@link https://github.com/y14e/attribute-utils}
+ */
+interface AttributeUtilsOptions {
+    caseInsensitive: boolean;
+    parse: (value: string) => string[];
+    serialize: (tokens: string[]) => string;
+}
+declare function addAttributeToken(element: Element, name: string, token: string, options?: Partial<AttributeUtilsOptions>): void;
+declare function removeAttributeToken(element: Element, name: string, token: string, options?: Partial<AttributeUtilsOptions>): void;
+declare function restoreAttributes(element_or_elements: Element | Element[]): void;
+declare function saveAttributes(element_or_elements: Element | Element[], name_or_names: string | string[]): void;
+
+export { type AttributeUtilsOptions, addAttributeToken, removeAttributeToken, restoreAttributes, saveAttributes };

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Attribute Utils
+ *
+ * @version 2.0.4
+ * @author Yusuke Kamiyamane
+ * @license MIT
+ * @copyright Copyright (c) Yusuke Kamiyamane
+ * @see {@link https://github.com/y14e/attribute-utils}
+ */
+interface AttributeUtilsOptions {
+    caseInsensitive: boolean;
+    parse: (value: string) => string[];
+    serialize: (tokens: string[]) => string;
+}
+declare function addAttributeToken(element: Element, name: string, token: string, options?: Partial<AttributeUtilsOptions>): void;
+declare function removeAttributeToken(element: Element, name: string, token: string, options?: Partial<AttributeUtilsOptions>): void;
+declare function restoreAttributes(element_or_elements: Element | Element[]): void;
+declare function saveAttributes(element_or_elements: Element | Element[], name_or_names: string | string[]): void;
+
+export { type AttributeUtilsOptions, addAttributeToken, removeAttributeToken, restoreAttributes, saveAttributes };

package/dist/index.js

@@ -0,0 +1,88 @@
+// src/index.ts
+var DEFAULT_PARSER = (value) => value.split(/\s+/);
+var DEFAULT_SERIALIZER = (tokens) => tokens.join(" ");
+function addAttributeToken(element, name, token, options = {}) {
+  const value = element.getAttribute(name)?.trim();
+  const {
+    caseInsensitive = false,
+    parse = DEFAULT_PARSER,
+    serialize = DEFAULT_SERIALIZER
+  } = options;
+  const tokens = value ? parse(value).filter(Boolean) : [];
+  if (caseInsensitive) {
+    const lower = token.toLowerCase();
+    if (tokens.every((token2) => token2.toLowerCase() !== lower)) {
+      tokens.push(token);
+      element.setAttribute(name, serialize(tokens));
+    }
+  } else {
+    const set = new Set(tokens);
+    set.add(token);
+    element.setAttribute(name, serialize([...set]));
+  }
+}
+function removeAttributeToken(element, name, token, options = {}) {
+  const value = element.getAttribute(name)?.trim();
+  if (!value) {
+    return;
+  }
+  const {
+    caseInsensitive = false,
+    parse = DEFAULT_PARSER,
+    serialize = DEFAULT_SERIALIZER
+  } = options;
+  const tokens = parse(value).filter(Boolean);
+  if (!tokens.length) {
+    return;
+  }
+  if (caseInsensitive) {
+    const lower = token.toLowerCase();
+    const filtered = tokens.filter((token2) => token2.toLowerCase() !== lower);
+    if (filtered.length !== tokens.length) {
+      filtered.length ? element.setAttribute(name, serialize(filtered)) : element.removeAttribute(name);
+    }
+  } else {
+    const set = new Set(tokens);
+    set.delete(token);
+    if (set.size !== tokens.length) {
+      set.size ? element.setAttribute(name, serialize([...set])) : element.removeAttribute(name);
+    }
+  }
+}
+var snapshots = /* @__PURE__ */ new WeakMap();
+function restoreAttributes(element_or_elements) {
+  for (const element of Array.isArray(element_or_elements) ? element_or_elements : [element_or_elements]) {
+    const snapshot = snapshots.get(element);
+    if (!snapshot) {
+      continue;
+    }
+    for (const [name, value] of snapshot.entries()) {
+      value === null ? element.removeAttribute(name) : element.setAttribute(name, value);
+    }
+    snapshots.delete(element);
+  }
+}
+function saveAttributes(element_or_elements, name_or_names) {
+  const names = Array.isArray(name_or_names) ? name_or_names : [name_or_names];
+  (Array.isArray(element_or_elements) ? element_or_elements : [element_or_elements]).forEach((element) => {
+    let snapshot = snapshots.get(element);
+    if (!snapshot) {
+      snapshot = /* @__PURE__ */ new Map();
+      snapshots.set(element, snapshot);
+    }
+    names.forEach((name) => {
+      snapshot.set(name, element.getAttribute(name));
+    });
+  });
+}
+/**
+ * Attribute Utils
+ *
+ * @version 2.0.4
+ * @author Yusuke Kamiyamane
+ * @license MIT
+ * @copyright Copyright (c) Yusuke Kamiyamane
+ * @see {@link https://github.com/y14e/attribute-utils}
+ */
+
+export { addAttributeToken, removeAttributeToken, restoreAttributes, saveAttributes };

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@y14e/attribute-utils",
+  "version": "2.0.4",
+  "description": "",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [],
+  "author": "Yusuke Kamiyamane",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/y14e/attribute-utils.git"
+  },
+  "bugs": {
+    "url": "https://github.com/y14e/attribute-utils/issues"
+  },
+  "homepage": "https://github.com/y14e/attribute-utils#readme",
+  "devDependencies": {
+    "bun-types": "latest",
+    "tsup": "^8.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "allowScripts": {
+    "esbuild": true
+  }
+}