@lytjs/common-dom 6.0.0

package/dist/index.cjs

@@ -0,0 +1,172 @@
+'use strict';
+
+var commonString = require('@lytjs/common-string');
+var commonError = require('@lytjs/common-error');
+
+// src/index.ts
+var SVG_TAGS = /* @__PURE__ */ new Set([
+  // Basic shapes
+  "svg",
+  "path",
+  "circle",
+  "ellipse",
+  "line",
+  "polyline",
+  "polygon",
+  "rect",
+  // Groups & containers
+  "g",
+  "defs",
+  "use",
+  "clipPath",
+  "mask",
+  "symbol",
+  "marker",
+  "pattern",
+  "foreignObject",
+  "image",
+  // Text
+  "text",
+  "tspan",
+  "textPath",
+  // Gradients
+  "linearGradient",
+  "radialGradient",
+  "stop",
+  // Filters
+  "filter",
+  "feBlend",
+  "feColorMatrix",
+  "feComponentTransfer",
+  "feComposite",
+  "feConvolveMatrix",
+  "feDiffuseLighting",
+  "feDisplacementMap",
+  "feDistantLight",
+  "feFlood",
+  "feGaussianBlur",
+  "feImage",
+  "feMerge",
+  "feMergeNode",
+  "feMorphology",
+  "feOffset",
+  "fePointLight",
+  "feSpecularLighting",
+  "feSpotLight",
+  "feTile",
+  "feTurbulence",
+  // Animation
+  "animate",
+  "animateTransform",
+  "animateMotion",
+  "set"
+]);
+var SVG_NS = "http://www.w3.org/2000/svg";
+function isSVGTag(tag) {
+  return SVG_TAGS.has(tag);
+}
+function patchClass(el, prev, next) {
+  const el_ = el;
+  const prevClass = prev == null ? "" : String(prev);
+  const nextClass = next == null ? "" : String(next);
+  if (prevClass !== nextClass) {
+    el_.className = nextClass;
+  }
+}
+function patchStyle(el, prev, next) {
+  const el_ = el;
+  const style = el_.style;
+  if (!next || next === "") {
+    el_.removeAttribute("style");
+    return;
+  }
+  const prevStyle = prev;
+  const nextStyle = next;
+  if (nextStyle && typeof nextStyle !== "object" && typeof nextStyle !== "string") {
+    return;
+  }
+  if (typeof nextStyle === "string") {
+    if (prevStyle && typeof prevStyle !== "string") {
+      for (const key in prevStyle) {
+        style.removeProperty(commonString.camelToKebab(key));
+      }
+    }
+    el_.setAttribute("style", nextStyle);
+    return;
+  }
+  if (prevStyle && typeof prevStyle !== "string") {
+    for (const key in prevStyle) {
+      if (!(key in nextStyle)) {
+        style.removeProperty(commonString.camelToKebab(key));
+      }
+    }
+  } else if (typeof prevStyle === "string") {
+    el_.removeAttribute("style");
+  }
+  for (const key in nextStyle) {
+    const val = nextStyle[key];
+    if (val != null && val !== "") {
+      style.setProperty(commonString.camelToKebab(key), String(val));
+    } else {
+      style.removeProperty(commonString.camelToKebab(key));
+    }
+  }
+}
+function patchAttr(el, key, value, _isSVG) {
+  if (value == null || value === false) {
+    el.removeAttribute(key);
+  } else if (commonString.isBooleanAttr(key)) {
+    if (value === true || value === "") {
+      el.setAttribute(key, "");
+    } else {
+      const strValue = typeof value === "string" ? value : String(value);
+      if (!commonString.isSafeAttribute(key, strValue)) {
+        if (__DEV__) {
+          commonError.warn(`Unsafe attribute "${key}" with value "${strValue}" has been blocked.`);
+        }
+        return;
+      }
+      el.setAttribute(key, strValue);
+    }
+  } else {
+    const strValue = typeof value === "string" ? value : String(value);
+    if (!commonString.isSafeAttribute(key, strValue)) {
+      if (__DEV__) {
+        commonError.warn(`Unsafe attribute "${key}" with value "${strValue}" has been blocked.`);
+      }
+      return;
+    }
+    el.setAttribute(key, strValue);
+  }
+}
+function patchProp(el, key, prevValue, nextValue, isSVG = false) {
+  if (key === "class") {
+    patchClass(el, prevValue, nextValue);
+  } else if (key === "style") {
+    patchStyle(el, prevValue, nextValue);
+  } else if (key === "innerHTML") {
+    if (nextValue !== prevValue) {
+      if (__DEV__ && nextValue != null && typeof nextValue !== "string") {
+        commonError.warn("v-html expects a string value.");
+      }
+      const sanitized = nextValue == null ? "" : commonString.sanitizeHTML(String(nextValue));
+      el.innerHTML = sanitized;
+    }
+  } else if (key === "textContent") {
+    if (nextValue !== prevValue) {
+      el.textContent = nextValue == null ? "" : String(nextValue);
+    }
+  } else {
+    patchAttr(el, key, nextValue);
+  }
+}
+
+exports.SVG_NS = SVG_NS;
+exports.SVG_TAGS = SVG_TAGS;
+exports.isSVGTag = isSVGTag;
+exports.patchAttr = patchAttr;
+exports.patchClass = patchClass;
+exports.patchProp = patchProp;
+exports.patchStyle = patchStyle;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["camelToKebab","isBooleanAttr","isSafeAttribute","warn","sanitizeHTML"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * @lytjs/common-dom - Shared DOM utilities for Lyt.js\r\n *\r\n * Provides unified SVG tag detection, DOM property patching functions\r\n * (patchClass, patchStyle, patchAttr, patchProp) shared between\r\n * @lytjs/vdom and @lytjs/renderer.\r\n *\r\n * @module @lytjs/common-dom\r\n * @version 0.1.0\r\n */\r\n\r\n// ==================== Imports ====================\r\n\r\nimport { camelToKebab, isSafeAttribute, sanitizeHTML, isBooleanAttr } from '@lytjs/common-string';\r\nimport { warn } from '@lytjs/common-error';\r\n\r\n// Global dev flag declaration (injected by build tool)\r\ndeclare const __DEV__: boolean;\r\n\r\n// ==================== SVG Constants ====================\r\n\r\n/**\r\n * Complete set of SVG elements that require the SVG namespace.\r\n * Merged from @lytjs/vdom and @lytjs/renderer (union of both sets).\r\n */\r\nexport const SVG_TAGS = new Set([\r\n  // Basic shapes\r\n  'svg',\r\n  'path',\r\n  'circle',\r\n  'ellipse',\r\n  'line',\r\n  'polyline',\r\n  'polygon',\r\n  'rect',\r\n  // Groups & containers\r\n  'g',\r\n  'defs',\r\n  'use',\r\n  'clipPath',\r\n  'mask',\r\n  'symbol',\r\n  'marker',\r\n  'pattern',\r\n  'foreignObject',\r\n  'image',\r\n  // Text\r\n  'text',\r\n  'tspan',\r\n  'textPath',\r\n  // Gradients\r\n  'linearGradient',\r\n  'radialGradient',\r\n  'stop',\r\n  // Filters\r\n  'filter',\r\n  'feBlend',\r\n  'feColorMatrix',\r\n  'feComponentTransfer',\r\n  'feComposite',\r\n  'feConvolveMatrix',\r\n  'feDiffuseLighting',\r\n  'feDisplacementMap',\r\n  'feDistantLight',\r\n  'feFlood',\r\n  'feGaussianBlur',\r\n  'feImage',\r\n  'feMerge',\r\n  'feMergeNode',\r\n  'feMorphology',\r\n  'feOffset',\r\n  'fePointLight',\r\n  'feSpecularLighting',\r\n  'feSpotLight',\r\n  'feTile',\r\n  'feTurbulence',\r\n  // Animation\r\n  'animate',\r\n  'animateTransform',\r\n  'animateMotion',\r\n  'set',\r\n]);\r\n\r\n/** SVG namespace URI */\r\nexport const SVG_NS = 'http://www.w3.org/2000/svg';\r\n\r\n/**\r\n * Check if a tag name is an SVG element\r\n */\r\nexport function isSVGTag(tag: string): boolean {\r\n  return SVG_TAGS.has(tag);\r\n}\r\n\r\n// ==================== patchClass ====================\r\n\r\n/**\r\n * Patch the class attribute on an element.\r\n * Uses String() conversion for robust null/undefined handling.\r\n */\r\nexport function patchClass(el: Element, prev: unknown, next: unknown): void {\r\n  const el_ = el as HTMLElement;\r\n  const prevClass = prev == null ? '' : String(prev);\r\n  const nextClass = next == null ? '' : String(next);\r\n  if (prevClass !== nextClass) {\r\n    el_.className = nextClass;\r\n  }\r\n}\r\n\r\n// ==================== patchStyle ====================\r\n\r\n/**\r\n * Patch the style attribute on an element.\r\n * Handles string <-> object transitions, camelCase <-> kebab-case conversion,\r\n * and proper property removal via removeProperty.\r\n */\r\nexport function patchStyle(el: Element, prev: unknown, next: unknown): void {\r\n  const el_ = el as HTMLElement;\r\n  const style = el_.style;\r\n\r\n  if (!next || next === '') {\r\n    el_.removeAttribute('style');\r\n    return;\r\n  }\r\n\r\n  const prevStyle = prev as Record<string, string | number> | null | undefined;\r\n  const nextStyle = next as Record<string, string | number> | string;\r\n\r\n  if (nextStyle && typeof nextStyle !== 'object' && typeof nextStyle !== 'string') {\r\n    return;\r\n  }\r\n\r\n  if (typeof nextStyle === 'string') {\r\n    if (prevStyle && typeof prevStyle !== 'string') {\r\n      // Was object, now string - clear all inline styles\r\n      for (const key in prevStyle) {\r\n        style.removeProperty(camelToKebab(key));\r\n      }\r\n    }\r\n    el_.setAttribute('style', nextStyle);\r\n    return;\r\n  }\r\n\r\n  // nextStyle is an object\r\n  if (prevStyle && typeof prevStyle !== 'string') {\r\n    // Remove keys that existed in prev but not in next\r\n    for (const key in prevStyle) {\r\n      if (!(key in nextStyle)) {\r\n        style.removeProperty(camelToKebab(key));\r\n      }\r\n    }\r\n  } else if (typeof prevStyle === 'string') {\r\n    // Was string, now object - clear the string style\r\n    el_.removeAttribute('style');\r\n  }\r\n\r\n  // Apply all new styles\r\n  for (const key in nextStyle) {\r\n    const val = nextStyle[key];\r\n    if (val != null && val !== '') {\r\n      style.setProperty(camelToKebab(key), String(val));\r\n    } else {\r\n      style.removeProperty(camelToKebab(key));\r\n    }\r\n  }\r\n}\r\n\r\n// ==================== patchAttr ====================\r\n\r\n/**\r\n * Patch a regular or boolean attribute on an element.\r\n * Includes safety checks via isSafeAttribute.\r\n */\r\nexport function patchAttr(el: Element, key: string, value: unknown, _isSVG: boolean): void {\r\n  if (value == null || value === false) {\r\n    el.removeAttribute(key);\r\n  } else if (isBooleanAttr(key)) {\r\n    if (value === true || value === '') {\r\n      el.setAttribute(key, '');\r\n    } else {\r\n      const strValue = typeof value === 'string' ? value : String(value);\r\n      if (!isSafeAttribute(key, strValue)) {\r\n        if (__DEV__) {\r\n          warn(`Unsafe attribute \"${key}\" with value \"${strValue}\" has been blocked.`);\r\n        }\r\n        return;\r\n      }\r\n      el.setAttribute(key, strValue);\r\n    }\r\n  } else {\r\n    const strValue = typeof value === 'string' ? value : String(value);\r\n    if (!isSafeAttribute(key, strValue)) {\r\n      if (__DEV__) {\r\n        warn(`Unsafe attribute \"${key}\" with value \"${strValue}\" has been blocked.`);\r\n      }\r\n      return;\r\n    }\r\n    el.setAttribute(key, strValue);\r\n  }\r\n}\r\n\r\n// ==================== patchProp ====================\r\n\r\n/**\r\n * Patch a prop on a DOM element.\r\n * Dispatches to specialized handlers for class, style, events, and attributes.\r\n *\r\n * Note: Event handling is intentionally NOT included here. Consumers\r\n * (vdom/renderer) should handle events themselves based on their\r\n * chosen strategy (direct binding vs invoker pattern).\r\n */\r\nexport function patchProp(\r\n  el: Element,\r\n  key: string,\r\n  prevValue: unknown,\r\n  nextValue: unknown,\r\n  isSVG: boolean = false,\r\n): void {\r\n  if (key === 'class') {\r\n    patchClass(el, prevValue, nextValue);\r\n  } else if (key === 'style') {\r\n    patchStyle(el, prevValue, nextValue);\r\n  } else if (key === 'innerHTML') {\r\n    if (nextValue !== prevValue) {\r\n      if (__DEV__ && nextValue != null && typeof nextValue !== 'string') {\r\n        warn('v-html expects a string value.');\r\n      }\r\n      const sanitized = nextValue == null ? '' : sanitizeHTML(String(nextValue));\r\n      el.innerHTML = sanitized;\r\n    }\r\n  } else if (key === 'textContent') {\r\n    if (nextValue !== prevValue) {\r\n      el.textContent = nextValue == null ? '' : String(nextValue);\r\n    }\r\n  } else {\r\n    patchAttr(el, key, nextValue, isSVG);\r\n  }\r\n}\r\n"]}

package/dist/index.d.mts

@@ -0,0 +1,48 @@
+/**
+ * @lytjs/common-dom - Shared DOM utilities for Lyt.js
+ *
+ * Provides unified SVG tag detection, DOM property patching functions
+ * (patchClass, patchStyle, patchAttr, patchProp) shared between
+ * @lytjs/vdom and @lytjs/renderer.
+ *
+ * @module @lytjs/common-dom
+ * @version 0.1.0
+ */
+/**
+ * Complete set of SVG elements that require the SVG namespace.
+ * Merged from @lytjs/vdom and @lytjs/renderer (union of both sets).
+ */
+declare const SVG_TAGS: Set<string>;
+/** SVG namespace URI */
+declare const SVG_NS = "http://www.w3.org/2000/svg";
+/**
+ * Check if a tag name is an SVG element
+ */
+declare function isSVGTag(tag: string): boolean;
+/**
+ * Patch the class attribute on an element.
+ * Uses String() conversion for robust null/undefined handling.
+ */
+declare function patchClass(el: Element, prev: unknown, next: unknown): void;
+/**
+ * Patch the style attribute on an element.
+ * Handles string <-> object transitions, camelCase <-> kebab-case conversion,
+ * and proper property removal via removeProperty.
+ */
+declare function patchStyle(el: Element, prev: unknown, next: unknown): void;
+/**
+ * Patch a regular or boolean attribute on an element.
+ * Includes safety checks via isSafeAttribute.
+ */
+declare function patchAttr(el: Element, key: string, value: unknown, _isSVG: boolean): void;
+/**
+ * Patch a prop on a DOM element.
+ * Dispatches to specialized handlers for class, style, events, and attributes.
+ *
+ * Note: Event handling is intentionally NOT included here. Consumers
+ * (vdom/renderer) should handle events themselves based on their
+ * chosen strategy (direct binding vs invoker pattern).
+ */
+declare function patchProp(el: Element, key: string, prevValue: unknown, nextValue: unknown, isSVG?: boolean): void;
+
+export { SVG_NS, SVG_TAGS, isSVGTag, patchAttr, patchClass, patchProp, patchStyle };

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @lytjs/common-dom - Shared DOM utilities for Lyt.js
+ *
+ * Provides unified SVG tag detection, DOM property patching functions
+ * (patchClass, patchStyle, patchAttr, patchProp) shared between
+ * @lytjs/vdom and @lytjs/renderer.
+ *
+ * @module @lytjs/common-dom
+ * @version 0.1.0
+ */
+/**
+ * Complete set of SVG elements that require the SVG namespace.
+ * Merged from @lytjs/vdom and @lytjs/renderer (union of both sets).
+ */
+declare const SVG_TAGS: Set<string>;
+/** SVG namespace URI */
+declare const SVG_NS = "http://www.w3.org/2000/svg";
+/**
+ * Check if a tag name is an SVG element
+ */
+declare function isSVGTag(tag: string): boolean;
+/**
+ * Patch the class attribute on an element.
+ * Uses String() conversion for robust null/undefined handling.
+ */
+declare function patchClass(el: Element, prev: unknown, next: unknown): void;
+/**
+ * Patch the style attribute on an element.
+ * Handles string <-> object transitions, camelCase <-> kebab-case conversion,
+ * and proper property removal via removeProperty.
+ */
+declare function patchStyle(el: Element, prev: unknown, next: unknown): void;
+/**
+ * Patch a regular or boolean attribute on an element.
+ * Includes safety checks via isSafeAttribute.
+ */
+declare function patchAttr(el: Element, key: string, value: unknown, _isSVG: boolean): void;
+/**
+ * Patch a prop on a DOM element.
+ * Dispatches to specialized handlers for class, style, events, and attributes.
+ *
+ * Note: Event handling is intentionally NOT included here. Consumers
+ * (vdom/renderer) should handle events themselves based on their
+ * chosen strategy (direct binding vs invoker pattern).
+ */
+declare function patchProp(el: Element, key: string, prevValue: unknown, nextValue: unknown, isSVG?: boolean): void;
+
+export { SVG_NS, SVG_TAGS, isSVGTag, patchAttr, patchClass, patchProp, patchStyle };

package/dist/index.mjs

@@ -0,0 +1,164 @@
+import { camelToKebab, isBooleanAttr, isSafeAttribute, sanitizeHTML } from '@lytjs/common-string';
+import { warn } from '@lytjs/common-error';
+
+// src/index.ts
+var SVG_TAGS = /* @__PURE__ */ new Set([
+  // Basic shapes
+  "svg",
+  "path",
+  "circle",
+  "ellipse",
+  "line",
+  "polyline",
+  "polygon",
+  "rect",
+  // Groups & containers
+  "g",
+  "defs",
+  "use",
+  "clipPath",
+  "mask",
+  "symbol",
+  "marker",
+  "pattern",
+  "foreignObject",
+  "image",
+  // Text
+  "text",
+  "tspan",
+  "textPath",
+  // Gradients
+  "linearGradient",
+  "radialGradient",
+  "stop",
+  // Filters
+  "filter",
+  "feBlend",
+  "feColorMatrix",
+  "feComponentTransfer",
+  "feComposite",
+  "feConvolveMatrix",
+  "feDiffuseLighting",
+  "feDisplacementMap",
+  "feDistantLight",
+  "feFlood",
+  "feGaussianBlur",
+  "feImage",
+  "feMerge",
+  "feMergeNode",
+  "feMorphology",
+  "feOffset",
+  "fePointLight",
+  "feSpecularLighting",
+  "feSpotLight",
+  "feTile",
+  "feTurbulence",
+  // Animation
+  "animate",
+  "animateTransform",
+  "animateMotion",
+  "set"
+]);
+var SVG_NS = "http://www.w3.org/2000/svg";
+function isSVGTag(tag) {
+  return SVG_TAGS.has(tag);
+}
+function patchClass(el, prev, next) {
+  const el_ = el;
+  const prevClass = prev == null ? "" : String(prev);
+  const nextClass = next == null ? "" : String(next);
+  if (prevClass !== nextClass) {
+    el_.className = nextClass;
+  }
+}
+function patchStyle(el, prev, next) {
+  const el_ = el;
+  const style = el_.style;
+  if (!next || next === "") {
+    el_.removeAttribute("style");
+    return;
+  }
+  const prevStyle = prev;
+  const nextStyle = next;
+  if (nextStyle && typeof nextStyle !== "object" && typeof nextStyle !== "string") {
+    return;
+  }
+  if (typeof nextStyle === "string") {
+    if (prevStyle && typeof prevStyle !== "string") {
+      for (const key in prevStyle) {
+        style.removeProperty(camelToKebab(key));
+      }
+    }
+    el_.setAttribute("style", nextStyle);
+    return;
+  }
+  if (prevStyle && typeof prevStyle !== "string") {
+    for (const key in prevStyle) {
+      if (!(key in nextStyle)) {
+        style.removeProperty(camelToKebab(key));
+      }
+    }
+  } else if (typeof prevStyle === "string") {
+    el_.removeAttribute("style");
+  }
+  for (const key in nextStyle) {
+    const val = nextStyle[key];
+    if (val != null && val !== "") {
+      style.setProperty(camelToKebab(key), String(val));
+    } else {
+      style.removeProperty(camelToKebab(key));
+    }
+  }
+}
+function patchAttr(el, key, value, _isSVG) {
+  if (value == null || value === false) {
+    el.removeAttribute(key);
+  } else if (isBooleanAttr(key)) {
+    if (value === true || value === "") {
+      el.setAttribute(key, "");
+    } else {
+      const strValue = typeof value === "string" ? value : String(value);
+      if (!isSafeAttribute(key, strValue)) {
+        if (__DEV__) {
+          warn(`Unsafe attribute "${key}" with value "${strValue}" has been blocked.`);
+        }
+        return;
+      }
+      el.setAttribute(key, strValue);
+    }
+  } else {
+    const strValue = typeof value === "string" ? value : String(value);
+    if (!isSafeAttribute(key, strValue)) {
+      if (__DEV__) {
+        warn(`Unsafe attribute "${key}" with value "${strValue}" has been blocked.`);
+      }
+      return;
+    }
+    el.setAttribute(key, strValue);
+  }
+}
+function patchProp(el, key, prevValue, nextValue, isSVG = false) {
+  if (key === "class") {
+    patchClass(el, prevValue, nextValue);
+  } else if (key === "style") {
+    patchStyle(el, prevValue, nextValue);
+  } else if (key === "innerHTML") {
+    if (nextValue !== prevValue) {
+      if (__DEV__ && nextValue != null && typeof nextValue !== "string") {
+        warn("v-html expects a string value.");
+      }
+      const sanitized = nextValue == null ? "" : sanitizeHTML(String(nextValue));
+      el.innerHTML = sanitized;
+    }
+  } else if (key === "textContent") {
+    if (nextValue !== prevValue) {
+      el.textContent = nextValue == null ? "" : String(nextValue);
+    }
+  } else {
+    patchAttr(el, key, nextValue);
+  }
+}
+
+export { SVG_NS, SVG_TAGS, isSVGTag, patchAttr, patchClass, patchProp, patchStyle };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\r\n * @lytjs/common-dom - Shared DOM utilities for Lyt.js\r\n *\r\n * Provides unified SVG tag detection, DOM property patching functions\r\n * (patchClass, patchStyle, patchAttr, patchProp) shared between\r\n * @lytjs/vdom and @lytjs/renderer.\r\n *\r\n * @module @lytjs/common-dom\r\n * @version 0.1.0\r\n */\r\n\r\n// ==================== Imports ====================\r\n\r\nimport { camelToKebab, isSafeAttribute, sanitizeHTML, isBooleanAttr } from '@lytjs/common-string';\r\nimport { warn } from '@lytjs/common-error';\r\n\r\n// Global dev flag declaration (injected by build tool)\r\ndeclare const __DEV__: boolean;\r\n\r\n// ==================== SVG Constants ====================\r\n\r\n/**\r\n * Complete set of SVG elements that require the SVG namespace.\r\n * Merged from @lytjs/vdom and @lytjs/renderer (union of both sets).\r\n */\r\nexport const SVG_TAGS = new Set([\r\n  // Basic shapes\r\n  'svg',\r\n  'path',\r\n  'circle',\r\n  'ellipse',\r\n  'line',\r\n  'polyline',\r\n  'polygon',\r\n  'rect',\r\n  // Groups & containers\r\n  'g',\r\n  'defs',\r\n  'use',\r\n  'clipPath',\r\n  'mask',\r\n  'symbol',\r\n  'marker',\r\n  'pattern',\r\n  'foreignObject',\r\n  'image',\r\n  // Text\r\n  'text',\r\n  'tspan',\r\n  'textPath',\r\n  // Gradients\r\n  'linearGradient',\r\n  'radialGradient',\r\n  'stop',\r\n  // Filters\r\n  'filter',\r\n  'feBlend',\r\n  'feColorMatrix',\r\n  'feComponentTransfer',\r\n  'feComposite',\r\n  'feConvolveMatrix',\r\n  'feDiffuseLighting',\r\n  'feDisplacementMap',\r\n  'feDistantLight',\r\n  'feFlood',\r\n  'feGaussianBlur',\r\n  'feImage',\r\n  'feMerge',\r\n  'feMergeNode',\r\n  'feMorphology',\r\n  'feOffset',\r\n  'fePointLight',\r\n  'feSpecularLighting',\r\n  'feSpotLight',\r\n  'feTile',\r\n  'feTurbulence',\r\n  // Animation\r\n  'animate',\r\n  'animateTransform',\r\n  'animateMotion',\r\n  'set',\r\n]);\r\n\r\n/** SVG namespace URI */\r\nexport const SVG_NS = 'http://www.w3.org/2000/svg';\r\n\r\n/**\r\n * Check if a tag name is an SVG element\r\n */\r\nexport function isSVGTag(tag: string): boolean {\r\n  return SVG_TAGS.has(tag);\r\n}\r\n\r\n// ==================== patchClass ====================\r\n\r\n/**\r\n * Patch the class attribute on an element.\r\n * Uses String() conversion for robust null/undefined handling.\r\n */\r\nexport function patchClass(el: Element, prev: unknown, next: unknown): void {\r\n  const el_ = el as HTMLElement;\r\n  const prevClass = prev == null ? '' : String(prev);\r\n  const nextClass = next == null ? '' : String(next);\r\n  if (prevClass !== nextClass) {\r\n    el_.className = nextClass;\r\n  }\r\n}\r\n\r\n// ==================== patchStyle ====================\r\n\r\n/**\r\n * Patch the style attribute on an element.\r\n * Handles string <-> object transitions, camelCase <-> kebab-case conversion,\r\n * and proper property removal via removeProperty.\r\n */\r\nexport function patchStyle(el: Element, prev: unknown, next: unknown): void {\r\n  const el_ = el as HTMLElement;\r\n  const style = el_.style;\r\n\r\n  if (!next || next === '') {\r\n    el_.removeAttribute('style');\r\n    return;\r\n  }\r\n\r\n  const prevStyle = prev as Record<string, string | number> | null | undefined;\r\n  const nextStyle = next as Record<string, string | number> | string;\r\n\r\n  if (nextStyle && typeof nextStyle !== 'object' && typeof nextStyle !== 'string') {\r\n    return;\r\n  }\r\n\r\n  if (typeof nextStyle === 'string') {\r\n    if (prevStyle && typeof prevStyle !== 'string') {\r\n      // Was object, now string - clear all inline styles\r\n      for (const key in prevStyle) {\r\n        style.removeProperty(camelToKebab(key));\r\n      }\r\n    }\r\n    el_.setAttribute('style', nextStyle);\r\n    return;\r\n  }\r\n\r\n  // nextStyle is an object\r\n  if (prevStyle && typeof prevStyle !== 'string') {\r\n    // Remove keys that existed in prev but not in next\r\n    for (const key in prevStyle) {\r\n      if (!(key in nextStyle)) {\r\n        style.removeProperty(camelToKebab(key));\r\n      }\r\n    }\r\n  } else if (typeof prevStyle === 'string') {\r\n    // Was string, now object - clear the string style\r\n    el_.removeAttribute('style');\r\n  }\r\n\r\n  // Apply all new styles\r\n  for (const key in nextStyle) {\r\n    const val = nextStyle[key];\r\n    if (val != null && val !== '') {\r\n      style.setProperty(camelToKebab(key), String(val));\r\n    } else {\r\n      style.removeProperty(camelToKebab(key));\r\n    }\r\n  }\r\n}\r\n\r\n// ==================== patchAttr ====================\r\n\r\n/**\r\n * Patch a regular or boolean attribute on an element.\r\n * Includes safety checks via isSafeAttribute.\r\n */\r\nexport function patchAttr(el: Element, key: string, value: unknown, _isSVG: boolean): void {\r\n  if (value == null || value === false) {\r\n    el.removeAttribute(key);\r\n  } else if (isBooleanAttr(key)) {\r\n    if (value === true || value === '') {\r\n      el.setAttribute(key, '');\r\n    } else {\r\n      const strValue = typeof value === 'string' ? value : String(value);\r\n      if (!isSafeAttribute(key, strValue)) {\r\n        if (__DEV__) {\r\n          warn(`Unsafe attribute \"${key}\" with value \"${strValue}\" has been blocked.`);\r\n        }\r\n        return;\r\n      }\r\n      el.setAttribute(key, strValue);\r\n    }\r\n  } else {\r\n    const strValue = typeof value === 'string' ? value : String(value);\r\n    if (!isSafeAttribute(key, strValue)) {\r\n      if (__DEV__) {\r\n        warn(`Unsafe attribute \"${key}\" with value \"${strValue}\" has been blocked.`);\r\n      }\r\n      return;\r\n    }\r\n    el.setAttribute(key, strValue);\r\n  }\r\n}\r\n\r\n// ==================== patchProp ====================\r\n\r\n/**\r\n * Patch a prop on a DOM element.\r\n * Dispatches to specialized handlers for class, style, events, and attributes.\r\n *\r\n * Note: Event handling is intentionally NOT included here. Consumers\r\n * (vdom/renderer) should handle events themselves based on their\r\n * chosen strategy (direct binding vs invoker pattern).\r\n */\r\nexport function patchProp(\r\n  el: Element,\r\n  key: string,\r\n  prevValue: unknown,\r\n  nextValue: unknown,\r\n  isSVG: boolean = false,\r\n): void {\r\n  if (key === 'class') {\r\n    patchClass(el, prevValue, nextValue);\r\n  } else if (key === 'style') {\r\n    patchStyle(el, prevValue, nextValue);\r\n  } else if (key === 'innerHTML') {\r\n    if (nextValue !== prevValue) {\r\n      if (__DEV__ && nextValue != null && typeof nextValue !== 'string') {\r\n        warn('v-html expects a string value.');\r\n      }\r\n      const sanitized = nextValue == null ? '' : sanitizeHTML(String(nextValue));\r\n      el.innerHTML = sanitized;\r\n    }\r\n  } else if (key === 'textContent') {\r\n    if (nextValue !== prevValue) {\r\n      el.textContent = nextValue == null ? '' : String(nextValue);\r\n    }\r\n  } else {\r\n    patchAttr(el, key, nextValue, isSVG);\r\n  }\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@lytjs/common-dom",
+  "version": "6.0.0",
+  "description": "Shared DOM utilities for Lyt.js - SVG tags, patchClass, patchStyle, patchAttr, patchProp",
+  "keywords": [
+    "lytjs",
+    "dom",
+    "svg",
+    "patch"
+  ],
+  "license": "MIT",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist .tsbuildinfo"
+  },
+  "dependencies": {
+    "@lytjs/common-is": "^6.0.0",
+    "@lytjs/common-string": "^6.0.0",
+    "@lytjs/common-events": "^6.0.0",
+    "@lytjs/common-error": "^6.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.2",
+    "tsup": "^8.4.0",
+    "vitest": "^3.0.0",
+    "jsdom": "^24.0.0"
+  }
+}