@dr-ishaan/rehype-perfect-code-blocks 1.2.2 → 1.3.2

package/dist/color-utils.js

@@ -0,0 +1,189 @@
+/**
+ * Color manipulation utilities for theme-aware CSS variable defaults.
+ *
+ * Pattern 2 (adopted from expressive-code's `helpers/color-transforms.ts`):
+ * CSS variable defaults are derived from the loaded Shiki theme and adjusted
+ * to meet WCAG contrast ratios, so code blocks look good with ANY Shiki theme
+ * out of the box — line numbers, diff backgrounds, and focus highlights are
+ * automatically legible against the theme's background color.
+ *
+ * The functions here are intentionally minimal — we only implement what we
+ * need to compute a few default `--pcb-*` values. For full color manipulation
+ * (lighten/darken/mix), see expressive-code's implementation.
+ */
+/** Relative luminance per WCAG 2.1: https://www.w3.org/TR/WCAG21/#dfn-relative-luminance */
+function relativeLuminance({ r, g, b }) {
+    const channel = (c) => {
+        const s = c / 255;
+        return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);
+    };
+    return 0.2126 * channel(r) + 0.7152 * channel(g) + 0.0722 * channel(b);
+}
+/** Contrast ratio per WCAG 2.1: https://www.w3.org/TR/WCAG21/#dfn-contrast-ratio (1–21). */
+export function contrastRatio(fg, bg) {
+    const l1 = relativeLuminance(fg);
+    const l2 = relativeLuminance(bg);
+    const lighter = Math.max(l1, l2);
+    const darker = Math.min(l1, l2);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+/**
+ * Parse a hex color (#RGB, #RGBA, #RRGGBB, #RRGGBBAA) or rgb()/rgba() string
+ * into an RGB object. Returns null if the input can't be parsed.
+ */
+export function parseColor(input) {
+    if (!input)
+        return null;
+    const s = input.trim().toLowerCase();
+    // Hex: #RGB, #RGBA, #RRGGBB, #RRGGBBAA
+    const hexMatch = s.match(/^#([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/);
+    if (hexMatch) {
+        let hex = hexMatch[1];
+        if (hex.length === 3 || hex.length === 4) {
+            hex = hex
+                .split('')
+                .map((c) => c + c)
+                .join('');
+        }
+        const r = parseInt(hex.slice(0, 2), 16);
+        const g = parseInt(hex.slice(2, 4), 16);
+        const b = parseInt(hex.slice(4, 6), 16);
+        const a = hex.length === 8 ? parseInt(hex.slice(6, 8), 16) / 255 : undefined;
+        return { r, g, b, a };
+    }
+    // rgb() / rgba()
+    const rgbMatch = s.match(/^rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(?:,\s*([\d.]+)\s*)?\)$/);
+    if (rgbMatch) {
+        return {
+            r: parseInt(rgbMatch[1], 10),
+            g: parseInt(rgbMatch[2], 10),
+            b: parseInt(rgbMatch[3], 10),
+            a: rgbMatch[4] !== undefined ? parseFloat(rgbMatch[4]) : undefined,
+        };
+    }
+    return null;
+}
+/** Convert an RGB color back to a hex string (#RRGGBB or #RRGGBBAA). */
+export function toHex({ r, g, b, a }) {
+    const toHex2 = (n) => Math.max(0, Math.min(255, Math.round(n))).toString(16).padStart(2, '0');
+    const base = `#${toHex2(r)}${toHex2(g)}${toHex2(b)}`;
+    if (a !== undefined && a < 1)
+        return base + toHex2(a * 255);
+    return base;
+}
+/** Mix two colors by a ratio (0 = pure a, 1 = pure b). */
+export function mix(a, b, ratio) {
+    const t = Math.max(0, Math.min(1, ratio));
+    return {
+        r: a.r * (1 - t) + b.r * t,
+        g: a.g * (1 - t) + b.g * t,
+        b: a.b * (1 - t) + b.b * t,
+        a: a.a !== undefined || b.a !== undefined ? (a.a ?? 1) * (1 - t) + (b.a ?? 1) * t : undefined,
+    };
+}
+/** Lighten a color toward white by a ratio (0–1). */
+export function lighten(color, ratio) {
+    return mix(color, { r: 255, g: 255, b: 255 }, ratio);
+}
+/** Darken a color toward black by a ratio (0–1). */
+export function darken(color, ratio) {
+    return mix(color, { r: 0, g: 0, b: 0 }, ratio);
+}
+/**
+ * Adjust a foreground color to meet a target contrast ratio against a
+ * background. If the contrast is already sufficient, returns the foreground
+ * unchanged. Otherwise, lightens (if bg is dark) or darkens (if bg is light)
+ * the foreground until the target ratio is met.
+ *
+ * @param fg Foreground color to adjust
+ * @param bg Background color to adjust against
+ * @param minRatio Minimum WCAG contrast ratio (default 4.5 = AA for normal text)
+ * @param maxRatio Maximum ratio to aim for if adjusting (default 7.0 = AAA)
+ * @returns The adjusted foreground color (or the original if already sufficient)
+ */
+export function ensureColorContrastOnBackground(fg, bg, minRatio = 4.5, maxRatio = 7.0) {
+    const current = contrastRatio(fg, bg);
+    if (current >= minRatio)
+        return fg;
+    // Decide direction: if bg is dark (luminance < 0.5), lighten fg; else darken.
+    const bgLum = relativeLuminance(bg);
+    const direction = bgLum < 0.5 ? 'lighten' : 'darken';
+    // Binary search between current and pure white/black for the target ratio.
+    let lo = 0;
+    let hi = 1;
+    let best = fg;
+    for (let i = 0; i < 16; i++) {
+        const mid = (lo + hi) / 2;
+        const candidate = direction === 'lighten' ? lighten(fg, mid) : darken(fg, mid);
+        const ratio = contrastRatio(candidate, bg);
+        if (ratio >= minRatio && ratio <= maxRatio) {
+            return candidate;
+        }
+        if (ratio < minRatio) {
+            lo = mid;
+        }
+        else {
+            best = candidate;
+            hi = mid;
+        }
+    }
+    return best;
+}
+/**
+ * Extract the background and foreground colors from a Shiki theme object.
+ * Shiki themes have a `bg` and `fg` property at the top level (hex strings).
+ * Returns nulls if the theme shape doesn't match.
+ */
+export function extractThemeColors(theme) {
+    const t = theme;
+    return {
+        bg: parseColor(t?.bg),
+        fg: parseColor(t?.fg),
+    };
+}
+/**
+ * Compute theme-aware `--pcb-*` defaults for a code block based on the
+ * loaded Shiki theme. These are applied as inline styles on the `<figure>`
+ * element, so the static `dist/styles.css` can ship its own defaults while
+ * the runtime overrides them with theme-aware values.
+ *
+ * Currently computes:
+ *   - --pcb-bg: theme background (or 'inherit' if unknown)
+ *   - --pcb-fg: theme foreground (or 'inherit' if unknown)
+ *   - --pcb-line-numbers-fg: theme fg, contrast-adjusted against theme bg
+ *   - --pcb-line-highlight-bg: theme fg at ~12% alpha (subtle highlight)
+ *   - --pcb-line-diff-add-bg: green at ~18% alpha
+ *   - --pcb-line-diff-del-bg: red at ~18% alpha
+ *   - --pcb-line-focus-bg: theme fg at ~6% alpha (subtle dim)
+ *
+ * @param theme The Shiki theme object (must have `bg` and `fg` hex strings)
+ * @returns A CSS style string (e.g. `--pcb-bg:#fff;--pcb-fg:#000;...`) or empty string
+ */
+export function computeThemeAwareDefaults(theme) {
+    const { bg, fg } = extractThemeColors(theme);
+    if (!bg || !fg)
+        return '';
+    const parts = [];
+    parts.push(`--pcb-bg:${toHex(bg)}`);
+    parts.push(`--pcb-fg:${toHex(fg)}`);
+    // Line numbers: use fg, but adjust contrast to >= 3.0 (WCAG AA for large text)
+    // against the background. Shiki themes often have low-contrast line-number
+    // colors baked in; we override them with a guaranteed-legible value.
+    const lineNumFg = ensureColorContrastOnBackground(fg, bg, 3.0, 4.5);
+    parts.push(`--pcb-ln-fg:${toHex(lineNumFg)}`);
+    // Line highlight background: subtle tint of the foreground at ~12% alpha.
+    // Use mix() with the background to get a slightly-lighter/darker shade.
+    const hlBg = mix(bg, fg, 0.12);
+    parts.push(`--pcb-line-highlight-bg:${toHex(hlBg)}`);
+    // Diff add: green (#22863a in github) at 18% alpha over bg.
+    const diffAdd = mix(bg, { r: 34, g: 134, b: 58 }, 0.18);
+    parts.push(`--pcb-line-add-bg:${toHex(diffAdd)}`);
+    // Diff del: red (#cb2431 in github) at 18% alpha over bg.
+    const diffDel = mix(bg, { r: 203, g: 36, b: 49 }, 0.18);
+    parts.push(`--pcb-line-del-bg:${toHex(diffDel)}`);
+    // Focus background: dim the non-focused lines by mixing bg with fg at low alpha.
+    const focusBg = mix(bg, fg, 0.04);
+    parts.push(`--pcb-line-focus-bg:${toHex(focusBg)}`);
+    return parts.join(';');
+}
+//# sourceMappingURL=color-utils.js.map

package/dist/color-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-utils.js","sourceRoot":"","sources":["../src/color-utils.ts"],"names":[],"mappings":"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"}

package/dist/copy-script.d.ts

@@ -1,9 +1,9 @@
 /**
  * The copy-button client script. Inlined once per page (deduped by the
- * Astro integration via `injectScript`). ~600 bytes gzipped.
+ * Astro integration via `injectScript`). ~1.2 KB gzipped.
  *
  * Behavior:
- *   - Listens for clicks on `.pcb__copy`
+ *   - Listens for clicks on `.pcb__copy` (event delegation on document)
  *   - Copies the textContent of the nearest `pre code`
  *   - Toggles `.pcb__copy--done` and swaps the icon + label
  *   - Resets after `data-feedback-duration` ms (default 1600)
@@ -13,6 +13,13 @@
  *   - Strips leading `#` comment lines when `data-strip-comments` is set (terminal preset)
  *   - Announces "Copied" to screen readers via an aria-live region (WCAG 4.1.2)
  *   - Hides copy button when JS is disabled (via .no-js class on <html>)
+ *
+ * Pattern 4 (adopted from VitePress + expressive-code):
+ *   - Event delegation via `document.addEventListener('click', ...)` — works
+ *     regardless of how buttons were rendered (SSR, CSR, view transitions).
+ *   - MutationObserver re-initializes the aria-live region and the .no-js → .js
+ *     class swap when new code blocks are added to the DOM (SPA support).
+ *   - `astro:page-load` event listener for Astro view transitions.
  */
-export declare const COPY_SCRIPT = "\n(function () {\n  if (window.__pcbCopyReady) return;\n  window.__pcbCopyReady = true;\n\n  // Remove the .no-js class so the copy buttons become visible (graceful degradation).\n  if (document.documentElement.classList.contains('no-js')) {\n    document.documentElement.classList.remove('no-js');\n    document.documentElement.classList.add('js');\n  }\n\n  // Reuse a single aria-live region for all copy announcements.\n  var liveRegion = document.querySelector('.pcb__sr-live');\n  if (!liveRegion) {\n    liveRegion = document.createElement('span');\n    liveRegion.className = 'pcb__sr-live';\n    liveRegion.setAttribute('aria-live', 'polite');\n    liveRegion.setAttribute('aria-atomic', 'true');\n    liveRegion.setAttribute('role', 'status');\n    document.body.appendChild(liveRegion);\n  }\n\n  function announce(msg) {\n    if (!liveRegion) return;\n    liveRegion.textContent = '';\n    // Force re-announcement by clearing then setting on next tick.\n    setTimeout(function () { liveRegion.textContent = msg; }, 50);\n  }\n\n  function findLabel(btn) {\n    return btn.querySelector('.pcb__copy-label');\n  }\n\n  function findIcon(btn) {\n    return btn.querySelector('svg');\n  }\n\n  // Strip leading comment lines (e.g. shell prompts like \"# comment\") from\n  // the text before copying. Used for terminal-preset blocks where the\n  // displayed code may include comments the user doesn't want on the clipboard.\n  function stripComments(text) {\n    // Strip lines that start with optional whitespace followed by # (shell),\n    // // (C-style), or REM (Windows batch). Keep everything else.\n    return text.replace(/^[ \\t]*(?:#|\\/\\/|REM\\b).*$/gm, '').replace(/\\n{3,}/g, '\\n\\n').trim();\n  }\n\n  document.addEventListener('click', function (e) {\n    var btn = e.target && e.target.closest && e.target.closest('.pcb__copy');\n    if (!btn) return;\n    var figure = btn.closest('.pcb');\n    var code = figure && figure.querySelector('pre code');\n    if (!code) return;\n\n    var done = btn.getAttribute('data-done-label') || 'copied!';\n    var duration = parseInt(btn.getAttribute('data-feedback-duration') || '1600', 10);\n    var successIconHtml = btn.getAttribute('data-success-icon');\n    var stripCommentsFlag = btn.hasAttribute('data-strip-comments');\n\n    var label = findLabel(btn);\n    var icon = findIcon(btn);\n    var originalLabel = label ? label.textContent : null;\n    var originalIconHtml = icon ? icon.outerHTML : null;\n\n    var rawText = code.innerText;\n    var textToCopy = stripCommentsFlag ? stripComments(rawText) : rawText;\n\n    var finish = function () {\n      btn.classList.add('pcb__copy--done');\n      if (label) label.textContent = done;\n      if (successIconHtml && icon) {\n        var tmp = document.createElement('span');\n        tmp.innerHTML = successIconHtml;\n        var newIcon = tmp.firstChild;\n        if (newIcon) {\n          icon.replaceWith(newIcon);\n          icon = newIcon;\n        }\n      }\n      announce(done);\n      setTimeout(function () {\n        btn.classList.remove('pcb__copy--done');\n        if (label && originalLabel != null) label.textContent = originalLabel;\n        if (originalIconHtml && icon) {\n          var tmp2 = document.createElement('span');\n          tmp2.innerHTML = originalIconHtml;\n          var oldIcon = icon;\n          icon = tmp2.firstChild;\n          if (icon) oldIcon.replaceWith(icon);\n        }\n      }, duration);\n    };\n\n    if (navigator.clipboard && navigator.clipboard.writeText) {\n      navigator.clipboard.writeText(textToCopy).then(finish).catch(fallback);\n    } else {\n      fallback();\n    }\n\n    function fallback() {\n      var ta = document.createElement('textarea');\n      ta.value = textToCopy;\n      ta.style.position = 'fixed';\n      ta.style.opacity = '0';\n      document.body.appendChild(ta);\n      ta.select();\n      try { document.execCommand('copy'); finish(); } catch (_) {}\n      document.body.removeChild(ta);\n    }\n  });\n})();\n";
+export declare const COPY_SCRIPT = "\n(function () {\n  if (window.__pcbCopyReady) return;\n  window.__pcbCopyReady = true;\n\n  // Remove the .no-js class so the copy buttons become visible (graceful degradation).\n  function swapNoJs() {\n    if (document.documentElement.classList.contains('no-js')) {\n      document.documentElement.classList.remove('no-js');\n      document.documentElement.classList.add('js');\n    }\n  }\n  swapNoJs();\n\n  // Reuse a single aria-live region for all copy announcements.\n  var liveRegion = null;\n  function ensureLiveRegion() {\n    if (liveRegion && document.body.contains(liveRegion)) return liveRegion;\n    liveRegion = document.querySelector('.pcb__sr-live');\n    if (!liveRegion) {\n      liveRegion = document.createElement('span');\n      liveRegion.className = 'pcb__sr-live';\n      liveRegion.setAttribute('aria-live', 'polite');\n      liveRegion.setAttribute('aria-atomic', 'true');\n      liveRegion.setAttribute('role', 'status');\n      document.body.appendChild(liveRegion);\n    }\n    return liveRegion;\n  }\n  ensureLiveRegion();\n\n  function announce(msg) {\n    var lr = ensureLiveRegion();\n    if (!lr) return;\n    lr.textContent = '';\n    // Force re-announcement by clearing then setting on next tick.\n    setTimeout(function () { lr.textContent = msg; }, 50);\n  }\n\n  function findLabel(btn) {\n    return btn.querySelector('.pcb__copy-label');\n  }\n\n  function findIcon(btn) {\n    return btn.querySelector('svg');\n  }\n\n  // Strip leading comment lines (e.g. shell prompts like \"# comment\") from\n  // the text before copying. Used for terminal-preset blocks where the\n  // displayed code may include comments the user doesn't want on the clipboard.\n  function stripComments(text) {\n    // Strip lines that start with optional whitespace followed by # (shell),\n    // // (C-style), or REM (Windows batch). Keep everything else.\n    return text.replace(/^[ \\t]*(?:#|\\/\\/|REM\\b).*$/gm, '').replace(/\\n{3,}/g, '\\n\\n').trim();\n  }\n\n  // Event-delegated click handler. Works for buttons added after initial\n  // render (e.g. via React/Vue re-render or Astro view transitions) because\n  // the listener is on document, not on each button.\n  document.addEventListener('click', function (e) {\n    var btn = e.target && e.target.closest && e.target.closest('.pcb__copy');\n    if (!btn) return;\n    var figure = btn.closest('.pcb');\n    var code = figure && figure.querySelector('pre code');\n    if (!code) return;\n\n    var done = btn.getAttribute('data-done-label') || 'copied!';\n    var duration = parseInt(btn.getAttribute('data-feedback-duration') || '1600', 10);\n    var successIconHtml = btn.getAttribute('data-success-icon');\n    var stripCommentsFlag = btn.hasAttribute('data-strip-comments');\n\n    var label = findLabel(btn);\n    var icon = findIcon(btn);\n    var originalLabel = label ? label.textContent : null;\n    var originalIconHtml = icon ? icon.outerHTML : null;\n\n    var rawText = code.innerText;\n    var textToCopy = stripCommentsFlag ? stripComments(rawText) : rawText;\n\n    var finish = function () {\n      btn.classList.add('pcb__copy--done');\n      if (label) label.textContent = done;\n      if (successIconHtml && icon) {\n        var tmp = document.createElement('span');\n        tmp.innerHTML = successIconHtml;\n        var newIcon = tmp.firstChild;\n        if (newIcon) {\n          icon.replaceWith(newIcon);\n          icon = newIcon;\n        }\n      }\n      announce(done);\n      setTimeout(function () {\n        btn.classList.remove('pcb__copy--done');\n        if (label && originalLabel != null) label.textContent = originalLabel;\n        if (originalIconHtml && icon) {\n          var tmp2 = document.createElement('span');\n          tmp2.innerHTML = originalIconHtml;\n          var oldIcon = icon;\n          icon = tmp2.firstChild;\n          if (icon) oldIcon.replaceWith(icon);\n        }\n      }, duration);\n    };\n\n    if (navigator.clipboard && navigator.clipboard.writeText) {\n      navigator.clipboard.writeText(textToCopy).then(finish).catch(fallback);\n    } else {\n      fallback();\n    }\n\n    function fallback() {\n      var ta = document.createElement('textarea');\n      ta.value = textToCopy;\n      ta.style.position = 'fixed';\n      ta.style.opacity = '0';\n      document.body.appendChild(ta);\n      ta.select();\n      try { document.execCommand('copy'); finish(); } catch (_) {}\n      document.body.removeChild(ta);\n    }\n  });\n\n  // Pattern 4: MutationObserver for SPA support + .no-js race fix.\n  // Watches for:\n  //   - New code blocks added to the DOM (React/Vue re-render, Astro view\n  //     transitions, Turbolinks) \u2192 re-apply .no-js \u2192 .js swap + ensure\n  //     aria-live region.\n  //   - Attribute changes on <html> (specifically the class attribute) \u2192\n  //     catches the case where a later script adds .no-js AFTER this script\n  //     ran (a race condition that previously left copy buttons hidden).\n  if (typeof MutationObserver !== 'undefined') {\n    var pendingObserve = false;\n    var observer = new MutationObserver(function (mutations) {\n      // Batch checks with microtask to avoid layout thrash.\n      if (pendingObserve) return;\n      pendingObserve = true;\n      Promise.resolve().then(function () {\n        pendingObserve = false;\n        var needsSwap = false;\n        for (var i = 0; i < mutations.length; i++) {\n          var m = mutations[i];\n          // childList: new nodes added (SPA navigation, view transitions)\n          if (m.type === 'childList' && m.addedNodes && m.addedNodes.length) {\n            needsSwap = true;\n          }\n          // attributes: class changed on <html> (the .no-js race fix)\n          if (m.type === 'attributes' && m.attributeName === 'class') {\n            needsSwap = true;\n          }\n        }\n        if (needsSwap) {\n          swapNoJs();\n          ensureLiveRegion();\n        }\n      });\n    });\n    // Observe documentElement for BOTH childList (new nodes) AND attribute\n    // changes (class attribute \u2014 catches .no-js being added by a later script).\n    observer.observe(document.documentElement, {\n      childList: true,\n      subtree: true,\n      attributes: true,\n      attributeFilter: ['class'],\n    });\n  }\n\n  // Defensive: re-run swapNoJs() on DOMContentLoaded and window.load.\n  // Belt + suspenders for the .no-js race \u2014 if a framework (Astro, Next.js,\n  // etc.) adds .no-js in a way the MutationObserver doesn't catch (e.g.,\n  // before the observer is set up, or in a different document context),\n  // these event handlers will catch it.\n  if (typeof document.addEventListener === 'function') {\n    document.addEventListener('DOMContentLoaded', function () {\n      swapNoJs();\n      ensureLiveRegion();\n    });\n  }\n  if (typeof window.addEventListener === 'function') {\n    window.addEventListener('load', function () {\n      swapNoJs();\n      ensureLiveRegion();\n    });\n  }\n\n  // Pattern 4: astro:page-load event listener for Astro view transitions.\n  // Astro emits this event after a view transition completes; the new page's\n  // DOM may have replaced the old, so re-apply the .no-js \u2192 .js swap.\n  if (typeof document.addEventListener === 'function') {\n    document.addEventListener('astro:page-load', function () {\n      swapNoJs();\n      ensureLiveRegion();\n    });\n  }\n})();\n";
 //# sourceMappingURL=copy-script.d.ts.map

package/dist/copy-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copy-script.d.ts","sourceRoot":"","sources":["../src/copy-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW,67HA8GvB,CAAC"}
+{"version":3,"file":"copy-script.d.ts","sourceRoot":"","sources":["../src/copy-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,WAAW,kxOAmMvB,CAAC"}

package/dist/copy-script.js

@@ -1,9 +1,9 @@
 /**
  * The copy-button client script. Inlined once per page (deduped by the
- * Astro integration via `injectScript`). ~600 bytes gzipped.
+ * Astro integration via `injectScript`). ~1.2 KB gzipped.
  *
  * Behavior:
- *   - Listens for clicks on `.pcb__copy`
+ *   - Listens for clicks on `.pcb__copy` (event delegation on document)
  *   - Copies the textContent of the nearest `pre code`
  *   - Toggles `.pcb__copy--done` and swaps the icon + label
  *   - Resets after `data-feedback-duration` ms (default 1600)
@@ -13,6 +13,13 @@
  *   - Strips leading `#` comment lines when `data-strip-comments` is set (terminal preset)
  *   - Announces "Copied" to screen readers via an aria-live region (WCAG 4.1.2)
  *   - Hides copy button when JS is disabled (via .no-js class on <html>)
+ *
+ * Pattern 4 (adopted from VitePress + expressive-code):
+ *   - Event delegation via `document.addEventListener('click', ...)` — works
+ *     regardless of how buttons were rendered (SSR, CSR, view transitions).
+ *   - MutationObserver re-initializes the aria-live region and the .no-js → .js
+ *     class swap when new code blocks are added to the DOM (SPA support).
+ *   - `astro:page-load` event listener for Astro view transitions.
  */
 export const COPY_SCRIPT = `
 (function () {
@@ -20,27 +27,37 @@ export const COPY_SCRIPT = `
   window.__pcbCopyReady = true;
 
   // Remove the .no-js class so the copy buttons become visible (graceful degradation).
-  if (document.documentElement.classList.contains('no-js')) {
-    document.documentElement.classList.remove('no-js');
-    document.documentElement.classList.add('js');
+  function swapNoJs() {
+    if (document.documentElement.classList.contains('no-js')) {
+      document.documentElement.classList.remove('no-js');
+      document.documentElement.classList.add('js');
+    }
   }
+  swapNoJs();
 
   // Reuse a single aria-live region for all copy announcements.
-  var liveRegion = document.querySelector('.pcb__sr-live');
-  if (!liveRegion) {
-    liveRegion = document.createElement('span');
-    liveRegion.className = 'pcb__sr-live';
-    liveRegion.setAttribute('aria-live', 'polite');
-    liveRegion.setAttribute('aria-atomic', 'true');
-    liveRegion.setAttribute('role', 'status');
-    document.body.appendChild(liveRegion);
+  var liveRegion = null;
+  function ensureLiveRegion() {
+    if (liveRegion && document.body.contains(liveRegion)) return liveRegion;
+    liveRegion = document.querySelector('.pcb__sr-live');
+    if (!liveRegion) {
+      liveRegion = document.createElement('span');
+      liveRegion.className = 'pcb__sr-live';
+      liveRegion.setAttribute('aria-live', 'polite');
+      liveRegion.setAttribute('aria-atomic', 'true');
+      liveRegion.setAttribute('role', 'status');
+      document.body.appendChild(liveRegion);
+    }
+    return liveRegion;
   }
+  ensureLiveRegion();
 
   function announce(msg) {
-    if (!liveRegion) return;
-    liveRegion.textContent = '';
+    var lr = ensureLiveRegion();
+    if (!lr) return;
+    lr.textContent = '';
     // Force re-announcement by clearing then setting on next tick.
-    setTimeout(function () { liveRegion.textContent = msg; }, 50);
+    setTimeout(function () { lr.textContent = msg; }, 50);
   }
 
   function findLabel(btn) {
@@ -60,6 +77,9 @@ export const COPY_SCRIPT = `
     return text.replace(/^[ \\t]*(?:#|\\/\\/|REM\\b).*$/gm, '').replace(/\\n{3,}/g, '\\n\\n').trim();
   }
 
+  // Event-delegated click handler. Works for buttons added after initial
+  // render (e.g. via React/Vue re-render or Astro view transitions) because
+  // the listener is on document, not on each button.
   document.addEventListener('click', function (e) {
     var btn = e.target && e.target.closest && e.target.closest('.pcb__copy');
     if (!btn) return;
@@ -123,6 +143,78 @@ export const COPY_SCRIPT = `
       document.body.removeChild(ta);
     }
   });
+
+  // Pattern 4: MutationObserver for SPA support + .no-js race fix.
+  // Watches for:
+  //   - New code blocks added to the DOM (React/Vue re-render, Astro view
+  //     transitions, Turbolinks) → re-apply .no-js → .js swap + ensure
+  //     aria-live region.
+  //   - Attribute changes on <html> (specifically the class attribute) →
+  //     catches the case where a later script adds .no-js AFTER this script
+  //     ran (a race condition that previously left copy buttons hidden).
+  if (typeof MutationObserver !== 'undefined') {
+    var pendingObserve = false;
+    var observer = new MutationObserver(function (mutations) {
+      // Batch checks with microtask to avoid layout thrash.
+      if (pendingObserve) return;
+      pendingObserve = true;
+      Promise.resolve().then(function () {
+        pendingObserve = false;
+        var needsSwap = false;
+        for (var i = 0; i < mutations.length; i++) {
+          var m = mutations[i];
+          // childList: new nodes added (SPA navigation, view transitions)
+          if (m.type === 'childList' && m.addedNodes && m.addedNodes.length) {
+            needsSwap = true;
+          }
+          // attributes: class changed on <html> (the .no-js race fix)
+          if (m.type === 'attributes' && m.attributeName === 'class') {
+            needsSwap = true;
+          }
+        }
+        if (needsSwap) {
+          swapNoJs();
+          ensureLiveRegion();
+        }
+      });
+    });
+    // Observe documentElement for BOTH childList (new nodes) AND attribute
+    // changes (class attribute — catches .no-js being added by a later script).
+    observer.observe(document.documentElement, {
+      childList: true,
+      subtree: true,
+      attributes: true,
+      attributeFilter: ['class'],
+    });
+  }
+
+  // Defensive: re-run swapNoJs() on DOMContentLoaded and window.load.
+  // Belt + suspenders for the .no-js race — if a framework (Astro, Next.js,
+  // etc.) adds .no-js in a way the MutationObserver doesn't catch (e.g.,
+  // before the observer is set up, or in a different document context),
+  // these event handlers will catch it.
+  if (typeof document.addEventListener === 'function') {
+    document.addEventListener('DOMContentLoaded', function () {
+      swapNoJs();
+      ensureLiveRegion();
+    });
+  }
+  if (typeof window.addEventListener === 'function') {
+    window.addEventListener('load', function () {
+      swapNoJs();
+      ensureLiveRegion();
+    });
+  }
+
+  // Pattern 4: astro:page-load event listener for Astro view transitions.
+  // Astro emits this event after a view transition completes; the new page's
+  // DOM may have replaced the old, so re-apply the .no-js → .js swap.
+  if (typeof document.addEventListener === 'function') {
+    document.addEventListener('astro:page-load', function () {
+      swapNoJs();
+      ensureLiveRegion();
+    });
+  }
 })();
 `;
 //# sourceMappingURL=copy-script.js.map

package/dist/copy-script.js.map

@@ -1 +1 @@
-{"version":3,"file":"copy-script.js","sourceRoot":"","sources":["../src/copy-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8G1B,CAAC"}
+{"version":3,"file":"copy-script.js","sourceRoot":"","sources":["../src/copy-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmM1B,CAAC"}

package/dist/index.d.ts

@@ -18,9 +18,15 @@
  */
 import type { Plugin } from 'unified';
 import type { Root } from 'hast';
+import { disposeHighlighter, runHighlighterTask } from './shiki.js';
 import { remarkPreserveCodeMeta } from './remark.js';
+import { wordDiff, hasChanges } from './word-diff.js';
+import type { DiffToken } from './word-diff.js';
 import type { PerfectCodeOptions } from './types.js';
 export { remarkPreserveCodeMeta };
+export { disposeHighlighter, runHighlighterTask };
+export { wordDiff, hasChanges };
+export type { DiffToken };
 export declare const rehypePerfectCodeBlocks: Plugin<[PerfectCodeOptions?], Root>;
 export default rehypePerfectCodeBlocks;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAmBrE,CAAC;AAEJ,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAuB,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAmBrE,CAAC;AAEJ,eAAe,uBAAuB,CAAC"}

package/dist/index.js

@@ -17,9 +17,12 @@
  * plugin with style/script injection and automatic Shiki integration.
  */
 import { rehypePerfectCodeBlocks as transformer } from './transformer.js';
-import { runShikiOnRawBlocks } from './shiki.js';
+import { runShikiOnRawBlocks, disposeHighlighter, runHighlighterTask } from './shiki.js';
 import { remarkPreserveCodeMeta } from './remark.js';
+import { wordDiff, hasChanges } from './word-diff.js';
 export { remarkPreserveCodeMeta };
+export { disposeHighlighter, runHighlighterTask };
+export { wordDiff, hasChanges };
 export const rehypePerfectCodeBlocks = (options = {}) => {
     const engine = options.engine ?? 'auto';
     const opts = options;
@@ -78,6 +81,7 @@ function resolveDefaults(opts) {
         lineNumbersStart: opts.lineNumbersStart ?? 1,
         highlight: opts.highlight ?? true,
         diff: opts.diff ?? true,
+        wordDiff: opts.wordDiff ?? false,
         focus: opts.focus ?? true,
         errorLevels: opts.errorLevels ?? true,
         wrap: opts.wrap ?? false,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/shiki.d.ts

@@ -14,6 +14,26 @@
  */
 import type { Root } from 'hast';
 import type { PerfectCodeOptions } from './types.js';
+/**
+ * Run a task function inside the mutually exclusive highlighter queue.
+ * All calls are serialized globally — the next task starts only after the
+ * current one resolves or rejects.
+ */
+export declare function runHighlighterTask<T>(taskFn: () => Promise<T>): Promise<T>;
+/**
+ * Pattern 3 (adopted from VitePress): Dispose all cached highlighters and
+ * clear the cache. Call this in long-running dev servers when the theme
+ * changes, or during cleanup of a build pipeline, to release the WASM
+ * engine + loaded grammars + theme cache held by Shiki.
+ *
+ * After calling this, the next render will create a fresh highlighter.
+ *
+ * @example
+ *   // In a Vite dev server shutdown hook:
+ *   import { disposeHighlighter } from '@dr-ishaan/rehype-perfect-code-blocks';
+ *   server.http2.close(() => disposeHighlighter());
+ */
+export declare function disposeHighlighter(): void;
 /**
  * Walk the tree; for every <pre><code> that does NOT yet look Shiki-processed
  * (i.e. no `astro-code` / `shiki` class), tokenize it via Shiki and replace

package/dist/shiki.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shiki.d.ts","sourceRoot":"","sources":["../src/shiki.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAwUrD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAoSf"}
+{"version":3,"file":"shiki.d.ts","sourceRoot":"","sources":["../src/shiki.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAwFrD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQ1E;AA4CD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAYzC;AAgPD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CA0Tf"}