@bendyline/squisq 2.8.0 → 2.9.0

package/dist/{chunk-KEAU5NEM.js → chunk-HEYR3TPL.js}

@@ -1,7 +1,7 @@
 import {
   expectedSyllablesAt,
   wordPosAtExpectedSyllables
-} from "./chunk-V6NV4GDE.js";
+} from "./chunk-W2GIFNLN.js";
 
 // src/narration/types.ts
 var DEFAULT_FEATURE_CONFIG = Object.freeze({

package/dist/{chunk-PTK2SW2V.js → chunk-KIAEJDZB.js}

@@ -30,7 +30,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-V6NV4GDE.js";
+} from "./chunk-W2GIFNLN.js";
 import {
   iconMarker
 } from "./chunk-7ZAAICW4.js";
@@ -3286,8 +3286,8 @@ function dedupeLeadingTitleBlock(candidates, titleText) {
   if (!firstTitle || firstTitle !== titleText.trim().toLowerCase()) return candidates;
   const template = first.template;
   const titleShaped = template === "title" || template === "sectionHeader" || template === "cover";
-  const hasBody = Array.isArray(first.contents) && first.contents.length > 0;
-  return titleShaped || !hasBody ? candidates.slice(1) : candidates;
+  const hasBody2 = Array.isArray(first.contents) && first.contents.length > 0;
+  return titleShaped || !hasBody2 ? candidates.slice(1) : candidates;
 }
 function buildTitleLayers(titleText, bandViewport, slot, theme, canvasViewport, margin) {
   const context = createTemplateContext(theme, 0, 1, canvasViewport);
@@ -3632,6 +3632,272 @@ function composeDashboardLayers(materialization) {
   return layers;
 }
 
+// src/doc/flashcards/materializeFlashcards.ts
+var GENERIC_ANSWER_TITLES = /* @__PURE__ */ new Set([
+  "answer",
+  "back",
+  "solution",
+  "explanation",
+  "correct answer",
+  "correct",
+  "distractor",
+  "option"
+]);
+function normalizeMarker(value) {
+  return typeof value === "string" ? value.trim().toLowerCase().replace(/[\s_-]+/g, "") : "";
+}
+function markerFromValue(value) {
+  const normalized = normalizeMarker(value);
+  if (normalized === "flashcard" || normalized === "card" || normalized === "basicflashcard") {
+    return "basic";
+  }
+  if (normalized === "multiplechoiceflashcard" || normalized === "multiplechoice" || normalized === "quiz") {
+    return "multiple-choice";
+  }
+  if (normalized === "group" || normalized === "flashcardgroup" || normalized === "deck") {
+    return "group";
+  }
+  return void 0;
+}
+function resolveFlashcardMarker(block) {
+  const metadataMarker = markerFromValue(block.metadata?.study) ?? markerFromValue(block.metadata?.["study-mode"]);
+  if (metadataMarker) return metadataMarker;
+  for (const className of block.classes ?? []) {
+    const classMarker = markerFromValue(className);
+    if (classMarker) return classMarker;
+  }
+  return markerFromValue(block.template);
+}
+function hasTitle(block) {
+  return typeof block.title === "string" && block.title.trim().length > 0;
+}
+function hasBody(block) {
+  return (block.contents?.length ?? 0) > 0 || (block.media?.length ?? 0) > 0 || (block.layers?.length ?? 0) > 0;
+}
+function hasOwnContent(block) {
+  return hasTitle(block) || hasBody(block);
+}
+function isGenericAnswerBlock(block) {
+  return hasTitle(block) && GENERIC_ANSWER_TITLES.has(block.title.trim().toLowerCase());
+}
+function selfOnly(block) {
+  const { children: _children, ...self } = block;
+  return self;
+}
+function titleOnly(block) {
+  const {
+    children: _children,
+    contents: _contents,
+    media: _media,
+    layers: _layers,
+    ...title2
+  } = block;
+  return title2;
+}
+function bodyOnly(block) {
+  const { children: _children, title: _title, ...body } = block;
+  return body;
+}
+function face(...blocks) {
+  return { blocks };
+}
+function isTrue(value) {
+  if (value === true) return true;
+  if (typeof value !== "string") return false;
+  return ["true", "yes", "on", "1", "correct"].includes(value.trim().toLowerCase());
+}
+function isCorrectChoice(block) {
+  return isTrue(block.metadata?.correct) || isTrue(block.metadata?.answer) || (block.classes ?? []).some((className) => normalizeMarker(className) === "correct");
+}
+function looksLikeCompleteCard(block) {
+  const marker = resolveFlashcardMarker(block);
+  if (marker === "group") return false;
+  if (marker === "basic" || marker === "multiple-choice") return true;
+  if (isGenericAnswerBlock(block)) return false;
+  const children = block.children ?? [];
+  if (children.length === 0) return hasTitle(block) && hasBody(block);
+  if (children.length === 1) {
+    return hasOwnContent(block) && hasOwnContent(children[0]);
+  }
+  return children.every(hasOwnContent);
+}
+function hasExplicitCardDescendant(block) {
+  for (const child of block.children ?? []) {
+    const marker = resolveFlashcardMarker(child);
+    if (marker === "basic" || marker === "multiple-choice") return true;
+    if (hasExplicitCardDescendant(child)) return true;
+  }
+  return false;
+}
+function shouldTreatAsImplicitGroup(block) {
+  const children = block.children ?? [];
+  if (children.length === 0) return false;
+  if (hasExplicitCardDescendant(block)) return true;
+  if (hasBody(block)) return false;
+  if (children.length === 1) {
+    return looksLikeCompleteCard(children[0]) && !isGenericAnswerBlock(children[0]);
+  }
+  return children.filter(looksLikeCompleteCard).length >= 2;
+}
+function explanationFor(block) {
+  return hasBody(block) ? face(bodyOnly(block)) : void 0;
+}
+function materializeBasic(block, diagnostics) {
+  const children = block.children ?? [];
+  let front;
+  let back;
+  let label;
+  let explanation;
+  if (children.length === 0) {
+    front = hasTitle(block) ? face(titleOnly(block)) : face();
+    back = hasBody(block) ? face(bodyOnly(block)) : face();
+  } else if (children.length === 1) {
+    front = hasOwnContent(block) ? face(selfOnly(block)) : face();
+    back = hasOwnContent(children[0]) ? face(children[0]) : face();
+  } else {
+    front = hasOwnContent(children[0]) ? face(children[0]) : face();
+    back = face(...children.slice(1).filter(hasOwnContent));
+    label = hasTitle(block) ? block.title.trim() : void 0;
+    explanation = explanationFor(block);
+  }
+  if (front.blocks.length === 0) {
+    diagnostics.push({
+      severity: "error",
+      code: "empty-front",
+      message: `Flashcard "${block.id}" has no content for its front`,
+      blockId: block.id
+    });
+  }
+  if (back.blocks.length === 0) {
+    diagnostics.push({
+      severity: "error",
+      code: "empty-back",
+      message: `Flashcard "${block.id}" has no content for its answer`,
+      blockId: block.id
+    });
+  }
+  if (front.blocks.length === 0 || back.blocks.length === 0) return void 0;
+  return {
+    id: block.id,
+    sourceBlockId: block.id,
+    kind: "basic",
+    ...label ? { label } : {},
+    front,
+    back,
+    ...explanation ? { explanation } : {}
+  };
+}
+function materializeMultipleChoice(block, diagnostics) {
+  const children = block.children ?? [];
+  const question = children[0];
+  const answerBlocks = children.slice(1).filter(hasOwnContent);
+  if (!question || !hasOwnContent(question)) {
+    diagnostics.push({
+      severity: "error",
+      code: "empty-front",
+      message: `Multiple-choice flashcard "${block.id}" has no question block`,
+      blockId: block.id
+    });
+  }
+  if (answerBlocks.length === 0) {
+    diagnostics.push({
+      severity: "error",
+      code: "empty-back",
+      message: `Multiple-choice flashcard "${block.id}" has no answer choices`,
+      blockId: block.id
+    });
+  }
+  if (!question || !hasOwnContent(question) || answerBlocks.length === 0) return void 0;
+  const explicitlyCorrect = answerBlocks.filter(isCorrectChoice);
+  if (explicitlyCorrect.length > 1) {
+    diagnostics.push({
+      severity: "warning",
+      code: "multiple-correct-answers",
+      message: `Multiple-choice flashcard "${block.id}" marks more than one answer correct; the first marker wins`,
+      blockId: block.id
+    });
+  }
+  const correctBlock = explicitlyCorrect[0] ?? answerBlocks[0];
+  if (answerBlocks.length < 2) {
+    diagnostics.push({
+      severity: "warning",
+      code: "multiple-choice-needs-distractor",
+      message: `Multiple-choice flashcard "${block.id}" needs at least one distractor`,
+      blockId: block.id
+    });
+  }
+  const choices = answerBlocks.map((answer, index) => ({
+    id: `${block.id}-choice-${index + 1}`,
+    sourceBlockId: answer.id,
+    content: face(answer),
+    correct: answer === correctBlock
+  }));
+  const explanation = explanationFor(block);
+  return {
+    id: block.id,
+    sourceBlockId: block.id,
+    kind: "multiple-choice",
+    ...hasTitle(block) ? { label: block.title.trim() } : {},
+    front: face(question),
+    back: face(correctBlock),
+    choices,
+    ...explanation ? { explanation } : {}
+  };
+}
+function resolveDeckTitle(doc) {
+  const frontmatterTitle = doc.frontmatter?.title;
+  if (typeof frontmatterTitle === "string" && frontmatterTitle.trim()) {
+    return frontmatterTitle.trim();
+  }
+  return doc.startBlock?.title?.trim() || void 0;
+}
+function materializeFlashcards(doc, options = {}) {
+  const source = options.source ?? "auto";
+  const cards = [];
+  const diagnostics = [];
+  const visit = (block) => {
+    const marker = resolveFlashcardMarker(block);
+    if (marker === "group") {
+      for (const child of block.children ?? []) visit(child);
+      return;
+    }
+    if (marker === "basic") {
+      const card = materializeBasic(block, diagnostics);
+      if (card) cards.push(card);
+      return;
+    }
+    if (marker === "multiple-choice") {
+      const card = materializeMultipleChoice(block, diagnostics);
+      if (card) cards.push(card);
+      return;
+    }
+    if (source === "explicit") {
+      for (const child of block.children ?? []) visit(child);
+      return;
+    }
+    if (shouldTreatAsImplicitGroup(block)) {
+      for (const child of block.children ?? []) visit(child);
+      return;
+    }
+    if (looksLikeCompleteCard(block)) {
+      const card = materializeBasic(block, diagnostics);
+      if (card) cards.push(card);
+      return;
+    }
+    for (const child of block.children ?? []) visit(child);
+  };
+  for (const block of doc.blocks) visit(block);
+  const resolvedTitle = resolveDeckTitle(doc);
+  const authoredTitle = typeof doc.frontmatter?.title === "string" ? doc.frontmatter.title.trim() : "";
+  const firstCardTitle = cards[0]?.front.blocks[0]?.title?.trim();
+  const title2 = resolvedTitle && (authoredTitle || resolvedTitle !== firstCardTitle) ? resolvedTitle : void 0;
+  return {
+    ...title2 ? { title: title2 } : {},
+    cards,
+    diagnostics
+  };
+}
+
 // src/doc/applyNarrationTiming.ts
 var MIN_BLOCK_SIMILARITY = 0.5;
 var MIN_V1_SCRIPT_SIMILARITY = 0.8;
@@ -5603,6 +5869,8 @@ export {
   resolveDashboardSettings,
   materializeDashboard,
   composeDashboardLayers,
+  resolveFlashcardMarker,
+  materializeFlashcards,
   applyNarrationTiming,
   scoreTextSimilarity,
   resolveAudioMapping,