npm - portapack - Versions diffs - 0.3.1 → 0.3.3 - Mend

portapack 0.3.1 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (74) hide show

package/.eslintrc.json +67 -8
package/.releaserc.js +25 -27
package/CHANGELOG.md +14 -22
package/LICENSE.md +21 -0
package/README.md +22 -53
package/commitlint.config.js +30 -34
package/dist/cli/cli-entry.cjs +183 -98
package/dist/cli/cli-entry.cjs.map +1 -1
package/dist/index.d.ts +0 -3
package/dist/index.js +178 -97
package/dist/index.js.map +1 -1
package/docs/.vitepress/config.ts +38 -33
package/docs/.vitepress/sidebar-generator.ts +89 -38
package/docs/architecture.md +186 -0
package/docs/cli.md +23 -23
package/docs/code-of-conduct.md +7 -1
package/docs/configuration.md +12 -11
package/docs/contributing.md +6 -2
package/docs/deployment.md +10 -5
package/docs/development.md +8 -5
package/docs/getting-started.md +13 -13
package/docs/index.md +1 -1
package/docs/public/android-chrome-192x192.png +0 -0
package/docs/public/android-chrome-512x512.png +0 -0
package/docs/public/apple-touch-icon.png +0 -0
package/docs/public/favicon-16x16.png +0 -0
package/docs/public/favicon-32x32.png +0 -0
package/docs/public/favicon.ico +0 -0
package/docs/roadmap.md +233 -0
package/docs/site.webmanifest +1 -0
package/docs/troubleshooting.md +12 -1
package/examples/main.ts +5 -30
package/examples/sample-project/script.js +1 -1
package/jest.config.ts +8 -13
package/nodemon.json +5 -10
package/package.json +2 -5
package/src/cli/cli-entry.ts +2 -2
package/src/cli/cli.ts +21 -16
package/src/cli/options.ts +127 -113
package/src/core/bundler.ts +253 -222
package/src/core/extractor.ts +632 -565
package/src/core/minifier.ts +173 -162
package/src/core/packer.ts +141 -137
package/src/core/parser.ts +74 -73
package/src/core/web-fetcher.ts +270 -258
package/src/index.ts +18 -17
package/src/types.ts +9 -11
package/src/utils/font.ts +12 -6
package/src/utils/logger.ts +110 -105
package/src/utils/meta.ts +75 -76
package/src/utils/mime.ts +50 -50
package/src/utils/slugify.ts +33 -34
package/tests/unit/cli/cli-entry.test.ts +72 -70
package/tests/unit/cli/cli.test.ts +314 -278
package/tests/unit/cli/options.test.ts +294 -301
package/tests/unit/core/bundler.test.ts +426 -329
package/tests/unit/core/extractor.test.ts +793 -549
package/tests/unit/core/minifier.test.ts +374 -274
package/tests/unit/core/packer.test.ts +298 -264
package/tests/unit/core/parser.test.ts +538 -150
package/tests/unit/core/web-fetcher.test.ts +389 -359
package/tests/unit/index.test.ts +238 -197
package/tests/unit/utils/font.test.ts +26 -21
package/tests/unit/utils/logger.test.ts +267 -260
package/tests/unit/utils/meta.test.ts +29 -28
package/tests/unit/utils/mime.test.ts +73 -74
package/tests/unit/utils/slugify.test.ts +14 -12
package/tsconfig.build.json +9 -10
package/tsconfig.jest.json +1 -1
package/tsconfig.json +2 -2
package/tsup.config.ts +8 -9
package/typedoc.json +5 -9
/package/docs/{portapack-transparent.png → public/portapack-transparent.png} +0 -0
/package/docs/{portapack.jpg → public/portapack.jpg} +0 -0

package/src/core/packer.ts CHANGED Viewed

