@open-agent-toolkit/cli 0.2.72 → 0.2.74

package/assets/skills/explainer-kit/scripts/lib/render.mjs

@@ -1,703 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { posix } from 'node:path';
-
-import { canonicalHash, validateContract } from './contracts.mjs';
-import { renderDiagram as renderDiagramBlock } from './diagram.mjs';
-import { MarkdownSafetyError, parseMarkdownDocument } from './markdown.mjs';
-
-const RENDER_STRATEGIES = new Set(['default-only', 'user-switchable']);
-const TEMPLATE_BY_TYPE = new Map([
-  ['hub', 'house-style'],
-  ['diagram', 'diagram-shell'],
-  ['explainer', 'engineer-tour'],
-  ['deck', 'deck-shell'],
-]);
-const TYPE_DIRECTORIES = new Map([
-  ['hub', 'initiatives'],
-  ['diagram', 'diagrams'],
-  ['explainer', 'explainers'],
-  ['deck', 'decks'],
-]);
-const CONTENT_KEYS = new Set([
-  'artifactId',
-  'artifactLinks',
-  'description',
-  'eyebrow',
-  'footer',
-  'sections',
-  'slug',
-  'title',
-]);
-const SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-const TOKEN_PATTERN = /{{([A-Z][A-Z_]*)}}/g;
-
-export async function renderArtifact({
-  recipeArtifact,
-  content,
-  factBase,
-  theme,
-  renderStrategy,
-  publicBaseUrl,
-}) {
-  assertRecipeArtifact(recipeArtifact);
-  assertContent(content, recipeArtifact);
-  assertFactBase(factBase);
-  assertTheme(theme);
-  assertRenderStrategy(renderStrategy);
-
-  const baseUrl = normalizePublicBaseUrl(publicBaseUrl);
-  const renderedPath = artifactPath(recipeArtifact, content.slug);
-  const template = await readFile(
-    new URL(`../../templates/${recipeArtifact.template}.html`, import.meta.url),
-    'utf8',
-  );
-  const sections = content.sections.map((section) => ({
-    ...section,
-    anchor: section.id,
-    backlinks: sourceBacklinksForSection(factBase, section.id),
-    ...prepareSectionMarkdown(section.content, theme),
-  }));
-  const links = content.artifactLinks ?? [];
-  const values = templateValues({
-    recipeArtifact,
-    content,
-    sections,
-    links,
-    theme,
-    renderedPath,
-    baseUrl,
-  });
-
-  let html = substituteTemplate(template, values);
-  html = html.replace(
-    '<html lang="en">',
-    `<html lang="en" data-render-strategy="${renderStrategy}" data-theme-mode="${theme.defaultMode}">`,
-  );
-  if (renderStrategy === 'user-switchable') {
-    html = html
-      .replace('</head>', `${switchableThemeStyle(theme)}\n  </head>`)
-      .replace('</body>', `${switchableThemeControl(theme)}\n  </body>`);
-  }
-
-  return {
-    artifactId: recipeArtifact.id,
-    type: recipeArtifact.type,
-    renderedPath,
-    publicUrl: baseUrl
-      ? `${baseUrl}/${renderedPath.slice('site/'.length)}`
-      : undefined,
-    mediaType: 'text/html',
-    html,
-    warnings: sections.flatMap((section) => section.warnings),
-  };
-}
-
-export function substituteTemplate(template, values) {
-  if (typeof template !== 'string' || !isObject(values)) {
-    throw new TypeError('Template substitution requires a string and values.');
-  }
-
-  const expected = new Set(
-    [...template.matchAll(TOKEN_PATTERN)].map(([, key]) => key),
-  );
-  const unknown = Object.keys(values).filter((key) => !expected.has(key));
-  if (unknown.length > 0) {
-    throw new Error(`Unknown template token: ${unknown[0]}.`);
-  }
-
-  const missing = [...expected].filter(
-    (key) => !Object.hasOwn(values, key) || typeof values[key] !== 'string',
-  );
-  if (missing.length > 0) {
-    throw new Error(`Unresolved template token: ${missing[0]}.`);
-  }
-
-  const normalizedTemplate = normalizeEmptySubstitutionWhitespace(
-    template,
-    values,
-  );
-  const rendered = normalizedTemplate.replace(
-    TOKEN_PATTERN,
-    (_, key) => values[key],
-  );
-  const unresolved = rendered.match(TOKEN_PATTERN)?.[1];
-  if (unresolved) {
-    throw new Error(`Unresolved template token: ${unresolved}.`);
-  }
-  return rendered;
-}
-
-function normalizeEmptySubstitutionWhitespace(template, values) {
-  let normalized = template;
-  let previous;
-  do {
-    previous = normalized;
-    normalized = normalized.replace(
-      /[ \t]*{{([A-Z][A-Z_]*)}}[ \t]*(?=\r?$)/gm,
-      (match, key) => (values[key] === '' ? '' : match),
-    );
-  } while (normalized !== previous);
-  return normalized;
-}
-
-function templateValues({
-  recipeArtifact,
-  content,
-  sections,
-  links,
-  theme,
-  renderedPath,
-  baseUrl,
-}) {
-  const title = escapeHtml(content.title ?? humanize(recipeArtifact.id));
-  const description = escapeHtml(content.description ?? '');
-  const eyebrow = escapeHtml(content.eyebrow ?? recipeArtifact.type);
-  const footer = [
-    escapeHtml(content.footer ?? ''),
-    renderRelatedLinks(links, content.slug, renderedPath, baseUrl),
-  ]
-    .filter(Boolean)
-    .join(' ');
-  const common = {
-    THEME_CSS: themeDeclarations(theme.modes[theme.defaultMode], theme),
-    TITLE: title,
-    DESCRIPTION: description,
-  };
-
-  switch (recipeArtifact.template) {
-    case 'house-style':
-      return {
-        ...common,
-        EYEBROW: eyebrow,
-        NAVIGATION: renderNavigation(
-          sections,
-          links,
-          content.slug,
-          renderedPath,
-          baseUrl,
-        ),
-        CONTENT: renderSections(sections),
-        FOOTER: footer,
-      };
-    case 'engineer-tour':
-      return {
-        ...common,
-        EYEBROW: eyebrow,
-        NAVIGATION: renderNavigation(
-          sections,
-          links,
-          content.slug,
-          renderedPath,
-          baseUrl,
-        ),
-        CONTENT: renderSections(sections, { tour: true }),
-        DIAGRAM: renderLegacyDiagram(sections),
-        FOOTER: footer,
-      };
-    case 'deck-shell':
-      return {
-        ...common,
-        SLIDES: renderSlides(
-          sections,
-          links,
-          content.slug,
-          renderedPath,
-          baseUrl,
-        ),
-      };
-    case 'diagram-shell':
-      return {
-        ...common,
-        DIAGRAM: renderLegacyDiagram(sections),
-        LEGEND: [
-          sections
-            .map(
-              (section) =>
-                `<span>${escapeHtml(section.title ?? humanize(section.id))}</span>`,
-            )
-            .join(''),
-          renderSourceBacklinks(sections.flatMap(({ backlinks }) => backlinks)),
-          renderRelatedLinks(links, content.slug, renderedPath, baseUrl),
-        ].join(''),
-      };
-    default:
-      throw new Error(`Unknown bundled template: ${recipeArtifact.template}.`);
-  }
-}
-
-function renderNavigation(sections, links, slug, renderedPath, baseUrl) {
-  const sectionLinks = sections
-    .map(
-      (section) =>
-        `<a href="#${escapeAttribute(section.anchor)}" data-target="${escapeAttribute(section.anchor)}">${escapeHtml(section.title ?? humanize(section.id))}</a>`,
-    )
-    .join('');
-  return `${sectionLinks}${renderRelatedLinks(links, slug, renderedPath, baseUrl)}`;
-}
-
-function renderSections(sections, { tour = false } = {}) {
-  return sections
-    .map((section, index) => {
-      const tourAttributes = tour
-        ? ` data-active-nodes="node-${index + 1}" data-active-edges=""`
-        : '';
-      return `<section id="${escapeAttribute(section.anchor)}"${tourAttributes}><h2>${escapeHtml(section.title ?? humanize(section.id))}</h2>${renderMarkdownNodes(section.ast.children)}${renderSourceBacklinks(section.backlinks)}</section>`;
-    })
-    .join('');
-}
-
-function prepareSectionMarkdown(content, theme) {
-  try {
-    const parsed = parseMarkdownDocument(content);
-    const diagramWarnings = [];
-    visitMarkdownNodes(parsed.ast.children, (node) => {
-      if (node.type !== 'diagram') return;
-      const rendered = renderDiagramBlock(node.source, { theme });
-      node.renderedHtml = rendered.html;
-      diagramWarnings.push(...rendered.warnings);
-    });
-    return {
-      ...parsed,
-      warnings: [...parsed.warnings, ...diagramWarnings],
-    };
-  } catch (error) {
-    if (
-      !(error instanceof MarkdownSafetyError) ||
-      !/raw html|node type: html/i.test(error.message)
-    ) {
-      throw error;
-    }
-    return {
-      ast: {
-        type: 'document',
-        children: [
-          {
-            type: 'paragraph',
-            children: [{ type: 'text', value: content }],
-          },
-        ],
-      },
-      warnings: [
-        {
-          code: 'legacy-raw-html-escaped',
-          message: 'Legacy section markup was rendered as escaped text.',
-        },
-      ],
-    };
-  }
-}
-
-function visitMarkdownNodes(nodes, callback) {
-  for (const node of nodes) {
-    callback(node);
-    if (Array.isArray(node.children)) {
-      visitMarkdownNodes(node.children, callback);
-    }
-  }
-}
-
-function renderMarkdownNodes(nodes) {
-  return nodes.map(renderMarkdownNode).join('');
-}
-
-function renderMarkdownNode(node) {
-  switch (node.type) {
-    case 'text':
-      return escapeHtml(node.value);
-    case 'paragraph':
-      if (node.children.length === 1 && node.children[0].type === 'figure') {
-        return renderMarkdownNode(node.children[0]);
-      }
-      return `<p>${renderMarkdownNodes(node.children)}</p>`;
-    case 'heading':
-      return `<h${node.depth}>${renderMarkdownNodes(node.children)}</h${node.depth}>`;
-    case 'strong':
-      return `<strong>${renderMarkdownNodes(node.children)}</strong>`;
-    case 'emphasis':
-      return `<em>${renderMarkdownNodes(node.children)}</em>`;
-    case 'delete':
-      return `<del>${renderMarkdownNodes(node.children)}</del>`;
-    case 'inlineCode':
-      return `<code>${escapeHtml(node.value)}</code>`;
-    case 'link':
-      return `<a href="${escapeAttribute(node.url)}"${node.title ? ` title="${escapeAttribute(node.title)}"` : ''}>${renderMarkdownNodes(node.children)}</a>`;
-    case 'figure':
-      return `<figure><a href="${escapeAttribute(node.url)}">${escapeHtml(node.alt || 'View figure')}</a>${node.title || node.alt ? `<figcaption>${escapeHtml(node.title ?? node.alt)}</figcaption>` : ''}</figure>`;
-    case 'blockquote':
-      return `<blockquote>${renderMarkdownNodes(node.children)}</blockquote>`;
-    case 'callout':
-      return `<aside class="callout callout--${escapeAttribute(node.kind)}" data-callout="${escapeAttribute(node.kind)}"><div class="callout__label">${escapeHtml(humanize(node.kind))}</div>${renderMarkdownNodes(node.children)}</aside>`;
-    case 'timeline':
-      return `<ol class="timeline">${node.entries
-        .map(
-          (entry) =>
-            `<li><time>${escapeHtml(entry.date)}</time><span>${escapeHtml(entry.label)}</span></li>`,
-        )
-        .join('')}</ol>`;
-    case 'code':
-      return `<pre><code${node.language ? ` class="language-${escapeAttribute(node.language)}"` : ''}>${escapeHtml(node.value)}</code></pre>`;
-    case 'diagram':
-      return `<div class="diagram-scroll">${node.renderedHtml}</div>`;
-    case 'list':
-      return renderMarkdownList(node);
-    case 'listItem':
-      return `<li>${node.checked === null ? '' : `<input type="checkbox" disabled${node.checked ? ' checked' : ''} aria-label="${node.checked ? 'Completed' : 'Incomplete'} task" />`}${renderMarkdownNodes(node.children)}</li>`;
-    case 'table':
-      return `<div class="table-scroll"><table><thead><tr>${node.header
-        .map((cell) => `<th>${renderMarkdownNodes(cell)}</th>`)
-        .join('')}</tr></thead><tbody>${node.rows
-        .map(
-          (row) =>
-            `<tr>${row
-              .map((cell) => `<td>${renderMarkdownNodes(cell)}</td>`)
-              .join('')}</tr>`,
-        )
-        .join('')}</tbody></table></div>`;
-    default:
-      throw new MarkdownSafetyError(
-        `Unsupported markdown render node: ${String(node.type)}.`,
-      );
-  }
-}
-
-function renderMarkdownList(node) {
-  const tag = node.ordered ? 'ol' : 'ul';
-  const attributes = [
-    node.task ? ' class="task-list"' : '',
-    node.ordered && node.start !== 1 ? ` start="${node.start}"` : '',
-  ].join('');
-  return `<${tag}${attributes}>${renderMarkdownNodes(node.children)}</${tag}>`;
-}
-
-function renderSlides(sections, links, slug, renderedPath, baseUrl) {
-  const slides = sections
-    .map(
-      (section) =>
-        `<section class="slide" id="${escapeAttribute(section.anchor)}"><div class="slide__content"><h2>${escapeHtml(section.title ?? humanize(section.id))}</h2><p>${escapeHtml(section.content)}</p>${renderSourceBacklinks(section.backlinks)}</div></section>`,
-    )
-    .join('');
-  const related = renderRelatedLinks(links, slug, renderedPath, baseUrl);
-  return related
-    ? `${slides}<section class="slide"><div class="slide__content"><h2>Related artifacts</h2>${related}</div></section>`
-    : slides;
-}
-
-// Nodes must fit the shell's 360x540 viewBox, so the step shrinks as sections
-// are added rather than overflowing the canvas.
-function renderLegacyDiagram(sections) {
-  const margin = 16;
-  const span = 540 - margin * 2;
-  const step = Math.min(96, span / Math.max(sections.length, 1));
-  const height = Math.max(24, step - 16);
-  return sections
-    .map((section, index) => {
-      const y = margin + index * step;
-      const label = section.title ?? humanize(section.id);
-      return `<g data-node="node-${index + 1}" class="node"><rect x="${margin}" y="${y}" width="${360 - margin * 2}" height="${height}" rx="8"></rect><text x="${margin + 14}" y="${y + height / 2 + 5}">${escapeHtml(label)}</text></g>`;
-    })
-    .join('');
-}
-
-function renderRelatedLinks(links, slug, renderedPath, baseUrl) {
-  if (links.length === 0) return '';
-  return links
-    .map((link) => {
-      const targetPath = artifactPath(link, slug);
-      const href = baseUrl
-        ? `${baseUrl}/${targetPath.slice('site/'.length)}`
-        : posix.relative(posix.dirname(renderedPath), targetPath);
-      return `<a href="${escapeAttribute(href)}">${escapeHtml(link.label)}</a>`;
-    })
-    .join(' ');
-}
-
-function sourceBacklinksForSection(factBase, sectionId) {
-  if (factBase === undefined) return [];
-  return [...factBase.claims, ...factBase.unresolvedClaims]
-    .filter(
-      (claim) =>
-        claim.sections === undefined || claim.sections.includes(sectionId),
-    )
-    .flatMap((claim) =>
-      claim.citations
-        .filter(({ url }) => typeof url === 'string')
-        .map((citation) => ({
-          claimId: claim.id,
-          claimText: claim.text,
-          repository: citation.repository,
-          path: citation.path,
-          lineRange: citation.lineRange,
-          url: citation.url,
-        })),
-    );
-}
-
-function renderSourceBacklinks(backlinks) {
-  if (backlinks.length === 0) return '';
-  const items = backlinks
-    .map(
-      (backlink) =>
-        `<li><span>${escapeHtml(backlink.claimText)}</span> <a href="${escapeAttribute(backlink.url)}">${escapeHtml(`${backlink.repository}/${backlink.path}:L${backlink.lineRange.start}${backlink.lineRange.end === backlink.lineRange.start ? '' : `-L${backlink.lineRange.end}`}`)}</a></li>`,
-    )
-    .join('');
-  return `<aside class="source-backlinks" aria-label="Sources"><h3>Sources</h3><ul>${items}</ul></aside>`;
-}
-
-export function artifactPath(artifact, slug) {
-  const directory = TYPE_DIRECTORIES.get(artifact.type);
-  if (!directory)
-    throw new Error(`Unsupported artifact type: ${artifact.type}.`);
-  const parts = ['site', directory, slug];
-  const origin = artifact.origin ?? 'floor';
-  if (
-    origin === 'expansion' ||
-    (origin === 'floor' && ['diagram', 'deck'].includes(artifact.type))
-  ) {
-    parts.push(artifact.id);
-  }
-  parts.push('index.html');
-  return parts.join('/');
-}
-
-function themeDeclarations(mode, theme) {
-  return [
-    ['canvas', mode.surface.canvas],
-    ['panel', mode.surface.panel],
-    ['panel-muted', mode.surface.elevated],
-    ['border', mode.surface.elevated],
-    ['ink', mode.ink.primary],
-    ['muted', mode.ink.muted],
-    ['accent', mode.accent.primary],
-    ['success', mode.status.success],
-    ['warning', mode.status.warning],
-    ['danger', mode.status.danger],
-    ['sans', theme.typography.sans.join(', ')],
-    ['serif', theme.typography.serif.join(', ')],
-    ['mono', theme.typography.mono.join(', ')],
-    ['radius', `${theme.geometry.radius.md}px`],
-  ]
-    .map(([name, value]) => `--${name}: ${value};`)
-    .join('\n        ');
-}
-
-function switchableThemeStyle(theme) {
-  return `<style data-theme-mode="${oppositeMode(theme.defaultMode)}">
-      :root[data-theme-mode="${oppositeMode(theme.defaultMode)}"] {
-        ${themeDeclarations(theme.modes[oppositeMode(theme.defaultMode)], theme)}
-      }
-      [data-theme-toggle] {
-        position: fixed;
-        z-index: 10;
-        inset: 1rem 1rem auto auto;
-        border: 1px solid var(--border);
-        border-radius: var(--radius);
-        background: var(--panel);
-        color: var(--ink);
-        padding: 0.55rem 0.75rem;
-        font: 0.875rem var(--sans);
-        cursor: pointer;
-      }
-      [data-theme-toggle]:focus-visible {
-        outline: 2px solid var(--accent);
-        outline-offset: 2px;
-      }
-    </style>`;
-}
-
-function switchableThemeControl(theme) {
-  const defaultMode = theme.defaultMode;
-  const alternateMode = oppositeMode(defaultMode);
-  return `<button type="button" data-theme-toggle aria-pressed="${defaultMode === 'dark'}" aria-label="Switch color theme">Theme: ${humanize(defaultMode)}</button>
-    <script>
-      (() => {
-        const root = document.documentElement;
-        const toggle = document.querySelector('[data-theme-toggle]');
-        const storageKey = 'explainer-theme-mode:' + location.pathname;
-        const supported = new Set(['${defaultMode}', '${alternateMode}']);
-        const apply = (mode, persist = true) => {
-          root.dataset.themeMode = mode;
-          toggle.setAttribute('aria-pressed', String(mode === 'dark'));
-          toggle.textContent = 'Theme: ' + mode[0].toUpperCase() + mode.slice(1);
-          if (persist) {
-            try { localStorage.setItem(storageKey, mode); } catch {}
-          }
-        };
-        let saved;
-        try { saved = localStorage.getItem(storageKey); } catch {}
-        if (supported.has(saved)) apply(saved, false);
-        toggle.addEventListener('click', () =>
-          apply(root.dataset.themeMode === '${defaultMode}' ? '${alternateMode}' : '${defaultMode}')
-        );
-      })();
-    </script>`;
-}
-
-function assertRecipeArtifact(artifact) {
-  const hasLegacyKeys =
-    isObject(artifact) &&
-    hasExactKeys(artifact, ['id', 'type', 'template', 'required']);
-  const hasOriginKeys =
-    isObject(artifact) &&
-    hasExactKeys(artifact, ['id', 'type', 'template', 'required', 'origin']);
-  if (
-    !isObject(artifact) ||
-    (!hasLegacyKeys && !hasOriginKeys) ||
-    !SLUG_PATTERN.test(artifact.id ?? '') ||
-    typeof artifact.required !== 'boolean' ||
-    (artifact.origin !== undefined &&
-      !['floor', 'expansion'].includes(artifact.origin))
-  ) {
-    throw new TypeError(
-      'Recipe artifact is not a validated artifact descriptor.',
-    );
-  }
-  const expectedTemplate = TEMPLATE_BY_TYPE.get(artifact.type);
-  if (!expectedTemplate || artifact.template !== expectedTemplate) {
-    throw new Error(
-      `Unknown or incompatible bundled template: ${String(artifact.template)}.`,
-    );
-  }
-}
-
-function assertContent(content, recipeArtifact) {
-  if (!isObject(content))
-    throw new TypeError('Render content must be an object.');
-  const unknown = Object.keys(content).filter((key) => !CONTENT_KEYS.has(key));
-  if (unknown.length > 0) {
-    throw new TypeError(`Unknown render content field: ${unknown[0]}.`);
-  }
-  if (
-    content.artifactId !== recipeArtifact.id ||
-    !SLUG_PATTERN.test(content.slug ?? '') ||
-    !Array.isArray(content.sections) ||
-    content.sections.length === 0
-  ) {
-    throw new TypeError('Render content does not match the recipe artifact.');
-  }
-  for (const field of ['title', 'description', 'eyebrow', 'footer']) {
-    if (content[field] !== undefined && typeof content[field] !== 'string') {
-      throw new TypeError(`Render content ${field} must be a string.`);
-    }
-  }
-  for (const section of content.sections) {
-    if (
-      !isObject(section) ||
-      !hasOnlyKeys(section, ['id', 'title', 'content']) ||
-      !SLUG_PATTERN.test(section.id ?? '') ||
-      typeof section.content !== 'string' ||
-      (section.title !== undefined && typeof section.title !== 'string')
-    ) {
-      throw new TypeError('Render sections require safe ids and text content.');
-    }
-  }
-  const links = content.artifactLinks ?? [];
-  if (!Array.isArray(links)) {
-    throw new TypeError('Artifact links must be an array.');
-  }
-  for (const link of links) {
-    const hasLegacyKeys =
-      isObject(link) && hasExactKeys(link, ['id', 'type', 'label']);
-    const hasOriginKeys =
-      isObject(link) && hasExactKeys(link, ['id', 'type', 'label', 'origin']);
-    if (
-      !isObject(link) ||
-      (!hasLegacyKeys && !hasOriginKeys) ||
-      !SLUG_PATTERN.test(link.id ?? '') ||
-      !TYPE_DIRECTORIES.has(link.type) ||
-      typeof link.label !== 'string' ||
-      (link.origin !== undefined &&
-        !['floor', 'expansion'].includes(link.origin))
-    ) {
-      throw new TypeError(
-        'Artifact cross-links must use typed artifact targets.',
-      );
-    }
-  }
-}
-
-function assertFactBase(factBase) {
-  if (factBase === undefined) return;
-  const validation = validateContract('fact-base', factBase);
-  if (!validation.valid) {
-    throw new TypeError('Renderer requires a validated fact base.');
-  }
-}
-
-function assertTheme(theme) {
-  const validation = validateContract('theme', theme);
-  const identity = isObject(theme) ? structuredClone(theme) : {};
-  delete identity.bundleHash;
-  if (!validation.valid || theme.bundleHash !== canonicalHash(identity)) {
-    throw new Error('Renderer requires a validated resolved theme.');
-  }
-}
-
-function assertRenderStrategy(renderStrategy) {
-  if (!RENDER_STRATEGIES.has(renderStrategy)) {
-    throw new Error(`Unsupported render strategy: ${String(renderStrategy)}.`);
-  }
-}
-
-function normalizePublicBaseUrl(value) {
-  if (value === undefined) return undefined;
-  if (typeof value !== 'string') {
-    throw new TypeError('Public base URL must be an HTTPS URL.');
-  }
-  let url;
-  try {
-    url = new URL(value);
-  } catch {
-    throw new TypeError('Public base URL must be an HTTPS URL.');
-  }
-  if (
-    url.protocol !== 'https:' ||
-    url.username ||
-    url.password ||
-    url.search ||
-    url.hash
-  ) {
-    throw new TypeError(
-      'Public base URL must be an HTTPS URL without credentials.',
-    );
-  }
-  return url.href.replace(/\/+$/, '');
-}
-
-function escapeHtml(value) {
-  return String(value)
-    .replaceAll('&', '&amp;')
-    .replaceAll('<', '&lt;')
-    .replaceAll('>', '&gt;')
-    .replaceAll('"', '&quot;')
-    .replaceAll("'", '&#39;');
-}
-
-function escapeAttribute(value) {
-  return escapeHtml(value);
-}
-
-function humanize(value) {
-  return value
-    .split('-')
-    .map((part) => `${part[0].toUpperCase()}${part.slice(1)}`)
-    .join(' ');
-}
-
-function oppositeMode(mode) {
-  return mode === 'light' ? 'dark' : 'light';
-}
-
-function hasExactKeys(value, keys) {
-  return (
-    Object.keys(value).length === keys.length &&
-    keys.every((key) => Object.hasOwn(value, key))
-  );
-}
-
-function hasOnlyKeys(value, keys) {
-  return Object.keys(value).every((key) => keys.includes(key));
-}
-
-function isObject(value) {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}