@intellectif/lk-core 1.1.0 → 1.2.0

package/dist/chunk-LDFQUZII.cjs

@@ -1,950 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
-
-
-
-
-
-var _chunkVSH7ECQLcjs = require('./chunk-VSH7ECQL.cjs');
-
-
-
-
-var _chunkDSDXL3JOcjs = require('./chunk-DSDXL3JO.cjs');
-
-// src/ai-text.ts
-function cleanText(text) {
-  return text.replace(/\r\n?/g, "\n").replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F\u2028\u2029]/g, "").replace(/\n{3,}/g, "\n\n").trim();
-}
-
-// src/ai.ts
-var AI_EXPLANATION_TYPES = [
-  "multiple-choice",
-  "fill-in-the-blanks",
-  "gap-select",
-  "dictation"
-];
-var AI_HINT_TYPES = [
-  "multiple-choice",
-  "fill-in-the-blanks",
-  "gap-select"
-];
-var AI_TEXT_MAX_LENGTH = 2e3;
-function aiSupports(activityType, feature) {
-  if (feature === "writing-feedback") {
-    return activityType === "written-response";
-  }
-  if (feature === "pronunciation-coaching") {
-    return activityType === "read-aloud";
-  }
-  const types = feature === "hint" ? AI_HINT_TYPES : AI_EXPLANATION_TYPES;
-  return types.includes(activityType);
-}
-function aiAllowedByContent(data, feature) {
-  const permissions = data.ai;
-  if (typeof permissions !== "object" || permissions === null) {
-    return true;
-  }
-  const key = feature === "hint" ? "hints" : "explanations";
-  return permissions[key] !== false;
-}
-function aiGradeOf(result) {
-  const ratio = result.maxScore > 0 ? result.score / result.maxScore : 0;
-  let category = "partly-correct";
-  if (ratio >= 1 - 1e-9) {
-    category = "correct";
-  } else if (ratio <= 1e-9) {
-    category = "incorrect";
-  }
-  return { score: result.score, maxScore: result.maxScore, passed: result.passed, category };
-}
-function placeholderOrder(passage) {
-  return [...passage.matchAll(_chunkDSDXL3JOcjs.PLACEHOLDER_RE)].map((match) => match[1]);
-}
-function numberedPassage(passage) {
-  let position = 0;
-  return passage.replace(_chunkDSDXL3JOcjs.PLACEHOLDER_RE, () => {
-    position += 1;
-    return `[${position}]`;
-  });
-}
-var legacyCorrect = (detail) => detail.correct === true;
-function detailRight(detail) {
-  const outcome = detail.outcome;
-  return outcome === void 0 ? legacyCorrect(detail) : outcome === "correct";
-}
-function isAnswerOption(detail, chosen) {
-  switch (detail.outcome) {
-    case "correct":
-    case "incorrect-omission":
-      return true;
-    case "incorrect":
-    case "correct-omission":
-      return false;
-    default:
-      return chosen ? legacyCorrect(detail) : !legacyCorrect(detail);
-  }
-}
-var firstString = (value) => Array.isArray(value) ? value[0] : value;
-var listOf = (value) => value === void 0 ? null : Array.isArray(value) ? [...value] : [value];
-function emptyResponse(type) {
-  switch (type) {
-    case "multiple-choice":
-      return { type: "multiple-choice", selectedOptionIds: [] };
-    case "fill-in-the-blanks":
-      return { type: "fill-in-the-blanks", answers: {} };
-    case "gap-select":
-      return { type: "gap-select", selections: {} };
-    case "dictation":
-      return { type: "dictation", text: "" };
-    default:
-      return null;
-  }
-}
-var base = (data) => ({
-  activityId: data.id,
-  title: data.title,
-  ...typeof data.locale === "string" ? { locale: data.locale } : {}
-});
-function buildAiFacts(data, response, details) {
-  const byId = new Map((_nullishCoalesce(details, () => ( []))).map((detail) => [detail.itemId, detail]));
-  const full = data.redacted !== true;
-  switch (data.type) {
-    case "multiple-choice": {
-      const item = data;
-      const chosen = new Set(
-        _optionalChain([response, 'optionalAccess', _ => _.type]) === "multiple-choice" ? response.selectedOptionIds : []
-      );
-      return {
-        ...base(data),
-        activityType: "multiple-choice",
-        question: item.question,
-        mode: item.mode,
-        options: item.options.map((option) => {
-          const detail = byId.get(option.id);
-          const wasChosen = chosen.has(option.id);
-          let correct = null;
-          if (full && typeof option.isCorrect === "boolean") {
-            correct = option.isCorrect;
-          } else if (detail !== void 0) {
-            correct = isAnswerOption(detail, wasChosen);
-          }
-          return {
-            id: option.id,
-            text: option.text,
-            chosen: wasChosen,
-            correct,
-            ...typeof option.feedback === "string" ? { feedback: option.feedback } : {}
-          };
-        })
-      };
-    }
-    case "fill-in-the-blanks": {
-      const item = data;
-      const answers = _optionalChain([response, 'optionalAccess', _2 => _2.type]) === "fill-in-the-blanks" ? response.answers : {};
-      const blanks = new Map(item.blanks.map((blank) => [blank.id, blank]));
-      return {
-        ...base(data),
-        activityType: "fill-in-the-blanks",
-        passage: numberedPassage(item.passage),
-        blanks: placeholderOrder(item.passage).map((id, index) => {
-          const blank = blanks.get(id);
-          const detail = byId.get(id);
-          const accepted = full && Array.isArray(_optionalChain([blank, 'optionalAccess', _3 => _3.acceptedAnswers])) ? [...blank.acceptedAnswers] : listOf(_optionalChain([detail, 'optionalAccess', _4 => _4.correctResponse]));
-          return {
-            id,
-            position: index + 1,
-            typed: typeof answers[id] === "string" ? answers[id] : "",
-            accepted,
-            correct: detail === void 0 ? null : detailRight(detail),
-            ...typeof _optionalChain([blank, 'optionalAccess', _5 => _5.hint]) === "string" ? { hint: blank.hint } : {},
-            ...typeof _optionalChain([blank, 'optionalAccess', _6 => _6.feedback]) === "string" ? { feedback: blank.feedback } : {}
-          };
-        })
-      };
-    }
-    case "gap-select": {
-      const item = data;
-      const selections = _optionalChain([response, 'optionalAccess', _7 => _7.type]) === "gap-select" ? response.selections : {};
-      const gaps = new Map(item.gaps.map((gap) => [gap.id, gap]));
-      const banks = new Map((_nullishCoalesce(item.banks, () => ( []))).map((bank) => [bank.id, bank]));
-      return {
-        ...base(data),
-        activityType: "gap-select",
-        passage: numberedPassage(item.passage),
-        gaps: placeholderOrder(item.passage).map((id, index) => {
-          const gap = gaps.get(id);
-          const choices = _nullishCoalesce(_optionalChain([gap, 'optionalAccess', _8 => _8.choices]), () => ( (_optionalChain([gap, 'optionalAccess', _9 => _9.bankId]) === void 0 ? [] : _nullishCoalesce(_optionalChain([banks, 'access', _10 => _10.get, 'call', _11 => _11(gap.bankId), 'optionalAccess', _12 => _12.choices]), () => ( [])))));
-          const textOf = (choiceId) => choiceId === void 0 ? null : _nullishCoalesce(_optionalChain([choices, 'access', _13 => _13.find, 'call', _14 => _14((choice) => choice.id === choiceId), 'optionalAccess', _15 => _15.text]), () => ( null));
-          const detail = byId.get(id);
-          const answerId = full && typeof _optionalChain([gap, 'optionalAccess', _16 => _16.correctChoiceId]) === "string" ? gap.correctChoiceId : firstString(_optionalChain([detail, 'optionalAccess', _17 => _17.correctResponse]));
-          return {
-            id,
-            position: index + 1,
-            choices: choices.map((choice) => choice.text),
-            chosen: textOf(selections[id]),
-            answer: textOf(answerId),
-            correct: detail === void 0 ? null : detailRight(detail),
-            ...typeof _optionalChain([gap, 'optionalAccess', _18 => _18.feedback]) === "string" ? { feedback: gap.feedback } : {}
-          };
-        })
-      };
-    }
-    case "dictation": {
-      const item = data;
-      const typed = _optionalChain([response, 'optionalAccess', _19 => _19.type]) === "dictation" ? response.text : "";
-      const hasKey = full && typeof item.transcript === "string";
-      let words = null;
-      if (hasKey) {
-        words = _chunkDSDXL3JOcjs.alignDictation.call(void 0, item, typed).words.map((word) => ({
-          expected: word.reference,
-          typed: word.attempt,
-          status: word.status
-        }));
-      } else if (details !== null && details.length > 0) {
-        words = details.map((detail) => {
-          const expected = _nullishCoalesce(firstString(detail.correctResponse), () => ( ""));
-          const attempt = _nullishCoalesce(firstString(detail.learnerResponse), () => ( ""));
-          let status = "incorrect";
-          if (detailRight(detail)) {
-            status = "correct";
-          } else if (attempt === "") {
-            status = "missing";
-          } else if (expected === "") {
-            status = "extra";
-          }
-          return { expected, typed: attempt, status };
-        });
-      }
-      return {
-        ...base(data),
-        activityType: "dictation",
-        transcript: hasKey ? item.transcript : null,
-        typed,
-        words
-      };
-    }
-    default:
-      return null;
-  }
-}
-function gradeLocally(data, response) {
-  if (data.redacted === true) {
-    return null;
-  }
-  try {
-    const result = _chunkVSH7ECQLcjs.score.call(void 0, data.type, data, response);
-    return { details: result.details, grade: aiGradeOf(result) };
-  } catch (e) {
-    return null;
-  }
-}
-function aiExplanationRequest(input) {
-  const { data, response, outcome, learnerLocale } = input;
-  if (!aiSupports(data.type, "explanation") || !aiAllowedByContent(data, "explanation")) {
-    return null;
-  }
-  let details = null;
-  let grade = null;
-  if (_optionalChain([outcome, 'optionalAccess', _20 => _20.status]) === "scored") {
-    const { score: recorded, maxScore, passed } = outcome;
-    if (!_chunkVSH7ECQLcjs.isGradeInRange.call(void 0, recorded, maxScore)) {
-      return null;
-    }
-    details = outcome.details;
-    grade = aiGradeOf({ score: recorded, maxScore, passed });
-  } else if (response !== null) {
-    const local = gradeLocally(data, response);
-    if (local !== null) {
-      details = local.details;
-      grade = local.grade;
-    }
-  }
-  if (grade === null) {
-    return null;
-  }
-  const facts = buildAiFacts(data, response, details);
-  if (facts === null) {
-    return null;
-  }
-  return {
-    feature: "explanation",
-    facts,
-    grade,
-    ...learnerLocale !== void 0 ? { learnerLocale } : {}
-  };
-}
-function aiHintRequest(input) {
-  const { data, previousHints, learnerLocale } = input;
-  if (!aiSupports(data.type, "hint") || !aiAllowedByContent(data, "hint") || data.redacted === true) {
-    return null;
-  }
-  const response = _nullishCoalesce(input.response, () => ( emptyResponse(data.type)));
-  const local = response === null ? null : gradeLocally(data, response);
-  const facts = buildAiFacts(data, response, _nullishCoalesce(_optionalChain([local, 'optionalAccess', _21 => _21.details]), () => ( null)));
-  if (facts === null) {
-    return null;
-  }
-  return {
-    feature: "hint",
-    facts,
-    hintNumber: previousHints.length + 1,
-    previousHints: [...previousHints],
-    ...learnerLocale !== void 0 ? { learnerLocale } : {}
-  };
-}
-var VERDICTS = ["correct", "partly-correct", "incorrect"];
-function provenanceOf(raw) {
-  if (typeof raw !== "object" || raw === null) {
-    return void 0;
-  }
-  const kept = {};
-  for (const key of ["model", "promptHash", "generatedAt"]) {
-    const value = raw[key];
-    if (typeof value === "string" && value.length > 0 && value.length <= 200) {
-      kept[key] = value;
-    }
-  }
-  return Object.keys(kept).length > 0 ? kept : void 0;
-}
-function usageOf(raw) {
-  if (typeof raw !== "object" || raw === null) {
-    return void 0;
-  }
-  const kept = {};
-  for (const key of ["promptTokens", "completionTokens", "costUsd"]) {
-    const value = raw[key];
-    if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
-      kept[key] = value;
-    }
-  }
-  return Object.keys(kept).length > 0 ? kept : void 0;
-}
-function readAiTextResult(raw) {
-  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    return { ok: false, refusal: "malformed" };
-  }
-  const record = raw;
-  if (typeof record.text !== "string") {
-    return { ok: false, refusal: "malformed" };
-  }
-  if (record.verdict !== void 0 && !VERDICTS.includes(record.verdict)) {
-    return { ok: false, refusal: "malformed" };
-  }
-  const text = cleanText(record.text);
-  if (text === "") {
-    return { ok: false, refusal: "empty" };
-  }
-  if ([...text].length > AI_TEXT_MAX_LENGTH) {
-    return { ok: false, refusal: "too-long" };
-  }
-  const provenance = provenanceOf(record.provenance);
-  const usage = usageOf(record.usage);
-  return {
-    ok: true,
-    result: {
-      text,
-      ...record.verdict !== void 0 ? { verdict: record.verdict } : {},
-      ...provenance !== void 0 ? { provenance } : {},
-      ...usage !== void 0 ? { usage } : {}
-    }
-  };
-}
-function checkAiExplanation(raw, request) {
-  const read = readAiTextResult(raw);
-  if (!read.ok) {
-    return read;
-  }
-  if (read.result.verdict !== void 0 && read.result.verdict !== request.grade.category) {
-    return { ok: false, refusal: "contradicts-grade" };
-  }
-  return read;
-}
-function checkAiHint(raw, request) {
-  const read = readAiTextResult(raw);
-  if (!read.ok) {
-    return read;
-  }
-  if (hintRevealsAnswer(request.facts, read.result.text)) {
-    return { ok: false, refusal: "reveals-answer" };
-  }
-  return read;
-}
-function fold(text) {
-  const folded2 = text.normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
-  return folded2 === "" ? [] : folded2.split(" ");
-}
-function containsWords(haystack, needle2) {
-  if (needle2.length === 0 || needle2.length > haystack.length) {
-    return false;
-  }
-  for (let start = 0; start + needle2.length <= haystack.length; start += 1) {
-    let match = true;
-    for (let offset = 0; offset < needle2.length; offset += 1) {
-      if (haystack[start + offset] !== needle2[offset]) {
-        match = false;
-        break;
-      }
-    }
-    if (match) {
-      return true;
-    }
-  }
-  return false;
-}
-var isShort = (words) => words.length === 1 && [...words[0]].length < 4;
-function neighbours(passage, position) {
-  const marker = `[${position}]`;
-  const at = passage.indexOf(marker);
-  if (at === -1) {
-    return {};
-  }
-  const strip = (text) => text.replace(/\[\d+\]/g, " ");
-  const left = fold(strip(passage.slice(0, at)));
-  const right = fold(strip(passage.slice(at + marker.length)));
-  const before = left[left.length - 1];
-  const after = right[0];
-  return {
-    ...before !== void 0 ? { before } : {},
-    ...after !== void 0 ? { after } : {}
-  };
-}
-function hintRevealsAnswer(facts, hint) {
-  const words = fold(hint);
-  const reveals = (answer, passage, position) => {
-    const needle2 = fold(answer);
-    if (needle2.length === 0) {
-      return false;
-    }
-    if (!isShort(needle2) || passage === void 0 || position === void 0) {
-      return containsWords(words, needle2);
-    }
-    const { before, after } = neighbours(passage, position);
-    if (before === void 0 && after === void 0) {
-      return containsWords(words, needle2);
-    }
-    return before !== void 0 && containsWords(words, [before, ...needle2]) || after !== void 0 && containsWords(words, [...needle2, after]);
-  };
-  switch (facts.activityType) {
-    case "multiple-choice":
-      return facts.options.some((option) => option.correct === true && reveals(option.text));
-    case "fill-in-the-blanks":
-      return facts.blanks.some(
-        (blank) => (_nullishCoalesce(blank.accepted, () => ( []))).some((answer) => reveals(answer, facts.passage, blank.position))
-      );
-    case "gap-select":
-      return facts.gaps.some(
-        (gap) => gap.answer !== null && reveals(gap.answer, facts.passage, gap.position)
-      );
-    case "dictation":
-      return false;
-    default:
-      return false;
-  }
-}
-
-// src/ai-coaching.ts
-var AI_COACHING_MAX_WORDS = 20;
-var AI_COACHING_MAX_TIP_LENGTH = 500;
-var MAX_SYMBOL_LENGTH = 16;
-var DIMENSIONS = ["accuracy", "fluency", "completeness", "prosody"];
-var hundredths = (value) => Math.round(value * 1e4) / 100;
-var isFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value);
-function soundsOf(word) {
-  const sounds = [];
-  for (const phoneme of _nullishCoalesce(_optionalChain([word, 'optionalAccess', _22 => _22.phonemes]), () => ( []))) {
-    if (typeof phoneme.symbol !== "string") {
-      continue;
-    }
-    sounds.push({
-      symbol: phoneme.symbol,
-      ...phoneme.accuracy !== void 0 ? { accuracy: phoneme.accuracy } : {},
-      ...phoneme.heardAs !== void 0 && phoneme.heardAs.length > 0 ? { heardAs: phoneme.heardAs.map(({ symbol, score: score2 }) => ({ symbol, score: score2 })) } : {}
-    });
-  }
-  return sounds.length > 0 ? sounds : void 0;
-}
-function fromAssessment(item, assessment) {
-  const words = _chunkVSH7ECQLcjs.alignReadAloud.call(void 0, item, assessment).map((entry) => {
-    const sounds = entry.itemId !== void 0 && entry.wordIndex !== void 0 ? soundsOf(assessment.words[entry.wordIndex]) : void 0;
-    return {
-      ...entry.itemId !== void 0 ? { itemId: entry.itemId } : {},
-      word: entry.reference,
-      heard: entry.heard,
-      state: entry.state,
-      ...entry.accuracy !== void 0 ? { accuracy: entry.accuracy } : {},
-      ...sounds !== void 0 ? { sounds } : {}
-    };
-  });
-  const scores = {};
-  for (const dimension of DIMENSIONS) {
-    const value = assessment.scores[dimension];
-    if (value !== void 0) {
-      scores[dimension] = value;
-    }
-  }
-  return {
-    assessor: assessment.assessor.kind,
-    ...assessment.phonemeAlphabet !== void 0 ? { phonemeAlphabet: assessment.phonemeAlphabet } : {},
-    scores,
-    words
-  };
-}
-var marksThisText = (item, assessment) => _chunkVSH7ECQLcjs.validateSpeechAssessment.call(void 0, assessment).success && assessment.status === "assessed" && assessment.task === "scripted" && assessment.locale === item.locale && assessment.referenceText === item.referenceText;
-var STATE_OF_OUTCOME = {
-  correct: "correct",
-  incorrect: "mispronounced",
-  "incorrect-omission": "omitted"
-};
-function fromGrade(grade) {
-  if (!Array.isArray(grade.details) || grade.details.length === 0) {
-    return null;
-  }
-  const words = [];
-  for (const detail of grade.details) {
-    const state = STATE_OF_OUTCOME[detail.outcome];
-    if (state === void 0 || typeof detail.itemId !== "string") {
-      continue;
-    }
-    const text = (value) => Array.isArray(value) ? value.join(" ") : value;
-    words.push({
-      itemId: detail.itemId,
-      word: text(detail.correctResponse),
-      heard: text(detail.learnerResponse),
-      state,
-      ...state !== "omitted" && isFiniteNumber(detail.score) ? { accuracy: hundredths(detail.score) } : {}
-    });
-  }
-  if (words.length === 0) {
-    return null;
-  }
-  const scores = {};
-  for (const criterion of _nullishCoalesce(grade.criteria, () => ( []))) {
-    const dimension = DIMENSIONS.find((name) => name === criterion.name);
-    if (dimension !== void 0 && isFiniteNumber(criterion.score) && isFiniteNumber(criterion.maxScore) && criterion.maxScore > 0) {
-      scores[dimension] = hundredths(criterion.score / criterion.maxScore);
-    }
-  }
-  const kind = _optionalChain([grade, 'access', _23 => _23.grader, 'optionalAccess', _24 => _24.kind]);
-  return {
-    assessor: kind === "auto" || kind === "ai" || kind === "human" ? kind : "unknown",
-    scores,
-    words
-  };
-}
-function aiCoachingRequest(input) {
-  const { data, assessment, grade, learnerLocale } = input;
-  if (!aiSupports(data.type, "pronunciation-coaching") || !aiAllowedByContent(data, "pronunciation-coaching")) {
-    return null;
-  }
-  const item = data;
-  if (typeof item.referenceText !== "string" || typeof item.locale !== "string") {
-    return null;
-  }
-  const marks = assessment !== void 0 && assessment !== null ? marksThisText(item, assessment) ? fromAssessment(item, assessment) : null : grade !== void 0 && grade !== null ? fromGrade(grade) : null;
-  if (marks === null) {
-    return null;
-  }
-  const graded = grade !== void 0 && grade !== null && isFiniteNumber(grade.score) && isFiniteNumber(grade.maxScore) && typeof grade.passed === "boolean" ? { score: grade.score, maxScore: grade.maxScore, passed: grade.passed } : void 0;
-  return {
-    feature: "pronunciation-coaching",
-    facts: {
-      activityType: "read-aloud",
-      activityId: data.id,
-      title: data.title,
-      locale: item.locale,
-      referenceText: item.referenceText,
-      ...typeof item.instructions === "string" ? { instructions: item.instructions } : {},
-      ...marks
-    },
-    ...graded !== void 0 ? { grade: graded } : {},
-    ...learnerLocale !== void 0 ? { learnerLocale } : {}
-  };
-}
-var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-var symbolKey = (symbol) => symbol.normalize("NFC").trim();
-function checkAiCoaching(raw, request) {
-  const read = readAiTextResult(raw);
-  if (!read.ok) {
-    return read;
-  }
-  const entries = raw.words;
-  const words = [];
-  if (entries !== void 0 && entries !== null) {
-    if (!Array.isArray(entries)) {
-      return { ok: false, refusal: "malformed" };
-    }
-    if (entries.length > AI_COACHING_MAX_WORDS) {
-      return { ok: false, refusal: "too-long" };
-    }
-    const facts = /* @__PURE__ */ new Map();
-    request.facts.words.forEach((fact, order) => {
-      if (fact.itemId !== void 0) {
-        facts.set(fact.itemId, { fact, order });
-      }
-    });
-    const seen = /* @__PURE__ */ new Set();
-    for (const entry of entries) {
-      if (!isRecord(entry) || typeof entry.itemId !== "string" || typeof entry.tip !== "string") {
-        return { ok: false, refusal: "malformed" };
-      }
-      const tip = cleanText(entry.tip);
-      if (tip === "") {
-        return { ok: false, refusal: "malformed" };
-      }
-      if ([...tip].length > AI_COACHING_MAX_TIP_LENGTH) {
-        return { ok: false, refusal: "too-long" };
-      }
-      if (seen.has(entry.itemId)) {
-        return { ok: false, refusal: "malformed" };
-      }
-      seen.add(entry.itemId);
-      const found = facts.get(entry.itemId);
-      if (found === void 0 || found.fact.state !== "mispronounced" && found.fact.state !== "omitted") {
-        return { ok: false, refusal: "contradicts-marks" };
-      }
-      const sound = checkSound(entry.sound, found.fact);
-      if (sound !== void 0 && "refusal" in sound) {
-        return sound;
-      }
-      words.push({
-        itemId: entry.itemId,
-        word: found.fact.word,
-        tip,
-        ...sound !== void 0 ? { sound } : {},
-        order: found.order
-      });
-    }
-  }
-  const { text, provenance, usage } = read.result;
-  return {
-    ok: true,
-    coaching: {
-      text,
-      words: words.sort((a, b) => a.order - b.order).map(({ order: _order, ...word }) => word),
-      ...provenance !== void 0 ? { provenance } : {},
-      ...usage !== void 0 ? { usage } : {}
-    }
-  };
-}
-function checkSound(raw, fact) {
-  if (raw === void 0 || raw === null) {
-    return void 0;
-  }
-  if (!isRecord(raw) || typeof raw.expected !== "string" || raw.heard !== void 0 && raw.heard !== null && typeof raw.heard !== "string") {
-    return { ok: false, refusal: "malformed" };
-  }
-  const heard = typeof raw.heard === "string" ? raw.heard : void 0;
-  if ([...raw.expected].length > MAX_SYMBOL_LENGTH || heard !== void 0 && [...heard].length > MAX_SYMBOL_LENGTH) {
-    return { ok: false, refusal: "too-long" };
-  }
-  const expected = symbolKey(raw.expected);
-  const reported = _optionalChain([fact, 'access', _25 => _25.sounds, 'optionalAccess', _26 => _26.find, 'call', _27 => _27((sound) => symbolKey(sound.symbol) === expected)]);
-  if (reported === void 0) {
-    return { ok: false, refusal: "contradicts-marks" };
-  }
-  if (heard === void 0) {
-    return { expected: reported.symbol };
-  }
-  const instead = _optionalChain([reported, 'access', _28 => _28.heardAs, 'optionalAccess', _29 => _29.find, 'call', _30 => _30(
-    (candidate) => symbolKey(candidate.symbol) === symbolKey(heard)
-  )]);
-  if (instead === void 0) {
-    return { ok: false, refusal: "contradicts-marks" };
-  }
-  return { expected: reported.symbol, heard: instead.symbol };
-}
-
-// src/ai-writing.ts
-var AI_WRITING_MAX_CORRECTIONS = 20;
-var AI_WRITING_MAX_FIELD_LENGTH = 500;
-var MAX_TAG_LENGTH = 40;
-function aiWritingFeedbackRequest(input) {
-  const { data, response, learnerLocale } = input;
-  if (!aiSupports(data.type, "writing-feedback") || !aiAllowedByContent(data, "writing-feedback") || data.redacted === true) {
-    return null;
-  }
-  const text = _optionalChain([response, 'optionalAccess', _31 => _31.type]) === "written-response" ? response.text : "";
-  if (typeof text !== "string" || text.trim() === "") {
-    return null;
-  }
-  const item = data;
-  const wordCount = _chunkDSDXL3JOcjs.countWords.call(void 0, text);
-  const minWords = typeof item.minWords === "number" ? item.minWords : 0;
-  const maxWords = typeof item.maxWords === "number" ? item.maxWords : Number.POSITIVE_INFINITY;
-  const criteria = Array.isArray(_optionalChain([item, 'access', _32 => _32.rubric, 'optionalAccess', _33 => _33.criteria])) ? item.rubric.criteria : null;
-  const rubric = criteria === null || criteria.length === 0 ? null : criteria.map((criterion) => ({
-    name: criterion.name,
-    ...typeof criterion.description === "string" ? { description: criterion.description } : {},
-    weight: criterion.weight
-  }));
-  const previousFeedback = [..._nullishCoalesce(input.previousFeedback, () => ( []))];
-  return {
-    feature: "writing-feedback",
-    facts: {
-      activityType: "written-response",
-      activityId: data.id,
-      title: data.title,
-      ...typeof data.locale === "string" ? { locale: data.locale } : {},
-      prompt: typeof item.prompt === "string" ? item.prompt : "",
-      text,
-      wordCount,
-      minWords,
-      maxWords,
-      withinWordBounds: wordCount >= minWords && wordCount <= maxWords,
-      rubric,
-      ...typeof item.languageTarget === "string" ? { languageTarget: item.languageTarget } : {}
-    },
-    draftNumber: previousFeedback.length + 1,
-    previousFeedback,
-    ...learnerLocale !== void 0 ? { learnerLocale } : {}
-  };
-}
-var QUOTE_FOLD = {
-  "\u2018": "'",
-  "\u2019": "'",
-  "\u201B": "'",
-  "\u2032": "'",
-  "\u201C": '"',
-  "\u201D": '"',
-  "\u201E": '"',
-  "\u2033": '"'
-};
-function folded(text) {
-  let chars = "";
-  const from = [];
-  let space = false;
-  for (let at = 0; at < text.length; at += 1) {
-    const char = text[at];
-    if (/\s/u.test(char)) {
-      if (!space) {
-        chars += " ";
-        from.push(at);
-        space = true;
-      }
-      continue;
-    }
-    space = false;
-    chars += _nullishCoalesce(QUOTE_FOLD[char], () => ( char));
-    from.push(at);
-  }
-  return { chars, from };
-}
-var needle = (quote) => folded(quote).chars.trim();
-function anchor(draft, quote, claimed, taken) {
-  const sought = needle(quote);
-  if (sought === "") {
-    return null;
-  }
-  if (claimed !== void 0) {
-    const { start, end } = claimed;
-    if (!Number.isSafeInteger(start) || !Number.isSafeInteger(end) || start < 0 || end > draft.text.length || start >= end) {
-      return null;
-    }
-    const span = draft.text.slice(start, end);
-    if (needle(span) !== sought) {
-      return null;
-    }
-    const lead = span.length - span.trimStart().length;
-    const trail = span.length - span.trimEnd().length;
-    return { start: start + lead, end: end - trail };
-  }
-  let first = null;
-  for (let at = draft.chars.indexOf(sought); at !== -1; at = draft.chars.indexOf(sought, at + 1)) {
-    const start = draft.from[at];
-    const end = draft.from[at + sought.length - 1] + 1;
-    const found = { start, end };
-    first ??= found;
-    const key = `${start}:${end}`;
-    if (!taken.has(key)) {
-      taken.add(key);
-      return found;
-    }
-  }
-  return first;
-}
-function textField(value, max) {
-  if (value === void 0 || value === null) {
-    return { ok: true, value: void 0 };
-  }
-  if (typeof value !== "string") {
-    return { ok: false, refusal: "malformed" };
-  }
-  const cleaned = cleanText(value);
-  if ([...cleaned].length > max) {
-    return { ok: false, refusal: "too-long" };
-  }
-  return { ok: true, value: cleaned === "" ? void 0 : cleaned };
-}
-var isRecord2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-function checkCorrections(raw, text) {
-  if (raw === void 0 || raw === null) {
-    return { ok: true, corrections: [] };
-  }
-  if (!Array.isArray(raw)) {
-    return { ok: false, refusal: "malformed" };
-  }
-  if (raw.length > AI_WRITING_MAX_CORRECTIONS) {
-    return { ok: false, refusal: "too-long" };
-  }
-  const draft = { text, ...folded(text) };
-  const taken = /* @__PURE__ */ new Set();
-  const corrections = [];
-  for (const entry of raw) {
-    if (!isRecord2(entry) || typeof entry.original !== "string") {
-      return { ok: false, refusal: "malformed" };
-    }
-    if (typeof entry.corrected !== "string") {
-      return { ok: false, refusal: "malformed" };
-    }
-    if ([...entry.original].length > AI_WRITING_MAX_FIELD_LENGTH || [...entry.corrected].length > AI_WRITING_MAX_FIELD_LENGTH) {
-      return { ok: false, refusal: "too-long" };
-    }
-    if (needle(entry.original) === needle(entry.corrected)) {
-      return { ok: false, refusal: "malformed" };
-    }
-    const explanation = textField(entry.explanation, AI_WRITING_MAX_FIELD_LENGTH);
-    const category = textField(entry.category, MAX_TAG_LENGTH);
-    if (!explanation.ok) {
-      return explanation;
-    }
-    if (!category.ok) {
-      return category;
-    }
-    let claimed;
-    if (entry.range !== void 0 && entry.range !== null) {
-      if (!isRecord2(entry.range)) {
-        return { ok: false, refusal: "malformed" };
-      }
-      claimed = { start: entry.range.start, end: entry.range.end };
-    }
-    const at = anchor(draft, entry.original, claimed, taken);
-    if (at === null) {
-      return { ok: false, refusal: "misquotes-answer" };
-    }
-    corrections.push({
-      original: text.slice(at.start, at.end),
-      corrected: cleanText(entry.corrected),
-      ...explanation.value !== void 0 ? { explanation: explanation.value } : {},
-      ...category.value !== void 0 ? { category: category.value } : {},
-      range: at
-    });
-  }
-  return { ok: true, corrections };
-}
-function isJudgedScore(score2, maxScore) {
-  if (score2 === void 0) {
-    return maxScore === void 0 || typeof maxScore === "number" && maxScore > 0;
-  }
-  const max = _nullishCoalesce(maxScore, () => ( 1));
-  return typeof score2 === "number" && typeof max === "number" && Number.isFinite(score2) && Number.isFinite(max) && max > 0 && score2 >= 0 && score2 - max <= max * 1e-9;
-}
-function checkCriteria(raw, rubric) {
-  if (raw === void 0 || raw === null) {
-    return { ok: true, criteria: [] };
-  }
-  if (!Array.isArray(raw)) {
-    return { ok: false, refusal: "malformed" };
-  }
-  if (raw.length === 0) {
-    return { ok: true, criteria: [] };
-  }
-  if (rubric === null) {
-    return { ok: false, refusal: "malformed" };
-  }
-  const weights = new Map(rubric.map((criterion) => [criterion.name, criterion.weight]));
-  const seen = /* @__PURE__ */ new Set();
-  const criteria = [];
-  for (const entry of raw) {
-    if (!isRecord2(entry) || typeof entry.name !== "string") {
-      return { ok: false, refusal: "malformed" };
-    }
-    const weight = weights.get(entry.name);
-    if (weight === void 0 || seen.has(entry.name)) {
-      return { ok: false, refusal: "malformed" };
-    }
-    seen.add(entry.name);
-    if (!isJudgedScore(entry.score, entry.maxScore)) {
-      return { ok: false, refusal: "malformed" };
-    }
-    if (entry.notApplicable !== void 0 && typeof entry.notApplicable !== "boolean") {
-      return { ok: false, refusal: "malformed" };
-    }
-    const band = textField(entry.band, MAX_TAG_LENGTH);
-    const comment = textField(entry.comment, AI_WRITING_MAX_FIELD_LENGTH);
-    if (!band.ok) {
-      return band;
-    }
-    if (!comment.ok) {
-      return comment;
-    }
-    criteria.push({
-      name: entry.name,
-      ...typeof entry.score === "number" ? { score: entry.score } : {},
-      ...typeof entry.maxScore === "number" ? { maxScore: entry.maxScore } : {},
-      ...band.value !== void 0 ? { band: band.value } : {},
-      ...comment.value !== void 0 ? { comment: comment.value } : {},
-      ...entry.notApplicable === true ? { notApplicable: true } : {},
-      weight
-    });
-  }
-  return { ok: true, criteria };
-}
-function checkAiWritingFeedback(raw, request) {
-  const read = readAiTextResult(raw);
-  if (!read.ok) {
-    return read;
-  }
-  const record = raw;
-  const corrections = checkCorrections(record.corrections, request.facts.text);
-  if (!corrections.ok) {
-    return corrections;
-  }
-  const rubric = request.facts.rubric;
-  const criteria = checkCriteria(record.criteria, rubric);
-  if (!criteria.ok) {
-    return criteria;
-  }
-  let indicativeScore = null;
-  const judged = new Set(criteria.criteria.map((criterion) => criterion.name));
-  if (_optionalChain([rubric, 'optionalAccess', _34 => _34.every, 'call', _35 => _35((criterion) => judged.has(criterion.name))])) {
-    const grade = _chunkVSH7ECQLcjs.gradeFromRubric.call(void 0, criteria.criteria);
-    indicativeScore = "unscorable" in grade ? null : grade.score;
-  }
-  const { text, provenance, usage } = read.result;
-  return {
-    ok: true,
-    feedback: {
-      text,
-      corrections: corrections.corrections,
-      criteria: criteria.criteria,
-      indicativeScore,
-      ...provenance !== void 0 ? { provenance } : {},
-      ...usage !== void 0 ? { usage } : {}
-    }
-  };
-}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-exports.AI_EXPLANATION_TYPES = AI_EXPLANATION_TYPES; exports.AI_HINT_TYPES = AI_HINT_TYPES; exports.AI_TEXT_MAX_LENGTH = AI_TEXT_MAX_LENGTH; exports.aiSupports = aiSupports; exports.aiAllowedByContent = aiAllowedByContent; exports.aiGradeOf = aiGradeOf; exports.buildAiFacts = buildAiFacts; exports.aiExplanationRequest = aiExplanationRequest; exports.aiHintRequest = aiHintRequest; exports.readAiTextResult = readAiTextResult; exports.checkAiExplanation = checkAiExplanation; exports.checkAiHint = checkAiHint; exports.hintRevealsAnswer = hintRevealsAnswer; exports.AI_COACHING_MAX_WORDS = AI_COACHING_MAX_WORDS; exports.AI_COACHING_MAX_TIP_LENGTH = AI_COACHING_MAX_TIP_LENGTH; exports.aiCoachingRequest = aiCoachingRequest; exports.checkAiCoaching = checkAiCoaching; exports.AI_WRITING_MAX_CORRECTIONS = AI_WRITING_MAX_CORRECTIONS; exports.AI_WRITING_MAX_FIELD_LENGTH = AI_WRITING_MAX_FIELD_LENGTH; exports.aiWritingFeedbackRequest = aiWritingFeedbackRequest; exports.checkAiWritingFeedback = checkAiWritingFeedback;
-//# sourceMappingURL=chunk-LDFQUZII.cjs.map