defuddle-js 0.1.0

package/src/url-resolver.js

@@ -0,0 +1,101 @@
+/**
+ * URL resolution utilities for defuddle-js.
+ * Resolves relative URLs to absolute within DOM elements.
+ */
+
+/**
+ * Resolve all relative URLs in a DOM element.
+ * @param {Element} root
+ * @param {Document} doc
+ * @param {string|null} url  Page URL
+ */
+export function resolveUrls(root, doc, url) {
+  if (!url) return;
+
+  // Respect <base href> if present
+  let baseUrl = url;
+  const baseEl = doc.querySelector('base[href]');
+  if (baseEl) {
+    const baseHref = baseEl.getAttribute('href');
+    if (baseHref) {
+      const resolved = resolveUrl(baseHref, url);
+      if (resolved) baseUrl = resolved;
+    }
+  }
+
+  // Resolve href, src, srcset, poster
+  for (const el of root.querySelectorAll('[href]')) {
+    const href = el.getAttribute('href');
+    if (href && !href.startsWith('#')) {
+      el.setAttribute('href', resolveUrl(href, baseUrl));
+    }
+  }
+
+  for (const el of root.querySelectorAll('[src]')) {
+    const src = el.getAttribute('src');
+    if (src) el.setAttribute('src', resolveUrl(src, baseUrl));
+  }
+
+  for (const el of root.querySelectorAll('[srcset]')) {
+    const srcset = el.getAttribute('srcset');
+    if (srcset) el.setAttribute('srcset', resolveSrcset(srcset, baseUrl));
+  }
+
+  for (const el of root.querySelectorAll('[poster]')) {
+    const poster = el.getAttribute('poster');
+    if (poster) el.setAttribute('poster', resolveUrl(poster, baseUrl));
+  }
+}
+
+/**
+ * Resolve a potentially relative URL against a base URL.
+ * @param {string} url
+ * @param {string} base
+ * @returns {string}
+ */
+export function resolveUrl(url, base) {
+  url = url.trim();
+
+  // Skip dangerous schemes
+  if (/^(javascript|data|vbscript):/i.test(url)) return url;
+
+  // Already absolute
+  if (/^[a-z][a-z0-9+\-.]*:\/\//i.test(url)) return url;
+
+  // Fragment only
+  if (url.startsWith('#')) return url;
+
+  try {
+    return new URL(url, base).href;
+  } catch (e) {
+    return url;
+  }
+}
+
+/**
+ * Resolve a srcset attribute value.
+ * @param {string} srcset
+ * @param {string} base
+ * @returns {string}
+ */
+export function resolveSrcset(srcset, base) {
+  // Parse using width/density descriptors as delimiters (not commas)
+  const entryPattern = /(.+?)\s+(\d+(?:\.\d+)?[wx])(?:,|$)/g;
+  const entries = [];
+  let match;
+
+  while ((match = entryPattern.exec(srcset)) !== null) {
+    const rawUrl = match[1].trim().replace(/^,\s*/, '');
+    const descriptor = match[2];
+    entries.push(`${resolveUrl(rawUrl, base)} ${descriptor}`);
+  }
+
+  if (entries.length > 0) return entries.join(', ');
+
+  // Fallback: simple comma split
+  return srcset.split(',').map(entry => {
+    const parts = entry.trim().split(/\s+/);
+    if (parts[0]) parts[0] = resolveUrl(parts[0], base);
+    return parts.join(' ');
+  }).join(', ');
+}

package/src/utils.js

@@ -0,0 +1,95 @@
+/**
+ * Utility functions for defuddle-js
+ */
+
+/**
+ * Count words in a string, CJK-aware.
+ * CJK characters are counted individually as words.
+ * @param {string} text
+ * @returns {number}
+ */
+export function countWords(text) {
+  if (!text || !text.trim()) return 0;
+
+  // Count CJK characters individually
+  const cjkMatches = text.match(
+    /[\u3040-\u309F\u30A0-\u30FF\uAC00-\uD7FF\u4E00-\u9FFF]/g
+  );
+  const cjkCount = cjkMatches ? cjkMatches.length : 0;
+
+  // Remove CJK and count remaining words
+  const nonCjk = text.replace(/[\u3040-\u309F\u30A0-\u30FF\uAC00-\uD7FF\u4E00-\u9FFF]/g, ' ');
+  const nonCjkWords = nonCjk.trim().split(/\s+/).filter(w => w.length > 0).length;
+
+  return cjkCount + nonCjkWords;
+}
+
+/**
+ * Count words in an HTML string (strips tags first).
+ * @param {string} html
+ * @returns {number}
+ */
+export function countHtmlWords(html) {
+  const text = html
+    .replace(/<[^>]*>/g, ' ')
+    .replace(/&nbsp;/gi, ' ')
+    .replace(/&amp;/gi, '&')
+    .replace(/&lt;/gi, '<')
+    .replace(/&gt;/gi, '>')
+    .replace(/&quot;/gi, '"')
+    .replace(/&#\d+;/g, ' ')
+    .replace(/&\w+;/g, ' ');
+  return countWords(text);
+}
+
+/**
+ * Get element's combined class + id string for pattern matching.
+ * @param {Element} el
+ * @returns {string}
+ */
+export function getClassId(el) {
+  return (el.getAttribute('class') || '') + ' ' + (el.getAttribute('id') || '');
+}
+
+/**
+ * Check if el is an ancestor of (or equal to) target.
+ * @param {Element} el
+ * @param {Element} target
+ * @returns {boolean}
+ */
+export function isAncestorOrSelf(el, target) {
+  let node = target;
+  while (node) {
+    if (node === el) return true;
+    node = node.parentElement;
+  }
+  return false;
+}
+
+/**
+ * Get the inner HTML of a DOM element.
+ * Works the same in browser and linkedom/jsdom.
+ * @param {Element} el
+ * @returns {string}
+ */
+export function getInnerHtml(el) {
+  return el.innerHTML;
+}
+
+/**
+ * Safely remove a node from the DOM.
+ * @param {Element} el
+ */
+export function removeNode(el) {
+  if (el && el.parentNode) {
+    el.parentNode.removeChild(el);
+  }
+}
+
+/**
+ * Iterator-safe removal: collect nodes first, then remove.
+ * @param {NodeList|Element[]} nodes
+ */
+export function removeAll(nodes) {
+  Array.from(nodes).forEach(n => removeNode(n));
+}