@@ -15,7 +15,7 @@ import { guessMimeType } from '../utils/mime'; // Assuming correct path
  * Escapes characters potentially problematic within inline `<script>` tags.
  */
 function escapeScriptContent(code: string): string {
-    return code.replace(/<\/(script)/gi, '<\\/$1');
+  return code.replace(/<\/(script)/gi, '<\\/$1');
 }
 /**
@@ -26,137 +26,141 @@ function escapeScriptContent(code: string): string {
  * @param {Logger} [logger] - Optional logger instance.
  */
 function ensureBaseTag($: CheerioAPI, logger?: Logger): void {
-    let head = $('head');
-    // If <head> doesn't exist, create it, ensuring <html> exists first.
-    if (head.length === 0) {
-        logger?.debug('No <head> tag found. Creating <head> and ensuring <html> exists.');
-        let htmlElement = $('html');
-        // If <html> doesn't exist, create it and wrap the existing content.
-        if (htmlElement.length === 0) {
-            logger?.debug('No <html> tag found. Wrapping content in <html><body>...');
-            const bodyContent = $.root().html() || '';
-            $.root().empty();
-            // FIX: Use 'as any' for type assertion
-            htmlElement = $('<html>').appendTo($.root()) as any;
-            // FIX: Use 'as any' for type assertion
-            head = $('<head>').appendTo(htmlElement) as any;
-            $('<body>').html(bodyContent).appendTo(htmlElement);
-        } else {
-            // If <html> exists but <head> doesn't, prepend <head> to <html>
-            // FIX: Use 'as any' for type assertion
-            head = $('<head>').prependTo(htmlElement) as any;
-        }
-    }
-    // Now head should represent the head element selection.
-    // Check if <base> exists within the guaranteed <head>.
-    // Use type guard just in case head couldn't be created properly
-    if (head && head.length > 0 && head.find('base[href]').length === 0) {
-        logger?.debug('Prepending <base href="./"> to <head>.');
-        head.prepend('<base href="./">');
+  let head = $('head');
+  // If <head> doesn't exist, create it, ensuring <html> exists first.
+  if (head.length === 0) {
+    logger?.debug('No <head> tag found. Creating <head> and ensuring <html> exists.');
+    let htmlElement = $('html');
+    // If <html> doesn't exist, create it and wrap the existing content.
+    if (htmlElement.length === 0) {
+      logger?.debug('No <html> tag found. Wrapping content in <html><body>...');
+      const bodyContent = $.root().html() || '';
+      $.root().empty();
+      // FIX: Use 'as any' for type assertion
+      htmlElement = $('<html>').appendTo($.root()) as any;
+      // FIX: Use 'as any' for type assertion
+      head = $('<head>').appendTo(htmlElement) as any;
+      $('<body>').html(bodyContent).appendTo(htmlElement);
+    } else {
+      // If <html> exists but <head> doesn't, prepend <head> to <html>
+      // FIX: Use 'as any' for type assertion
+      head = $('<head>').prependTo(htmlElement) as any;
     }
+  }
+  // Now head should represent the head element selection.
+  // Check if <base> exists within the guaranteed <head>.
+  // Use type guard just in case head couldn't be created properly
+  if (head && head.length > 0 && head.find('base[href]').length === 0) {
+    logger?.debug('Prepending <base href="./"> to <head>.');
+    head.prepend('<base href="./">');
+  }
 }
 /**
  * Inlines assets into the HTML document using Cheerio for safe DOM manipulation.
  */
 function inlineAssets($: CheerioAPI, assets: Asset[], logger?: Logger): void {
-    logger?.debug(`Inlining ${assets.filter(a => a.content).length} assets with content...`);
-    const assetMap = new Map<string, Asset>(assets.map(asset => [asset.url, asset]));
-    // 1. Inline CSS (<link rel="stylesheet" href="...">)
-    $('link[rel="stylesheet"][href]').each((_, el) => {
-        const link = $(el);
-        const href = link.attr('href');
-        const asset = href ? assetMap.get(href) : undefined;
-        if (asset?.content && typeof asset.content === 'string') {
-            if (asset.content.startsWith('data:')) {
-                 logger?.debug(`Replacing link with style tag using existing data URI: ${asset.url}`);
-                 const styleTag = $('<style>').text(`@import url("${asset.content}");`);
-                 link.replaceWith(styleTag);
-            } else {
-                 logger?.debug(`Inlining CSS: ${asset.url}`);
-                 const styleTag = $('<style>').text(asset.content);
-                 link.replaceWith(styleTag);
-            }
-        } else if (href) {
-             logger?.warn(`Could not inline CSS: ${href}. Content missing or invalid.`);
-        }
-    });
-    // 2. Inline JS (<script src="...">)
-    $('script[src]').each((_, el) => {
-        const script = $(el);
-        const src = script.attr('src');
-        const asset = src ? assetMap.get(src) : undefined;
-        if (asset?.content && typeof asset.content === 'string') {
-            logger?.debug(`Inlining JS: ${asset.url}`);
-            const inlineScript = $('<script>');
-            inlineScript.text(escapeScriptContent(asset.content));
-            Object.entries(script.attr() || {}).forEach(([key, value]) => {
-                 if (key.toLowerCase() !== 'src') inlineScript.attr(key, value);
-            });
-            script.replaceWith(inlineScript);
-        } else if (src) {
-            logger?.warn(`Could not inline JS: ${src}. Content missing or not string.`);
-        }
-    });
-    // 3. Inline Images (<img src="...">, <video poster="...">, etc.)
-    $('img[src], video[poster], input[type="image"][src]').each((_, el) => {
-        const element = $(el);
-        const srcAttr = element.is('video') ? 'poster' : 'src';
-        const src = element.attr(srcAttr);
-        const asset = src ? assetMap.get(src) : undefined;
-        if (asset?.content && typeof asset.content === 'string' && asset.content.startsWith('data:')) {
-            logger?.debug(`Inlining image via ${srcAttr}: ${asset.url}`);
-            element.attr(srcAttr, asset.content);
-        } else if (src) {
-            logger?.warn(`Could not inline image via ${srcAttr}: ${src}. Content missing or not a data URI.`);
-        }
+  logger?.debug(`Inlining ${assets.filter(a => a.content).length} assets with content...`);
+  const assetMap = new Map<string, Asset>(assets.map(asset => [asset.url, asset]));
+  // 1. Inline CSS (<link rel="stylesheet" href="...">)
+  $('link[rel="stylesheet"][href]').each((_, el) => {
+    const link = $(el);
+    const href = link.attr('href');
+    const asset = href ? assetMap.get(href) : undefined;
+    if (asset?.content && typeof asset.content === 'string') {
+      if (asset.content.startsWith('data:')) {
+        logger?.debug(`Replacing link with style tag using existing data URI: ${asset.url}`);
+        const styleTag = $('<style>').text(`@import url("${asset.content}");`);
+        link.replaceWith(styleTag);
+      } else {
+        logger?.debug(`Inlining CSS: ${asset.url}`);
+        const styleTag = $('<style>').text(asset.content);
+        link.replaceWith(styleTag);
+      }
+    } else if (href) {
+      logger?.warn(`Could not inline CSS: ${href}. Content missing or invalid.`);
+    }
+  });
+  // 2. Inline JS (<script src="...">)
+  $('script[src]').each((_, el) => {
+    const script = $(el);
+    const src = script.attr('src');
+    const asset = src ? assetMap.get(src) : undefined;
+    if (asset?.content && typeof asset.content === 'string') {
+      logger?.debug(`Inlining JS: ${asset.url}`);
+      const inlineScript = $('<script>');
+      inlineScript.text(escapeScriptContent(asset.content));
+      Object.entries(script.attr() || {}).forEach(([key, value]) => {
+        if (key.toLowerCase() !== 'src') inlineScript.attr(key, value);
+      });
+      script.replaceWith(inlineScript);
+    } else if (src) {
+      logger?.warn(`Could not inline JS: ${src}. Content missing or not string.`);
+    }
+  });
+  // 3. Inline Images (<img src="...">, <video poster="...">, etc.)
+  $('img[src], video[poster], input[type="image"][src]').each((_, el) => {
+    const element = $(el);
+    const srcAttr = element.is('video') ? 'poster' : 'src';
+    const src = element.attr(srcAttr);
+    const asset = src ? assetMap.get(src) : undefined;
+    if (asset?.content && typeof asset.content === 'string' && asset.content.startsWith('data:')) {
+      logger?.debug(`Inlining image via ${srcAttr}: ${asset.url}`);
+      element.attr(srcAttr, asset.content);
+    } else if (src) {
+      logger?.warn(
+        `Could not inline image via ${srcAttr}: ${src}. Content missing or not a data URI.`
+      );
+    }
+  });
+  // 4. Inline srcset attributes (<img srcset="...">, <source srcset="...">)
+  $('img[srcset], source[srcset]').each((_, el) => {
+    const element = $(el);
+    const srcset = element.attr('srcset');
+    if (!srcset) return;
+    const newSrcsetParts: string[] = [];
+    let changed = false;
+    srcset.split(',').forEach(part => {
+      const trimmedPart = part.trim();
+      const [url, descriptor] = trimmedPart.split(/\s+/, 2);
+      const asset = url ? assetMap.get(url) : undefined;
+      if (
+        asset?.content &&
+        typeof asset.content === 'string' &&
+        asset.content.startsWith('data:')
+      ) {
+        newSrcsetParts.push(`${asset.content}${descriptor ? ' ' + descriptor : ''}`);
+        changed = true;
+      } else {
+        newSrcsetParts.push(trimmedPart);
+      }
     });
+    if (changed) {
+      element.attr('srcset', newSrcsetParts.join(', '));
+    }
+  });
+  // 5. Inline other asset types (video, audio sources)
+  $('video[src], audio[src], video > source[src], audio > source[src]').each((_, el) => {
+    const element = $(el);
+    const src = element.attr('src');
+    const asset = src ? assetMap.get(src) : undefined;
+    if (asset?.content && typeof asset.content === 'string' && asset.content.startsWith('data:')) {
+      logger?.debug(`Inlining media source: ${asset.url}`);
+      element.attr('src', asset.content);
+    }
+  });
-     // 4. Inline srcset attributes (<img srcset="...">, <source srcset="...">)
-     $('img[srcset], source[srcset]').each((_, el) => {
-         const element = $(el);
-         const srcset = element.attr('srcset');
-         if (!srcset) return;
-         const newSrcsetParts: string[] = [];
-         let changed = false;
-         srcset.split(',').forEach(part => {
-             const trimmedPart = part.trim();
-             const [url, descriptor] = trimmedPart.split(/\s+/, 2);
-             const asset = url ? assetMap.get(url) : undefined;
-             if (asset?.content && typeof asset.content === 'string' && asset.content.startsWith('data:')) {
-                 newSrcsetParts.push(`${asset.content}${descriptor ? ' ' + descriptor : ''}`);
-                 changed = true;
-             } else {
-                 newSrcsetParts.push(trimmedPart);
-             }
-         });
-         if (changed) {
-              element.attr('srcset', newSrcsetParts.join(', '));
-         }
-     });
-     // 5. Inline other asset types (video, audio sources)
-      $('video[src], audio[src], video > source[src], audio > source[src]').each((_, el) => {
-         const element = $(el);
-         const src = element.attr('src');
-         const asset = src ? assetMap.get(src) : undefined;
-         if (asset?.content && typeof asset.content === 'string' && asset.content.startsWith('data:')) {
-             logger?.debug(`Inlining media source: ${asset.url}`);
-             element.attr('src', asset.content);
-         }
-     });
-    logger?.debug('Asset inlining process complete.');
+  logger?.debug('Asset inlining process complete.');
 }
 /**
  * Packs a ParsedHTML object into a single, self-contained HTML string.
  * This involves ensuring a base tag exists and inlining all assets
@@ -168,24 +172,24 @@ function inlineAssets($: CheerioAPI, assets: Asset[], logger?: Logger): void {
  * @returns {string} The packed HTML string with assets inlined. Returns a minimal HTML structure if input is invalid.
  */
 export function packHTML(parsed: ParsedHTML, logger?: Logger): string {
-    const { htmlContent, assets } = parsed;
-    if (!htmlContent || typeof htmlContent !== 'string') {
-        logger?.warn('Packer received empty or invalid htmlContent. Returning minimal HTML shell.');
-        return '<!DOCTYPE html><html><head><base href="./"></head><body></body></html>';
-    }
+  const { htmlContent, assets } = parsed;
+  if (!htmlContent || typeof htmlContent !== 'string') {
+    logger?.warn('Packer received empty or invalid htmlContent. Returning minimal HTML shell.');
+    return '<!DOCTYPE html><html><head><base href="./"></head><body></body></html>';
+  }
-    logger?.debug('Loading HTML content into Cheerio for packing...');
-    const $ = cheerio.load(htmlContent);
+  logger?.debug('Loading HTML content into Cheerio for packing...');
+  const $ = cheerio.load(htmlContent);
-    logger?.debug('Ensuring <base> tag exists...');
-    ensureBaseTag($, logger); // Ensure base tag safely
+  logger?.debug('Ensuring <base> tag exists...');
+  ensureBaseTag($, logger); // Ensure base tag safely
-    logger?.debug('Starting asset inlining...');
-    inlineAssets($, assets, logger); // Inline assets safely
+  logger?.debug('Starting asset inlining...');
+  inlineAssets($, assets, logger); // Inline assets safely
-    logger?.debug('Generating final packed HTML string...');
-    const finalHtml = $.html();
+  logger?.debug('Generating final packed HTML string...');
+  const finalHtml = $.html();
-    logger?.debug(`Packing complete. Final size: ${Buffer.byteLength(finalHtml)} bytes.`);
-    return finalHtml;
-}
+  logger?.debug(`Packing complete. Final size: ${Buffer.byteLength(finalHtml)} bytes.`);
+  return finalHtml;
+}

package/src/core/parser.ts CHANGED Viewed

@@ -8,7 +8,6 @@
  * and data URIs are ignored. Duplicate asset URLs are ignored.
  */
-// FIX: Use only the named import for readFile
 import { readFile } from 'fs/promises';
 // NOTE: 'path' module was imported but not used, so removed. Add back if needed later.
 // import path from 'path';
@@ -34,82 +33,84 @@ import { guessMimeType } from '../utils/mime.js';
  * @throws {Error} Throws an error with cause if the file cannot be read.
  */
 export async function parseHTML(entryFilePath: string, logger?: Logger): Promise<ParsedHTML> {
-    logger?.debug(`Parsing HTML file: ${entryFilePath}`);
-    let htmlContent: string;
-    try {
-        // FIX: Use the correctly imported 'readFile' function directly
-        htmlContent = await readFile(entryFilePath, 'utf-8');
-        logger?.debug(`Successfully read HTML file (${Buffer.byteLength(htmlContent)} bytes).`);
-    } catch (err: any) {
-        logger?.error(`Failed to read HTML file "${entryFilePath}": ${err.message}`);
-        throw new Error(`Could not read input HTML file: ${entryFilePath}`, { cause: err });
-    }
+  logger?.debug(`Parsing HTML file: ${entryFilePath}`);
+  let htmlContent: string;
+  try {
+    // FIX: Use the correctly imported 'readFile' function directly
+    htmlContent = await readFile(entryFilePath, 'utf-8');
+    logger?.debug(`Successfully read HTML file (${Buffer.byteLength(htmlContent)} bytes).`);
+  } catch (err: any) {
+    logger?.error(`Failed to read HTML file "${entryFilePath}": ${err.message}`);
+    throw new Error(`Could not read input HTML file: ${entryFilePath}`, { cause: err });
+  }
-    const $: CheerioAPI = cheerio.load(htmlContent);
-    const assets: Asset[] = [];
-    const addedUrls = new Set<string>();
+  const $: CheerioAPI = cheerio.load(htmlContent);
+  const assets: Asset[] = [];
+  const addedUrls = new Set<string>();
-    /** Helper to add unique assets */
-    const addAsset = (url?: string, forcedType?: Asset['type']): void => {
-        if (!url || url.trim() === '' || url.startsWith('data:')) {
-            return;
-        }
-        if (!addedUrls.has(url)) {
-            addedUrls.add(url);
-            const mimeInfo = guessMimeType(url);
-            const type = forcedType ?? mimeInfo.assetType;
-            assets.push({ type, url });
-            logger?.debug(`Discovered asset: Type='${type}', URL='${url}'`);
-        } else {
-             logger?.debug(`Skipping duplicate asset URL: ${url}`);
-        }
-    };
+  /** Helper to add unique assets */
+  const addAsset = (url?: string, forcedType?: Asset['type']): void => {
+    if (!url || url.trim() === '' || url.startsWith('data:')) {
+      return;
+    }
+    if (!addedUrls.has(url)) {
+      addedUrls.add(url);
+      const mimeInfo = guessMimeType(url);
+      const type = forcedType ?? mimeInfo.assetType;
+      assets.push({ type, url });
+      logger?.debug(`Discovered asset: Type='${type}', URL='${url}'`);
+    } else {
+      logger?.debug(`Skipping duplicate asset URL: ${url}`);
+    }
+  };
-    logger?.debug('Extracting assets from HTML tags...');
+  logger?.debug('Extracting assets from HTML tags...');
-    // --- Extract Assets from Various Tags ---
-    // Stylesheets: <link rel="stylesheet" href="...">
-    $('link[rel="stylesheet"][href]').each((_, el) => {
-        addAsset($(el).attr('href'), 'css');
-    });
-    // JavaScript: <script src="...">
-    $('script[src]').each((_, el) => {
-        addAsset($(el).attr('src'), 'js');
-    });
-    // Images: <img src="...">, <input type="image" src="...">
-    $('img[src]').each((_, el) => addAsset($(el).attr('src'), 'image'));
-    $('input[type="image"][src]').each((_, el) => addAsset($(el).attr('src'), 'image'));
-    // Image srcset: <img srcset="...">, <source srcset="..."> (within picture)
-    $('img[srcset], picture source[srcset]').each((_, el) => {
-        const srcset = $(el).attr('srcset');
-        srcset?.split(',').forEach(entry => {
-            const [url] = entry.trim().split(/\s+/);
-            addAsset(url, 'image');
-        });
+  // --- Extract Assets from Various Tags ---
+  // Stylesheets: <link rel="stylesheet" href="...">
+  $('link[rel="stylesheet"][href]').each((_, el) => {
+    addAsset($(el).attr('href'), 'css');
+  });
+  // JavaScript: <script src="...">
+  $('script[src]').each((_, el) => {
+    addAsset($(el).attr('src'), 'js');
+  });
+  // Images: <img src="...">, <input type="image" src="...">
+  $('img[src]').each((_, el) => addAsset($(el).attr('src'), 'image'));
+  $('input[type="image"][src]').each((_, el) => addAsset($(el).attr('src'), 'image'));
+  // Image srcset: <img srcset="...">, <source srcset="..."> (within picture)
+  $('img[srcset], picture source[srcset]').each((_, el) => {
+    const srcset = $(el).attr('srcset');
+    srcset?.split(',').forEach(entry => {
+      const [url] = entry.trim().split(/\s+/);
+      addAsset(url, 'image');
     });
-    // Video: <video src="...">, <video poster="...">
-    $('video[src]').each((_, el) => addAsset($(el).attr('src'), 'video'));
-    $('video[poster]').each((_, el) => addAsset($(el).attr('poster'), 'image'));
-    // Audio: <audio src="...">
-    $('audio[src]').each((_, el) => addAsset($(el).attr('src'), 'audio'));
-    // Media Sources: <source src="..."> within <video> or <audio>
-    $('video > source[src]').each((_, el) => addAsset($(el).attr('src'), 'video'));
-    $('audio > source[src]').each((_, el) => addAsset($(el).attr('src'), 'audio'));
-    // Icons and Manifest: <link rel="icon/shortcut icon/apple-touch-icon/manifest" href="...">
-    $('link[href]').filter((_, el) => {
-        const rel = $(el).attr('rel')?.toLowerCase() ?? '';
-        return ['icon', 'shortcut icon', 'apple-touch-icon', 'manifest'].includes(rel);
-    }).each((_, el) => {
-         const rel = $(el).attr('rel')?.toLowerCase() ?? '';
-         const isIcon = ['icon', 'shortcut icon', 'apple-touch-icon'].includes(rel);
-         addAsset($(el).attr('href'), isIcon ? 'image' : undefined);
-     });
-    // Preloaded Fonts: <link rel="preload" as="font" href="...">
-    $('link[rel="preload"][as="font"][href]').each((_, el) => {
-        addAsset($(el).attr('href'), 'font');
+  });
+  // Video: <video src="...">, <video poster="...">
+  $('video[src]').each((_, el) => addAsset($(el).attr('src'), 'video'));
+  $('video[poster]').each((_, el) => addAsset($(el).attr('poster'), 'image'));
+  // Audio: <audio src="...">
+  $('audio[src]').each((_, el) => addAsset($(el).attr('src'), 'audio'));
+  // Media Sources: <source src="..."> within <video> or <audio>
+  $('video > source[src]').each((_, el) => addAsset($(el).attr('src'), 'video'));
+  $('audio > source[src]').each((_, el) => addAsset($(el).attr('src'), 'audio'));
+  // Icons and Manifest: <link rel="icon/shortcut icon/apple-touch-icon/manifest" href="...">
+  $('link[href]')
+    .filter((_, el) => {
+      const rel = $(el).attr('rel')?.toLowerCase() ?? '';
+      return ['icon', 'shortcut icon', 'apple-touch-icon', 'manifest'].includes(rel);
+    })
+    .each((_, el) => {
+      const rel = $(el).attr('rel')?.toLowerCase() ?? '';
+      const isIcon = ['icon', 'shortcut icon', 'apple-touch-icon'].includes(rel);
+      addAsset($(el).attr('href'), isIcon ? 'image' : undefined);
     });
+  // Preloaded Fonts: <link rel="preload" as="font" href="...">
+  $('link[rel="preload"][as="font"][href]').each((_, el) => {
+    addAsset($(el).attr('href'), 'font');
+  });
-    // --- Parsing Complete ---
-    logger?.info(`HTML parsing complete. Discovered ${assets.length} unique asset links.`);
-    return { htmlContent, assets };
-}
+  // --- Parsing Complete ---
+  logger?.info(`HTML parsing complete. Discovered ${assets.length} unique asset links.`);
+  return { htmlContent, assets };
+}