@jairodri/huckleberry-cli 1.0.1 → 1.1.0

package/skills/impeccable/scripts/live/sveltekit-adapter.mjs

@@ -0,0 +1,316 @@
+/**
+ * SvelteKit live-mode adapter.
+ *
+ * SvelteKit must not be patched through src/app.html. That file is a document
+ * template, not framework-owned component chrome. The adapter keeps SvelteKit
+ * work limited to mounting a dev-only shadow host from +layout.svelte; the
+ * actual live UI remains the shared plain-DOM browser chrome.
+ */
+
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+
+export const SVELTE_LIVE_ROOT_COMPONENT = 'src/lib/impeccable/ImpeccableLiveRoot.svelte';
+export const SVELTE_LAYOUT_MARKER_OPEN = '<!-- impeccable-live-svelte-start -->';
+export const SVELTE_LAYOUT_MARKER_CLOSE = '<!-- impeccable-live-svelte-end -->';
+export const SVELTE_ROOT_IMPORT = "import ImpeccableLiveRoot from '$lib/impeccable/ImpeccableLiveRoot.svelte';";
+// Matches the import at ANY revision (or none). [ \t]* bounds only, never
+// \s*: a greedy \s* after the statement swallowed the next line's
+// indentation on removal, leaving a formatting scar in user layouts.
+const SVELTE_ROOT_IMPORT_LINE_RE = /^[ \t]*import ImpeccableLiveRoot from '\$lib\/impeccable\/ImpeccableLiveRoot\.svelte(?:\?[^']*)?';[ \t]*\r?\n?/gm;
+
+/**
+ * The import specifier carries a token-derived revision query. The adapter
+ * component embeds the helper token, and Vite (client AND SSR) can keep
+ * serving a stale compiled module after the file is rewritten on a helper
+ * restart; the browser then requests /live.js with a rotated-out token and
+ * gets a 401 with no picker. A changed specifier is a different module id,
+ * which no cache survives.
+ */
+export function svelteRootImportLine(rev) {
+  if (!rev) return SVELTE_ROOT_IMPORT;
+  return "import ImpeccableLiveRoot from '$lib/impeccable/ImpeccableLiveRoot.svelte?impeccable-live=" + rev + "';";
+}
+
+export function svelteAdapterRev(token) {
+  if (!token) return null;
+  return crypto.createHash('sha256').update(String(token)).digest('hex').slice(0, 8);
+}
+
+export function detectSvelteKitProject(cwd = process.cwd(), config = null) {
+  const appHtml = findSvelteKitAppHtml(cwd, config);
+  if (!appHtml) return null;
+  const hasTemplateMarkers = fileIncludes(path.join(cwd, appHtml), '%sveltekit.body%')
+    && fileIncludes(path.join(cwd, appHtml), '%sveltekit.head%');
+  if (!hasTemplateMarkers) return null;
+
+  const hasSvelteConfig = fs.existsSync(path.join(cwd, 'svelte.config.js'))
+    || fs.existsSync(path.join(cwd, 'svelte.config.mjs'))
+    || fs.existsSync(path.join(cwd, 'svelte.config.cjs'))
+    || fs.existsSync(path.join(cwd, 'svelte.config.ts'));
+  const hasKitPackage = packageHasSvelteKit(cwd);
+  if (!hasSvelteConfig && !hasKitPackage) return null;
+
+  return {
+    appHtml,
+    layoutFile: findSvelteKitLayout(cwd),
+    rootComponent: SVELTE_LIVE_ROOT_COMPONENT,
+  };
+}
+
+export function applySvelteKitLiveAdapter({ cwd = process.cwd(), port, token, config = null } = {}) {
+  if (!Number.isFinite(Number(port))) {
+    throw new Error('SvelteKit live adapter requires a numeric port');
+  }
+  const detected = detectSvelteKitProject(cwd, config);
+  if (!detected) return null;
+
+  ensureSvelteLiveRootComponent(cwd, Number(port), token);
+
+  const layoutRel = detected.layoutFile;
+  const layoutAbs = path.join(cwd, layoutRel);
+  fs.mkdirSync(path.dirname(layoutAbs), { recursive: true });
+  const layoutExisted = fs.existsSync(layoutAbs);
+  const before = layoutExisted ? fs.readFileSync(layoutAbs, 'utf-8') : defaultSvelteLayout();
+  const after = patchSvelteLayout(before, { rev: svelteAdapterRev(token) });
+  fs.writeFileSync(layoutAbs, after, 'utf-8');
+
+  return {
+    file: layoutRel,
+    adapter: 'sveltekit',
+    inserted: after !== before || !layoutExisted,
+    appHtmlUntouched: true,
+    rootComponent: SVELTE_LIVE_ROOT_COMPONENT,
+  };
+}
+
+export function removeSvelteKitLiveAdapter({ cwd = process.cwd(), config = null } = {}) {
+  const detected = detectSvelteKitProject(cwd, config);
+  if (!detected) return null;
+
+  const layoutAbs = path.join(cwd, detected.layoutFile);
+  let removed = false;
+  if (fs.existsSync(layoutAbs)) {
+    const before = fs.readFileSync(layoutAbs, 'utf-8');
+    const after = unpatchSvelteLayout(before);
+    if (after !== before) {
+      fs.writeFileSync(layoutAbs, after, 'utf-8');
+      removed = true;
+    }
+  }
+
+  const rootAbs = path.join(cwd, SVELTE_LIVE_ROOT_COMPONENT);
+  if (fs.existsSync(rootAbs)) {
+    fs.rmSync(rootAbs, { force: true });
+    removed = true;
+  }
+
+  pruneEmptyDir(path.dirname(rootAbs), path.join(cwd, 'src'));
+
+  return {
+    file: detected.layoutFile,
+    adapter: 'sveltekit',
+    removed,
+    appHtmlUntouched: true,
+    rootComponent: SVELTE_LIVE_ROOT_COMPONENT,
+  };
+}
+
+export function patchSvelteLayout(content, { rev = null } = {}) {
+  let out = String(content || '');
+  const importLine = svelteRootImportLine(rev);
+  if (!out.includes(importLine)) {
+    // An import at an older revision is replaced in place, keeping its
+    // indentation; only a layout with no impeccable import gets an insert.
+    let replaced = false;
+    out = out.replace(SVELTE_ROOT_IMPORT_LINE_RE, (line) => {
+      if (replaced) return '';
+      replaced = true;
+      const indent = (line.match(/^[ \t]*/) || [''])[0];
+      return indent + importLine + '\n';
+    });
+    if (!replaced) {
+      const scriptMatch = out.match(/<script(?:\s[^>]*)?>/i);
+      if (scriptMatch) {
+        const insertAt = scriptMatch.index + scriptMatch[0].length;
+        out = out.slice(0, insertAt) + '\n  ' + importLine + out.slice(insertAt);
+      } else {
+        out = `<script>\n  ${importLine}\n</script>\n\n` + out;
+      }
+    }
+  }
+
+  if (!out.includes(SVELTE_LAYOUT_MARKER_OPEN)) {
+    const block = `${SVELTE_LAYOUT_MARKER_OPEN}\n<ImpeccableLiveRoot />\n${SVELTE_LAYOUT_MARKER_CLOSE}\n`;
+    const renderMatch = out.match(/\{@render\s+children(?:\?\.)?\(\)\s*\}/);
+    const slotMatch = out.match(/<slot\s*\/?>/);
+    const match = renderMatch || slotMatch;
+    if (match) {
+      out = out.slice(0, match.index) + block + out.slice(match.index);
+    } else {
+      out = out.replace(/\s*$/, '\n\n' + block);
+    }
+  }
+
+  return out;
+}
+
+export function unpatchSvelteLayout(content) {
+  let out = String(content || '');
+  const blockRe = new RegExp(
+    '([ \\t]*)' + escapeRegExp(SVELTE_LAYOUT_MARKER_OPEN)
+    + '\\n<ImpeccableLiveRoot\\s*/>\\n'
+    + escapeRegExp(SVELTE_LAYOUT_MARKER_CLOSE)
+    + '\\n?',
+    'g',
+  );
+  out = out.replace(blockRe, '$1');
+  out = out.replace(SVELTE_ROOT_IMPORT_LINE_RE, '');
+  out = out.replace(/<script>\s*<\/script>[ \t]*\r?\n?/g, '');
+  return out.replace(/\n{3,}/g, '\n\n');
+}
+
+export function ensureSvelteLiveRootComponent(cwd, port, token) {
+  const file = path.join(cwd, SVELTE_LIVE_ROOT_COMPONENT);
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, buildSvelteLiveRootComponent(port, token), 'utf-8');
+  return file;
+}
+
+export function buildSvelteLiveRootComponent(port, token) {
+  const liveUrl = 'http://localhost:' + Number(port) + '/live.js'
+    + (token ? '?token=' + encodeURIComponent(token) : '');
+  return `<script>
+  import { onMount } from 'svelte';
+
+  const LIVE_URL = '${liveUrl}';
+  const HOST_ID = 'impeccable-live-root';
+
+  onMount(() => {
+    let host = document.querySelector('impeccable-live-root#' + HOST_ID) || document.getElementById(HOST_ID);
+    if (!host) {
+      host = document.createElement('impeccable-live-root');
+      host.id = HOST_ID;
+      document.body.appendChild(host);
+    }
+
+    host.dataset.impeccableLiveAdapter = 'sveltekit';
+    host.style.setProperty('all', 'initial', 'important');
+    host.style.setProperty('display', 'block', 'important');
+    host.style.setProperty('position', 'fixed', 'important');
+    host.style.setProperty('top', '0', 'important');
+    host.style.setProperty('left', '0', 'important');
+    host.style.setProperty('width', '0', 'important');
+    host.style.setProperty('height', '0', 'important');
+    host.style.setProperty('overflow', 'visible', 'important');
+    host.style.setProperty('z-index', '2147483000', 'important');
+    host.style.setProperty('pointer-events', 'none', 'important');
+
+    const root = host.shadowRoot || host.attachShadow({ mode: 'open' });
+    if (!root.querySelector('style[data-impeccable-live-reset]')) {
+      const reset = document.createElement('style');
+      reset.dataset.impeccableLiveReset = 'true';
+      reset.textContent = ':host, :host *, * { box-sizing: border-box; }';
+      root.appendChild(reset);
+    }
+
+    window.__IMPECCABLE_LIVE_ADAPTER__ = 'sveltekit';
+    window.__IMPECCABLE_LIVE_UI_ROOT__ = root;
+    window.__IMPECCABLE_LIVE_CHROME_MOUNT__ = {
+      adapter: 'sveltekit',
+      version: 1,
+      host,
+      root,
+    };
+
+    const script = document.createElement('script');
+    script.src = LIVE_URL;
+    script.async = true;
+    script.dataset.impeccableLiveScript = 'true';
+    script.onerror = () => console.error(
+      '[impeccable] live.js failed to load from ' + LIVE_URL
+      + ' (helper down, or the token rotated while a stale adapter module was cached).'
+      + ' Re-run the live boot, then reload this page.'
+    );
+    document.head.appendChild(script);
+
+    return () => {
+      script.remove();
+      if (window.__IMPECCABLE_LIVE_UI_ROOT__ === root) delete window.__IMPECCABLE_LIVE_UI_ROOT__;
+      if (window.__IMPECCABLE_LIVE_CHROME_MOUNT__?.root === root) delete window.__IMPECCABLE_LIVE_CHROME_MOUNT__;
+      if (window.__IMPECCABLE_LIVE_ADAPTER__ === 'sveltekit') delete window.__IMPECCABLE_LIVE_ADAPTER__;
+    };
+  });
+</script>
+`;
+}
+
+function findSvelteKitAppHtml(cwd, config) {
+  const files = Array.isArray(config?.files) ? config.files : ['src/app.html'];
+  for (const rel of files) {
+    if (rel.includes('*')) continue;
+    const normalized = rel.split(path.sep).join('/');
+    if (!normalized.endsWith('app.html')) continue;
+    const abs = path.join(cwd, normalized);
+    if (fs.existsSync(abs)) return normalized;
+  }
+  const fallback = 'src/app.html';
+  return fs.existsSync(path.join(cwd, fallback)) ? fallback : null;
+}
+
+function findSvelteKitLayout(cwd) {
+  const candidates = [
+    'src/routes/+layout.svelte',
+    'src/routes/(app)/+layout.svelte',
+  ];
+  for (const rel of candidates) {
+    if (fs.existsSync(path.join(cwd, rel))) return rel;
+  }
+  return 'src/routes/+layout.svelte';
+}
+
+function defaultSvelteLayout() {
+  return `<script>\n  let { children } = $props();\n</script>\n\n{@render children?.()}\n`;
+}
+
+function packageHasSvelteKit(cwd) {
+  const file = path.join(cwd, 'package.json');
+  if (!fs.existsSync(file)) return false;
+  try {
+    const pkg = JSON.parse(fs.readFileSync(file, 'utf-8'));
+    const deps = {
+      ...(pkg.dependencies || {}),
+      ...(pkg.devDependencies || {}),
+      ...(pkg.peerDependencies || {}),
+    };
+    return Boolean(deps['@sveltejs/kit'] || deps['@sveltejs/vite-plugin-svelte'] || deps.svelte);
+  } catch {
+    return false;
+  }
+}
+
+function fileIncludes(file, text) {
+  try {
+    return fs.readFileSync(file, 'utf-8').includes(text);
+  } catch {
+    return false;
+  }
+}
+
+function pruneEmptyDir(dir, stopDir) {
+  let current = dir;
+  while (current.startsWith(stopDir) && current !== stopDir) {
+    try {
+      if (fs.readdirSync(current).length > 0) return;
+      fs.rmdirSync(current);
+      current = path.dirname(current);
+    } catch {
+      return;
+    }
+  }
+}
+
+function escapeRegExp(value) {
+  return String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}

