@abreen/tada 1.17.0 → 1.18.0

package/build/utils/markdown.ts

@@ -7,7 +7,6 @@ import markdownItAnchor from 'markdown-it-anchor';
 import markdownItFootnote from 'markdown-it-footnote';
 import markdownItDeflist from 'markdown-it-deflist';
 import markdownItContainer from 'markdown-it-container';
-import textToId, { deduplicateId } from '../text-to-id';
 import { highlightCode } from './shiki-highlighter';
 import { isBundledLanguage, isPlainTextLanguage } from '../site-variables';
 import headingSubtitlePlugin from '../heading-subtitle-plugin';
@@ -28,10 +27,11 @@ interface CreateMarkdownOptions {
   filePath?: string;
   slides?: boolean;
   validatorOptions?: Record<string, unknown>;
-  literateJavaOutputPaths?: Set<string>;
+  literateJavaOutputPaths?: ReadonlySet<string>;
   sourceUrlPath?: string;
-  validTargets?: Set<string>;
+  validTargets?: ReadonlySet<string>;
   templateParams?: Record<string, unknown>;
+  preserveHtmlComments?: boolean;
   dependencyCollector?: RenderDependencyCollector;
 }
 
@@ -102,6 +102,7 @@ export function createMarkdown(
     markdown.use(markdownPartialsPlugin, {
       filePath,
       templateParams: options.templateParams,
+      preserveHtmlComments: options.preserveHtmlComments,
       dependencyCollector: options.dependencyCollector,
     });
   }
@@ -458,18 +459,12 @@ export function createMarkdown(
     state.tokens = transformedTokens;
   });
 
-  const usedIds = new Map<string, number>();
   markdown.use(markdownItContainer, 'alert', {
     marker: '!',
     validate: function (params: string) {
       return ALERT_PATTERN.test(params.trim());
     },
-    render: function (
-      tokens: Token[],
-      idx: number,
-      _options: unknown,
-      env: Record<string, unknown>,
-    ) {
+    render: function (tokens: Token[], idx: number) {
       const matches = tokens[idx].info.trim().match(ALERT_PATTERN);
 
       if (tokens[idx].nesting === 1) {
@@ -483,13 +478,7 @@ export function createMarkdown(
         const displayTitle = title
           ? markdown.utils.escapeHtml(curlyQuote(title))
           : capitalize(type || '');
-        const baseId = textToId(title || type || '');
-        const titleId = deduplicateId(usedIds, baseId);
-
-        if (!env.alertIds) {
-          env.alertIds = [];
-        }
-        (env.alertIds as string[]).push(titleId);
+        const titleId = tokens[idx].attrGet('id')!;
 
         let html = `<div class="${classNames.join(' ')}">`;
         html += `<p class="title" id="${titleId}">${displayTitle}</p>\n`;

package/build/utils/paths.ts

@@ -2,6 +2,9 @@ import path from 'path';
 import { globals } from '../globals';
 import type { SiteVariables } from '../types';
 
+/** The search index directory inside the output directory */
+export const SEARCH_INDEX_DIR = 'pagefind';
+
 export function getPackageDir(): string {
   return path.resolve(import.meta.dir, '..', '..');
 }

package/build/utils/plain-text.ts

@@ -0,0 +1,18 @@
+import { decodeHTML } from 'entities';
+
+/**
+ * Converts rendered inline HTML (such as a front matter title rendered as
+ * Markdown) into the plain text a reader sees: tags and comments are removed
+ * by an HTML parser, and character references are decoded exactly once.
+ */
+export function htmlToPlainText(html: string): string {
+  let text = '';
+  new HTMLRewriter()
+    .onDocument({
+      text(chunk) {
+        text += chunk.text;
+      },
+    })
+    .transform(html);
+  return decodeHTML(text);
+}