@bendyline/gezel 1.0.0 → 1.0.2

package/dist/checks/index.js

@@ -1445,6 +1445,14 @@ function cleanHeading(text) {
 function documentH1s(markdown) {
   return [...markdown.matchAll(/^#\s+(.+?)\s*$/gm)].map((match) => match[1].trim());
 }
+function documentH2s(markdown) {
+  return [...markdown.matchAll(/^##\s+(.+?)\s*$/gm)].map((match) => match[1].trim());
+}
+function headingLevelHint(file, documentHeadings, h2s, expected) {
+  if (documentHeadings.length > 1 || h2s.length !== expected || expected === 0) return null;
+  const title = documentHeadings.length === 1 ? ` and \`# ${documentHeadings[0]}\` as a title` : "";
+  return `${file} puts its ${expected} slides at \`##\`${title}, but slides are split on H1 \u2014 as written this converts to a single slide. Promote each \`## Slide\` heading to \`# \` and drop the document title.`;
+}
 function outlineSlideHeadings(markdown) {
   const headings = [];
   for (const match of markdown.matchAll(/^#{2,6}\s+(.+?)\s*$/gm)) {
@@ -1483,9 +1491,10 @@ async function markdownHeadingsMatch(ws, file, outlineFile) {
     };
   }
   if (actual.length !== expected.length) {
+    const levelHint = headingLevelHint(file, actual, documentH2s(document), expected.length);
     return {
       ok: false,
-      detail: `${file} has ${actual.length} H1 slide headings, but ${outlineFile} locks ${expected.length}. Add or remove slides without merging outline items.`,
+      detail: levelHint ?? `${file} has ${actual.length} H1 slide headings, but ${outlineFile} locks ${expected.length}. Add or remove slides without merging outline items.`,
       outlineHeadings: expected,
       documentHeadings: actual
     };