package/skills/impeccable/scripts/live/tanstack-adapter.mjs

@@ -0,0 +1,280 @@
+/**
+ * TanStack Start live-mode adapter.
+ *
+ * TanStack Start is SSR: there is no static index.html to patch. The document
+ * shell is a React component (`shellComponent`/`component`) defined in the root
+ * route file, `src/routes/__root.tsx`, which renders `<html>…<body>{children}
+ * <Scripts /></body></html>`.
+ *
+ * A raw `<script src>` placed in that JSX is server-rendered into the streamed
+ * HTML, but React's script handling and hydration make it an unreliable place
+ * to load a cross-origin dev bundle. So, like the Nuxt and SvelteKit adapters,
+ * this keeps the injected code in a dev-only managed component that appends the
+ * live script on mount (client-only, after hydration). The adapter mounts that
+ * component from the root document and removes it cleanly on stop.
+ *
+ * The managed component lives OUTSIDE `src/routes/` (in `src/impeccable/`) so
+ * the TanStack Router file-based route generator never treats it as a route.
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { buildLiveScriptSrc } from './frameworks/script-src.mjs';
+
+export const TANSTACK_MARKER_OPEN = '{/* impeccable-live-tanstack-start */}';
+export const TANSTACK_MARKER_CLOSE = '{/* impeccable-live-tanstack-end */}';
+export const TANSTACK_COMPONENT_DIR = 'src/impeccable';
+export const TANSTACK_COMPONENT_BASENAME = 'ImpeccableLiveRoot';
+
+const ROOT_ROUTE_CANDIDATES = [
+  'src/routes/__root.tsx',
+  'src/routes/__root.jsx',
+  'src/routes/__root.ts',
+  'src/routes/__root.js',
+  'app/routes/__root.tsx',
+  'app/routes/__root.jsx',
+];
+
+const START_PACKAGES = [
+  '@tanstack/react-start',
+  '@tanstack/solid-start',
+  '@tanstack/start',
+];
+
+export function detectTanStackStartProject(cwd = process.cwd()) {
+  if (!packageHasTanStackStart(cwd)) return null;
+  const rootRoute = findRootRouteFile(cwd);
+  if (!rootRoute) return null;
+
+  const ext = path.extname(rootRoute);
+  const componentExt = ext === '.jsx' || ext === '.js' ? '.jsx' : '.tsx';
+  const componentFile = `${TANSTACK_COMPONENT_DIR}/${TANSTACK_COMPONENT_BASENAME}${componentExt}`;
+  const componentImport = relativeImportSpecifier(rootRoute, componentFile);
+
+  return { rootRoute, componentFile, componentImport, ext };
+}
+
+export function applyTanStackLiveAdapter({ cwd = process.cwd(), port, token, project = detectTanStackStartProject(cwd) } = {}) {
+  if (!project) return { error: 'tanstack_not_detected' };
+  if (!Number.isFinite(Number(port))) {
+    throw new Error('TanStack Start live adapter requires a numeric port');
+  }
+
+  // Write the managed mount component.
+  const componentAbs = path.join(cwd, project.componentFile);
+  const componentBody = buildTanStackLiveRootComponent(Number(port), token);
+  const componentExisted = fs.existsSync(componentAbs);
+  if (componentExisted && !isManagedComponent(fs.readFileSync(componentAbs, 'utf-8'))) {
+    // A non-Impeccable file already sits at our managed path — refuse to clobber.
+    return {
+      file: project.componentFile,
+      error: 'tanstack_component_conflict',
+      hint: `${project.componentFile} already exists and is not managed by Impeccable Live`,
+    };
+  }
+  fs.mkdirSync(path.dirname(componentAbs), { recursive: true });
+  fs.writeFileSync(componentAbs, componentBody, 'utf-8');
+
+  // Patch the root document to import + render the mount component.
+  const rootAbs = path.join(cwd, project.rootRoute);
+  const before = fs.readFileSync(rootAbs, 'utf-8');
+  const after = patchTanStackRoot(before, project.componentImport);
+  const changed = after !== before;
+  if (changed) fs.writeFileSync(rootAbs, after, 'utf-8');
+
+  return {
+    file: project.rootRoute,
+    adapter: 'tanstack-start',
+    inserted: changed || !componentExisted,
+    componentFile: project.componentFile,
+    devOnly: true,
+  };
+}
+
+export function removeTanStackLiveAdapter({ cwd = process.cwd(), project = detectTanStackStartProject(cwd) } = {}) {
+  if (!project) return { error: 'tanstack_not_detected' };
+  let removed = false;
+
+  const rootAbs = path.join(cwd, project.rootRoute);
+  if (fs.existsSync(rootAbs)) {
+    const before = fs.readFileSync(rootAbs, 'utf-8');
+    const after = unpatchTanStackRoot(before);
+    if (after !== before) {
+      fs.writeFileSync(rootAbs, after, 'utf-8');
+      removed = true;
+    }
+  }
+
+  const componentAbs = path.join(cwd, project.componentFile);
+  if (fs.existsSync(componentAbs)) {
+    fs.rmSync(componentAbs, { force: true });
+    removed = true;
+  }
+  pruneEmptyDir(path.dirname(componentAbs), path.join(cwd, 'src'));
+
+  return {
+    file: project.rootRoute,
+    adapter: 'tanstack-start',
+    removed,
+    componentFile: project.componentFile,
+  };
+}
+
+export function patchTanStackRoot(content, componentImport) {
+  let out = String(content || '');
+  const importStatement = `import ImpeccableLiveRoot from '${componentImport}';`;
+
+  if (!out.includes(importStatement)) {
+    out = insertAfterLastImport(out, importStatement);
+  }
+
+  if (!out.includes(TANSTACK_MARKER_OPEN)) {
+    const block =
+      `${TANSTACK_MARKER_OPEN}\n`
+      + `        <ImpeccableLiveRoot />\n`
+      + `        ${TANSTACK_MARKER_CLOSE}\n        `;
+    // Anchor before <Scripts …/> (the stable TanStack Start document marker);
+    // fall back to before </body>.
+    const scriptsMatch = out.match(/<Scripts\b/);
+    if (scriptsMatch) {
+      out = out.slice(0, scriptsMatch.index) + block + out.slice(scriptsMatch.index);
+    } else {
+      const bodyClose = out.lastIndexOf('</body>');
+      if (bodyClose !== -1) {
+        out = out.slice(0, bodyClose) + block + out.slice(bodyClose);
+      }
+    }
+  }
+
+  return out;
+}
+
+export function unpatchTanStackRoot(content) {
+  let out = String(content || '');
+  // Remove exactly the inserted block (open marker → component → close marker →
+  // trailing newline + the indent that leads back to the anchor). Leaving the
+  // leading indent before the open marker intact hands it back to the anchor
+  // (e.g. `<Scripts />`) so the file round-trips byte-for-byte.
+  const blockRe = new RegExp(
+    escapeRegExp(TANSTACK_MARKER_OPEN)
+    + '\\s*<ImpeccableLiveRoot\\s*/>\\s*'
+    + escapeRegExp(TANSTACK_MARKER_CLOSE)
+    + '\\r?\\n?[ \\t]*',
+    'g',
+  );
+  out = out.replace(blockRe, '');
+  // Remove only the managed import line — not any following blank line.
+  out = out.replace(
+    new RegExp("^import ImpeccableLiveRoot from '[^']*';[ \\t]*\\r?\\n", 'gm'),
+    '',
+  );
+  return out;
+}
+
+export function buildTanStackLiveRootComponent(port, token) {
+  const liveSrc = buildLiveScriptSrc(Number(port), token);
+  return `/* impeccable-live-tanstack-start */
+import { useEffect } from 'react';
+
+const LIVE_SRC = '${liveSrc}';
+const LIVE_SELECTOR = 'script[data-impeccable-live-tanstack]';
+
+// Dev-only mount for Impeccable Live. TanStack Start server-renders the root
+// document, so this appends the live-mode bundle from the client after
+// hydration (mirrors the Nuxt/SvelteKit adapters). Renders nothing on the
+// server, so there is no hydration mismatch.
+export default function ImpeccableLiveRoot() {
+  useEffect(() => {
+    if (typeof document === 'undefined') return;
+    const expected = new URL(LIVE_SRC, window.location.href).href;
+    let script = document.querySelector(LIVE_SELECTOR);
+    if (script && script.src === expected) return;
+    if (script) script.remove();
+
+    script = document.createElement('script');
+    script.src = LIVE_SRC;
+    script.async = true;
+    script.setAttribute('data-impeccable-live-tanstack', '');
+    script.setAttribute('data-impeccable-live-script', 'true');
+    document.head.appendChild(script);
+
+    return () => {
+      if (script && script.isConnected) script.remove();
+    };
+  }, []);
+
+  return null;
+}
+`;
+}
+
+// ---------------------------------------------------------------------------
+// helpers
+// ---------------------------------------------------------------------------
+
+// The managed mount component carries the `impeccable-live-tanstack` marker in
+// its leading comment and its script data-attribute; user files never do.
+function isManagedComponent(content) {
+  return String(content || '').includes('impeccable-live-tanstack');
+}
+
+function findRootRouteFile(cwd) {
+  for (const rel of ROOT_ROUTE_CANDIDATES) {
+    if (fs.existsSync(path.join(cwd, rel))) return rel;
+  }
+  return null;
+}
+
+function packageHasTanStackStart(cwd) {
+  const file = path.join(cwd, 'package.json');
+  if (!fs.existsSync(file)) return false;
+  try {
+    const pkg = JSON.parse(fs.readFileSync(file, 'utf-8'));
+    const deps = {
+      ...(pkg.dependencies || {}),
+      ...(pkg.devDependencies || {}),
+      ...(pkg.peerDependencies || {}),
+    };
+    return START_PACKAGES.some((name) => Boolean(deps[name]));
+  } catch {
+    return false;
+  }
+}
+
+function relativeImportSpecifier(fromFile, toFile) {
+  const rel = path.posix.relative(
+    path.posix.dirname(fromFile.split(path.sep).join('/')),
+    toFile.split(path.sep).join('/'),
+  ).replace(/\.(tsx|ts|jsx|js)$/, '');
+  return rel.startsWith('.') ? rel : `./${rel}`;
+}
+
+function insertAfterLastImport(content, importStatement) {
+  const importRe = /^import\b[^\n]*\n/gm;
+  let lastEnd = -1;
+  let m;
+  while ((m = importRe.exec(content)) !== null) {
+    lastEnd = m.index + m[0].length;
+  }
+  if (lastEnd === -1) {
+    return `${importStatement}\n${content}`;
+  }
+  return content.slice(0, lastEnd) + importStatement + '\n' + content.slice(lastEnd);
+}
+
+function pruneEmptyDir(dir, stopDir) {
+  let current = dir;
+  while (current.startsWith(stopDir) && current !== stopDir) {
+    try {
+      if (fs.readdirSync(current).length > 0) return;
+      fs.rmdirSync(current);
+      current = path.dirname(current);
+    } catch {
+      return;
+    }
+  }
+}
+
+function escapeRegExp(value) {
+  return String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}