@intellectif/lk-react 13.0.0 → 14.0.0

package/dist/chunk-YMBBM5K7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/ActivityPreview/ActivityPreview.tsx"],"names":[],"mappings":"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","file":"chunk-YMBBM5K7.js","sourcesContent":["'use client';\n\nimport {\n  type ActivityType,\n  type DraftNotComplete,\n  evaluate,\n  type ItemOutcome,\n  type LearnerResponse,\n  slotMediaKey,\n  type ThemeTokens,\n  validateDraft,\n} from '@intellectif/lk-core';\nimport { type ReactNode, useMemo } from 'react';\nimport { useLkStrings } from '../../i18n/LkIntlProvider.js';\nimport type { LkStringsOverride } from '../../i18n/strings.js';\nimport { ActivityErrorBoundary } from '../ActivityErrorBoundary.js';\nimport type { ActivityRenderer } from '../ActivitySequence/index.js';\nimport { Dictation } from '../Dictation/index.js';\nimport { FillInTheBlanks } from '../FillInTheBlanks/index.js';\nimport { GapSelect } from '../GapSelect/index.js';\nimport { MultipleChoice } from '../MultipleChoice/index.js';\nimport { ReadAloud } from '../ReadAloud/index.js';\nimport type { RecordingBinding } from '../ReadAloud/ReadAloud.js';\nimport type { HtmlSanitizer, MediaBudgetBinding, RenderMode } from '../types.js';\nimport { WrittenResponse } from '../WrittenResponse/index.js';\n\n/**\n * The option-shuffle seed a preview uses when none is given. Fixed, so a\n * shuffled question holds still while its author edits it instead of\n * re-ordering on every remount.\n */\nconst PREVIEW_SHUFFLE_SEED = 'lk-activity-preview';\n\n/**\n * The slot a previewed activity stands in for. A recording's play budget is\n * keyed to it and lives only in this mount: the preview counts plays so an\n * author hears the limit a learner gets, and records none of them.\n */\nconst PREVIEW_SLOT_ID = 'preview';\n\n/** Numbers the takes a preview mints keys for, so two are never the same take. */\nlet previewTakeCount = 0;\n\n/**\n * The store a previewed read-aloud records into: it keys the take so the whole\n * flow — record, play it back, submit — runs for the author, and keeps it\n * nowhere, like every other thing a preview does not record.\n *\n * It judges nothing, deliberately. `assess` is optional precisely so this can\n * exist: an author trying a reading out has no assessor to point at, and a\n * preview that demanded one would refuse to render the most common case. The\n * default `practice` mode then shows the \"assessment is not available\" notice,\n * which is the truth about this binding rather than a failure.\n */\nconst PREVIEW_RECORDING: RecordingBinding = {\n  upload: async (take) => {\n    previewTakeCount += 1;\n    return {\n      key: `${PREVIEW_SLOT_ID}-take-${previewTakeCount}`,\n      mimeType: take.mimeType,\n      durationMs: take.durationMs,\n    };\n  },\n};\n\nexport interface ActivityPreviewProps {\n  /**\n   * The activity as an editor holds it right now, finished or not. It is checked\n   * with `validateDraft` before anything renders — by content, on every render —\n   * so a half-written question never reaches a component that assumes a valid\n   * one.\n   */\n  draft: unknown;\n  /** The mode to preview in. Defaults to `practice`. */\n  renderMode?: RenderMode;\n  /**\n   * A learner response to show as if a learner had given it. In `practice` and\n   * `exam` it seeds the answer, which stays editable; in `review` it is the\n   * submitted answer, marked by `evaluate()` unless `outcome` is given.\n   */\n  response?: LearnerResponse;\n  /**\n   * The outcome `review` marks the response with, instead of the one\n   * `evaluate()` computes — which is how to preview a returned grade on a written\n   * response, since the SDK cannot score one. Ignored in other modes.\n   */\n  outcome?: ItemOutcome;\n  /**\n   * Rendered in place of the activity while the draft is not complete, with the\n   * issues `validateDraft` found — so an editor can list them in its own words.\n   * The issue messages are English, and a preview that rendered them would put\n   * untranslatable text on screen. Without it, the preview shows the\n   * `previewIncomplete` or `previewInvalid` string.\n   */\n  fallback?: (result: DraftNotComplete) => ReactNode;\n  /**\n   * Renderers for activity types beyond the built-ins, keyed by `type`, as on\n   * `<ActivitySequence>`. An entry receives the shared prop contract and\n   * nothing else, so — like the shuffle seed below — the in-memory recording\n   * binding a previewed read-aloud is given does not reach one.\n   */\n  renderers?: Readonly<Record<string, ActivityRenderer>>;\n  /**\n   * Seeds `<MultipleChoice>`'s option shuffle. Defaults to a fixed seed, so the\n   * order holds while options are edited; adding or removing one deals them\n   * again, because the shuffle orders by position. A `renderers` entry is given\n   * no seed, as on `<ActivitySequence>`.\n   */\n  shuffleSeed?: string;\n  /** Renders author-supplied rich text. See `HtmlSanitizer`. */\n  sanitizeHtml?: HtmlSanitizer;\n  /** Overrides the SDK's chrome text, for the preview's notice and the activity alike. */\n  strings?: LkStringsOverride;\n  /** Per-instance token overrides, passed to the activity. */\n  theme?: Partial<ThemeTokens>;\n  /** BCP 47 tag of the interface language, passed to the activity. */\n  locale?: string;\n}\n\ntype Marking = { kind: 'marked'; outcome: ItemOutcome } | { kind: 'failed'; error: Error };\n\n/**\n * Renders an activity from an editor's draft, in any render mode, with a\n * simulated learner response — and renders a notice instead while the draft is\n * not an activity yet.\n *\n * Nothing it renders is recorded: no callback is wired, so a practice attempt in\n * a preview scores locally and goes nowhere, and a recording's play limit is\n * counted in memory only.\n *\n * A draft with no string `type`, a type nobody registered, and a `response` of a\n * different type from the draft are wiring errors, and throw.\n */\nexport function ActivityPreview({\n  draft,\n  renderMode = 'practice',\n  response,\n  outcome,\n  fallback,\n  renderers,\n  shuffleSeed,\n  sanitizeHtml,\n  strings,\n  theme,\n  locale,\n}: ActivityPreviewProps) {\n  const s = useLkStrings(strings);\n  const type = isRecord(draft) && typeof draft.type === 'string' ? draft.type : undefined;\n\n  // Validated on the draft's CONTENT, not its identity. The activity components\n  // restart whenever `data` changes identity, and an editor that rebuilds its\n  // payload on every change would otherwise restart the question an author is\n  // trying out each time anything else on the page was edited. The key is read\n  // on every render, so a draft changed in place is checked again too.\n  const contentKey = contentKeyOf(draft);\n  // biome-ignore lint/correctness/useExhaustiveDependencies: the draft's content (contentKey) is the trigger, not its identity\n  const result = useMemo(\n    () => (type === undefined ? undefined : validateDraft(type as ActivityType, draft)),\n    [type, contentKey],\n  );\n  const activity = result?.status === 'complete' ? result.data : undefined;\n  const responseFits = response === undefined || response.type === type;\n  const responseKey = response === undefined ? 'none' : contentKeyOf(response);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: the response's content (responseKey) is the trigger, not its identity\n  const marking = useMemo((): Marking | undefined => {\n    if (renderMode !== 'review' || activity === undefined) {\n      return undefined;\n    }\n    if (outcome !== undefined) {\n      return { kind: 'marked', outcome };\n    }\n    if (response === undefined || !responseFits) {\n      return undefined;\n    }\n    try {\n      return { kind: 'marked', outcome: evaluate(activity, response) };\n    } catch (thrown) {\n      // Scored here, during this component's own render, where no error boundary\n      // inside the activity can catch it — so it is handed to one below.\n      return {\n        kind: 'failed',\n        error: thrown instanceof Error ? thrown : new Error(String(thrown)),\n      };\n    }\n  }, [renderMode, activity, outcome, responseKey, responseFits]);\n\n  const activityId = activity?.id;\n  const mediaBudget = useMemo<MediaBudgetBinding>(\n    () => ({\n      key: slotMediaKey(PREVIEW_SLOT_ID),\n      slotId: PREVIEW_SLOT_ID,\n      index: 0,\n      ...(activityId !== undefined ? { activityId } : {}),\n    }),\n    [activityId],\n  );\n\n  // All hooks are called before these throws, so hook order stays stable.\n  if (type === undefined || result === undefined) {\n    throw new Error(\n      '<ActivityPreview> needs a draft object with a string `type`, to know which activity to check and render.',\n    );\n  }\n  // Checked against the draft's own type, whatever state the draft is in. A\n  // mis-wired response is a wiring error however unfinished the draft is, and\n  // waiting for the draft to be complete would throw on the very edit that\n  // completes it.\n  if (response !== undefined && !responseFits) {\n    throw new Error(\n      `<ActivityPreview> was given a \"${response.type}\" response for a \"${type}\" activity.`,\n    );\n  }\n  if (result.status !== 'complete') {\n    if (fallback !== undefined) {\n      return <>{fallback(result)}</>;\n    }\n    return (\n      <div\n        className=\"lk-preview-unavailable\"\n        role=\"note\"\n        data-status={result.status}\n        {...(locale !== undefined ? { lang: locale } : {})}\n      >\n        {result.status === 'invalid' ? s.previewInvalid : s.previewIncomplete}\n      </div>\n    );\n  }\n  const data = result.data;\n\n  // A different simulated response, or a different mode, mounts the activity\n  // afresh, play count included: a seeded answer is read at mount, and a practice\n  // attempt the author submitted must not carry over into an exam preview. So\n  // does a different recording or playback policy, which is a different listening\n  // budget — the transport reads its count once, when it mounts.\n  const key = `${renderMode}:${responseKey}:${recordingKeyOf(data)}`;\n\n  if (marking?.kind === 'failed') {\n    // The response is one the scorer cannot read, or a registered scorer threw.\n    // Shown as the activity's error fallback, as a render failure would be.\n    return (\n      <ActivityErrorBoundary key={key} activityTitle={data.title} strings={s}>\n        <Rethrow error={marking.error} />\n      </ActivityErrorBoundary>\n    );\n  }\n\n  const shared = {\n    renderMode,\n    // Without a binding a budgeted recording counts nothing in `practice`, and in\n    // `exam` the media component refuses to render at all — rightly, on a real\n    // paper, where nothing would persist the count. A preview persists nothing by\n    // design, so it keeps the count in memory and says so.\n    mediaBudget,\n    ...(sanitizeHtml !== undefined ? { sanitizeHtml } : {}),\n    ...(strings !== undefined ? { strings } : {}),\n    ...(theme !== undefined ? { theme } : {}),\n    ...(locale !== undefined ? { locale } : {}),\n    // Seeded rather than controlled, in every mode, exactly as `<ActivitySequence>`\n    // hands a restored answer to its slots — so a renderer written for the\n    // sequence reads it here too. `review` is read-only either way, and `key`\n    // above re-seeds whenever the response changes.\n    ...(response !== undefined ? { defaultValue: response } : {}),\n    ...(marking !== undefined ? { outcome: marking.outcome } : {}),\n  };\n\n  const Custom = renderers?.[data.type];\n  if (Custom !== undefined) {\n    return <Custom key={key} data={data} {...shared} />;\n  }\n  switch (data.type) {\n    case 'multiple-choice':\n      return (\n        <MultipleChoice\n          key={key}\n          data={data}\n          shuffleSeed={shuffleSeed ?? PREVIEW_SHUFFLE_SEED}\n          {...shared}\n        />\n      );\n    case 'fill-in-the-blanks':\n      return <FillInTheBlanks key={key} data={data} {...shared} />;\n    case 'gap-select':\n      return (\n        <GapSelect\n          key={key}\n          data={data}\n          shuffleSeed={shuffleSeed ?? PREVIEW_SHUFFLE_SEED}\n          {...shared}\n        />\n      );\n    case 'written-response':\n      return <WrittenResponse key={key} data={data} {...shared} />;\n    case 'dictation':\n      return <Dictation key={key} data={data} {...shared} />;\n    case 'read-aloud':\n      return <ReadAloud key={key} data={data} recordingBinding={PREVIEW_RECORDING} {...shared} />;\n    default:\n      return (\n        <div className=\"lk-preview-unsupported\" role=\"note\">\n          {s.unsupportedActivity}\n        </div>\n      );\n  }\n}\n\n/** Throws `error` while rendering, so the error boundary around it shows its fallback. */\nfunction Rethrow({ error }: { error: Error }): never {\n  throw error;\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * The recording and its playback policy — not its description, which changes\n * no budget — plus the slower file a dictation or a read-aloud carries, which\n * follows the same policy and must remount when it is swapped for another.\n */\nfunction recordingKeyOf(data: unknown): string {\n  const media = isRecord(data) ? data.media : undefined;\n  const slowMedia = isRecord(data) ? data.slowMedia : undefined;\n  const slowUrl = isRecord(slowMedia) ? slowMedia.url : undefined;\n  if (!isRecord(media) && slowUrl === undefined) {\n    return '';\n  }\n  return contentKeyOf([\n    isRecord(media) ? media.type : undefined,\n    isRecord(media) ? media.url : undefined,\n    isRecord(media) ? media.playback : undefined,\n    slowUrl,\n  ]);\n}\n\nconst identities = new WeakMap<object, number>();\nlet lastIdentity = 0;\n\n/** A key for a value compared by identity: the same object always gets the same one. */\nfunction identityKeyOf(value: object): string {\n  let identity = identities.get(value);\n  if (identity === undefined) {\n    lastIdentity += 1;\n    identity = lastIdentity;\n    identities.set(value, identity);\n  }\n  return `#${identity}`;\n}\n\n/**\n * A string that changes exactly when a value's content does.\n *\n * Object keys are sorted, because key order is not content: a draft saved to a\n * JSON column comes back with its keys reordered. Every value is written in a\n * form no other value shares — JSON would write a non-finite number as `null`\n * and drop `undefined`, and those decide different issues. What JSON does not\n * describe — an instance of a class, a function, a reference back to an\n * enclosing object — is compared by identity, and a symbol by its description.\n */\nfunction contentKeyOf(value: unknown, enclosing: Set<object> = new Set()): string {\n  switch (typeof value) {\n    case 'string':\n      return JSON.stringify(value);\n    case 'number':\n      // `String` keeps NaN, the infinities and every other number apart; only -0\n      // needs saying.\n      return Object.is(value, -0) ? '-0' : String(value);\n    case 'bigint':\n      return `${value}n`;\n    case 'boolean':\n    case 'undefined':\n      return String(value);\n    case 'symbol':\n      return `Symbol(${JSON.stringify(value.description ?? null)})`;\n    case 'function':\n      return identityKeyOf(value);\n  }\n  // Every other `typeof` has returned above: this is `null`, or an object.\n  if (value === null || typeof value !== 'object') {\n    return 'null';\n  }\n  const prototype = Object.getPrototypeOf(value);\n  const plain = Array.isArray(value) || prototype === Object.prototype || prototype === null;\n  if (!plain || enclosing.has(value)) {\n    return identityKeyOf(value);\n  }\n  enclosing.add(value);\n  try {\n    if (Array.isArray(value)) {\n      return `[${Array.from(value, (item) => contentKeyOf(item, enclosing)).join(',')}]`;\n    }\n    const record = value as Record<string, unknown>;\n    const fields = Object.keys(record)\n      .sort()\n      .map((field) => `${JSON.stringify(field)}:${contentKeyOf(record[field], enclosing)}`);\n    return `{${fields.join(',')}}`;\n  } finally {\n    enclosing.delete(value);\n  }\n}\n"]}

package/dist/chunk-YORQQXGO.js

@@ -0,0 +1,155 @@
+'use client';
+// src/i18n/direction.ts
+var RTL_SCRIPT_CODES = /* @__PURE__ */ new Set([
+  "phlv",
+  "adlm",
+  "arab",
+  "aran",
+  "armi",
+  "avst",
+  "chrs",
+  "cprt",
+  "elym",
+  "gara",
+  "hatr",
+  "hebr",
+  "hung",
+  "khar",
+  "lydi",
+  "mand",
+  "mani",
+  "mend",
+  "merc",
+  "mero",
+  "narb",
+  "nbat",
+  "nkoo",
+  "orkh",
+  "ougr",
+  "palm",
+  "phli",
+  "phlp",
+  "phnx",
+  "prti",
+  "rohg",
+  "samr",
+  "sarb",
+  "sidt",
+  "sogd",
+  "sogo",
+  "syrc",
+  "syre",
+  "syrj",
+  "syrn",
+  "thaa",
+  "yezi"
+]);
+var RTL_LANGUAGES = /* @__PURE__ */ new Set([
+  "acm",
+  "aeb",
+  "aii",
+  "ajp",
+  "apc",
+  "ar",
+  "arc",
+  "ars",
+  "ary",
+  "arz",
+  "azb",
+  "bqi",
+  "ckb",
+  "dv",
+  "fa",
+  "glk",
+  "hbo",
+  "he",
+  "iw",
+  "ji",
+  "jrb",
+  "khw",
+  "lrc",
+  "mzn",
+  "nqo",
+  "ota",
+  "pnb",
+  "prs",
+  "ps",
+  "sdh",
+  "skr",
+  "syc",
+  "syr",
+  "ur",
+  "yi"
+]);
+var RTL_BLOCKS = [
+  [1424, 2303],
+  [64285, 65023],
+  [65136, 65279],
+  [67584, 69631],
+  [124928, 126975]
+];
+var RTL_DIGITS = [
+  [1984, 1993],
+  [125127, 125135],
+  [125264, 125273]
+];
+var LETTER_RE = /^\p{L}$/u;
+var NUMBER_RE = /^\p{N}$/u;
+function within(point, ranges) {
+  return ranges.some(([first, last]) => point >= first && point <= last);
+}
+function scriptSubtagOf(subtags) {
+  if (subtags[0].length === 1) {
+    return void 0;
+  }
+  let index = 1;
+  while (index < subtags.length && index <= 3 && /^[a-z]{3}$/.test(subtags[index])) {
+    index += 1;
+  }
+  const candidate = subtags[index];
+  if (candidate === void 0 || !/^[a-z]{4}$/.test(candidate)) {
+    return void 0;
+  }
+  return /^z/.test(candidate) || candidate >= "qaaa" && candidate <= "qabx" ? void 0 : candidate;
+}
+function localeDirectionOf(locale) {
+  if (typeof locale !== "string") {
+    return void 0;
+  }
+  const subtags = locale.toLowerCase().split(/[-_]/);
+  const script = scriptSubtagOf(subtags);
+  if (script !== void 0) {
+    return RTL_SCRIPT_CODES.has(script) ? "rtl" : "ltr";
+  }
+  return RTL_LANGUAGES.has(subtags[0]) ? "rtl" : void 0;
+}
+var LEFT_TO_RIGHT_MARK = String.fromCodePoint(8206);
+var RIGHT_TO_LEFT_MARKS = /* @__PURE__ */ new Set([String.fromCodePoint(8207), String.fromCodePoint(1564)]);
+function textDirectionOf(text) {
+  for (const character of text) {
+    if (character === LEFT_TO_RIGHT_MARK) {
+      return "ltr";
+    }
+    if (RIGHT_TO_LEFT_MARKS.has(character)) {
+      return "rtl";
+    }
+    if (LETTER_RE.test(character)) {
+      return within(character.codePointAt(0), RTL_BLOCKS) ? "rtl" : "ltr";
+    }
+  }
+  return void 0;
+}
+function characterDirectionOf(character) {
+  const point = character.codePointAt(0);
+  if (NUMBER_RE.test(character)) {
+    return within(point, RTL_DIGITS) ? "rtl" : "ltr";
+  }
+  if (LETTER_RE.test(character)) {
+    return within(point, RTL_BLOCKS) ? "rtl" : "ltr";
+  }
+  return void 0;
+}
+
+export { characterDirectionOf, localeDirectionOf, textDirectionOf };
+//# sourceMappingURL=chunk-YORQQXGO.js.map
+//# sourceMappingURL=chunk-YORQQXGO.js.map

package/dist/chunk-YORQQXGO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/i18n/direction.ts"],"names":[],"mappings":"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","file":"chunk-YORQQXGO.js","sourcesContent":["/**\n * The writing direction of authored content. A language tag is read from the\n * tag alone, so a server rendering and the browser that hydrates it agree on\n * it. Text is read by the runtime's Unicode tables, which agree on every\n * character both runtimes' Unicode versions know.\n */\n\n/** ISO 15924 codes of the scripts written right to left. */\nconst RTL_SCRIPT_CODES = new Set([\n  'phlv',\n  'adlm',\n  'arab',\n  'aran',\n  'armi',\n  'avst',\n  'chrs',\n  'cprt',\n  'elym',\n  'gara',\n  'hatr',\n  'hebr',\n  'hung',\n  'khar',\n  'lydi',\n  'mand',\n  'mani',\n  'mend',\n  'merc',\n  'mero',\n  'narb',\n  'nbat',\n  'nkoo',\n  'orkh',\n  'ougr',\n  'palm',\n  'phli',\n  'phlp',\n  'phnx',\n  'prti',\n  'rohg',\n  'samr',\n  'sarb',\n  'sidt',\n  'sogd',\n  'sogo',\n  'syrc',\n  'syre',\n  'syrj',\n  'syrn',\n  'thaa',\n  'yezi',\n]);\n\n/**\n * Languages written right to left in every script they are commonly written\n * in, including the deprecated tags `iw` and `ji` and the Arabic varieties\n * with tags of their own. A language also written left to right — Kurdish,\n * Sindhi, Uyghur — is not listed: its own text decides.\n */\nconst RTL_LANGUAGES = new Set([\n  'acm',\n  'aeb',\n  'aii',\n  'ajp',\n  'apc',\n  'ar',\n  'arc',\n  'ars',\n  'ary',\n  'arz',\n  'azb',\n  'bqi',\n  'ckb',\n  'dv',\n  'fa',\n  'glk',\n  'hbo',\n  'he',\n  'iw',\n  'ji',\n  'jrb',\n  'khw',\n  'lrc',\n  'mzn',\n  'nqo',\n  'ota',\n  'pnb',\n  'prs',\n  'ps',\n  'sdh',\n  'skr',\n  'syc',\n  'syr',\n  'ur',\n  'yi',\n]);\n\n/**\n * The code-point blocks Unicode reserves for right-to-left scripts (their\n * default bidirectional class is R or AL): Hebrew through Arabic Extended-A,\n * the Hebrew and Arabic presentation forms, the historic right-to-left scripts\n * of the Supplementary Multilingual Plane, and Mende Kikakui through the Arabic\n * mathematical letters. A letter in one of them is written right to left.\n */\nconst RTL_BLOCKS: readonly (readonly [number, number])[] = [\n  [0x0590, 0x08ff],\n  [0xfb1d, 0xfdff],\n  [0xfe70, 0xfeff],\n  [0x10800, 0x10fff],\n  [0x1e800, 0x1efff],\n];\n\n/** Digits whose bidirectional class is R: N'Ko, Mende Kikakui and Adlam. */\nconst RTL_DIGITS: readonly (readonly [number, number])[] = [\n  [0x07c0, 0x07c9],\n  [0x1e8c7, 0x1e8cf],\n  [0x1e950, 0x1e959],\n];\n\nconst LETTER_RE = /^\\p{L}$/u;\nconst NUMBER_RE = /^\\p{N}$/u;\n\nfunction within(point: number, ranges: readonly (readonly [number, number])[]): boolean {\n  return ranges.some(([first, last]) => point >= first && point <= last);\n}\n\n/**\n * The script subtag of a BCP 47 tag's lowercased subtags, if it names a\n * direction: not in a private-use or grandfathered tag (`x-arab`, `i-klingon`),\n * and not one of the codes for no particular script — Common, Inherited,\n * Unwritten, Unknown and the like (`Z` codes) or private use (`Qaaa`–`Qabx`).\n */\nfunction scriptSubtagOf(subtags: readonly string[]): string | undefined {\n  if ((subtags[0] as string).length === 1) {\n    return undefined;\n  }\n  let index = 1;\n  // Up to three extended language subtags may come between language and script.\n  while (index < subtags.length && index <= 3 && /^[a-z]{3}$/.test(subtags[index] as string)) {\n    index += 1;\n  }\n  const candidate = subtags[index];\n  if (candidate === undefined || !/^[a-z]{4}$/.test(candidate)) {\n    return undefined;\n  }\n  return /^z/.test(candidate) || (candidate >= 'qaaa' && candidate <= 'qabx')\n    ? undefined\n    : candidate;\n}\n\n/**\n * The direction a language tag names, or `undefined` when it names none: its\n * script subtag when it has one (`ku-Arab` is right-to-left, `ar-Latn` is not),\n * then the languages above. `-` and `_` both separate subtags. Anything that is\n * not a string names none.\n */\nexport function localeDirectionOf(locale: unknown): 'ltr' | 'rtl' | undefined {\n  if (typeof locale !== 'string') {\n    return undefined;\n  }\n  const subtags = locale.toLowerCase().split(/[-_]/);\n  const script = scriptSubtagOf(subtags);\n  if (script !== undefined) {\n    return RTL_SCRIPT_CODES.has(script) ? 'rtl' : 'ltr';\n  }\n  return RTL_LANGUAGES.has(subtags[0] as string) ? 'rtl' : undefined;\n}\n\nconst LEFT_TO_RIGHT_MARK = String.fromCodePoint(0x200e);\n/** RIGHT-TO-LEFT MARK and ARABIC LETTER MARK. */\nconst RIGHT_TO_LEFT_MARKS = new Set([String.fromCodePoint(0x200f), String.fromCodePoint(0x61c)]);\n\n/**\n * The direction of `text`'s first letter or directional mark — an author can\n * start a transcript with a right-to-left mark to lay it out right to left — or\n * `undefined` when it has neither. Other characters with a strong direction,\n * such as a Hebrew punctuation mark or an N'Ko digit, are not read, so this is\n * the first strong character the Unicode bidirectional algorithm finds only\n * where the text starts with a letter or a mark. Letters are read by the\n * runtime's Unicode tables: a letter added in a later Unicode version than a\n * server's is not one to that server.\n */\nexport function textDirectionOf(text: string): 'ltr' | 'rtl' | undefined {\n  for (const character of text) {\n    if (character === LEFT_TO_RIGHT_MARK) {\n      return 'ltr';\n    }\n    if (RIGHT_TO_LEFT_MARKS.has(character)) {\n      return 'rtl';\n    }\n    if (LETTER_RE.test(character)) {\n      return within(character.codePointAt(0) as number, RTL_BLOCKS) ? 'rtl' : 'ltr';\n    }\n  }\n  return undefined;\n}\n\n/**\n * The direction a single character is laid out in, for a mark standing in for\n * it: a digit runs left to right unless it is one of the right-to-left digits,\n * a letter runs in its script's direction, and anything else has none of its\n * own.\n */\nexport function characterDirectionOf(character: string): 'ltr' | 'rtl' | undefined {\n  const point = character.codePointAt(0) as number;\n  if (NUMBER_RE.test(character)) {\n    return within(point, RTL_DIGITS) ? 'rtl' : 'ltr';\n  }\n  if (LETTER_RE.test(character)) {\n    return within(point, RTL_BLOCKS) ? 'rtl' : 'ltr';\n  }\n  return undefined;\n}\n"]}

package/dist/components/ActivityPreview.cjs

@@ -1,22 +1,27 @@
 'use client';
 'use strict';
 
-var chunkNVUFEMPZ_cjs = require('../chunk-NVUFEMPZ.cjs');
-require('../chunk-K7NMNOPI.cjs');
-require('../chunk-Z63JRG4M.cjs');
-require('../chunk-2GXSA322.cjs');
-require('../chunk-J73TDY7J.cjs');
-require('../chunk-UU2NV6SU.cjs');
-require('../chunk-K3EA547J.cjs');
-require('../chunk-SBIJJ374.cjs');
+var chunkBVRUUYYR_cjs = require('../chunk-BVRUUYYR.cjs');
+require('../chunk-YEYKJFEC.cjs');
+require('../chunk-NDQD3ZRY.cjs');
+require('../chunk-SE6WWDVW.cjs');
+require('../chunk-U3APKQ7P.cjs');
+require('../chunk-WTS34S5E.cjs');
+require('../chunk-36FTYJWJ.cjs');
+require('../chunk-F4TBCRGI.cjs');
+require('../chunk-UDCQTOVU.cjs');
+require('../chunk-OD65OZIW.cjs');
+require('../chunk-BRPEB43C.cjs');
+require('../chunk-USBANZ7K.cjs');
+require('../chunk-B2XQLU2E.cjs');
 require('../chunk-XOR4MPEN.cjs');
-require('../chunk-MA7GXUWC.cjs');
+require('../chunk-LB3FEV7Z.cjs');
 
 
 
 Object.defineProperty(exports, "ActivityPreview", {
   enumerable: true,
-  get: function () { return chunkNVUFEMPZ_cjs.ActivityPreview; }
+  get: function () { return chunkBVRUUYYR_cjs.ActivityPreview; }
 });
 //# sourceMappingURL=ActivityPreview.cjs.map
 //# sourceMappingURL=ActivityPreview.cjs.map

package/dist/components/ActivityPreview.d.cts

@@ -1,9 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { LearnerResponse, ItemOutcome, DraftNotComplete, ThemeTokens } from '@intellectif/lk-core';
 import { ReactNode } from 'react';
-import { R as RenderMode, H as HtmlSanitizer, a as LkStringsOverride } from '../strings-DPTyLpHt.cjs';
+import { e as RenderMode, H as HtmlSanitizer, a as LkStringsOverride } from '../strings--ADnHcaA.cjs';
 import { ActivityRenderer } from './ActivitySequence.cjs';
-import '../WrittenResponse-DWtS4tOL.cjs';
+import '../machine-CuwKqWXC.cjs';
+import '../WrittenResponse-pB1ik8hg.cjs';
 
 interface ActivityPreviewProps {
     /**
@@ -35,7 +36,12 @@ interface ActivityPreviewProps {
      * `previewIncomplete` or `previewInvalid` string.
      */
     fallback?: (result: DraftNotComplete) => ReactNode;
-    /** Renderers for activity types beyond the built-ins, keyed by `type`, as on `<ActivitySequence>`. */
+    /**
+     * Renderers for activity types beyond the built-ins, keyed by `type`, as on
+     * `<ActivitySequence>`. An entry receives the shared prop contract and
+     * nothing else, so — like the shuffle seed below — the in-memory recording
+     * binding a previewed read-aloud is given does not reach one.
+     */
     renderers?: Readonly<Record<string, ActivityRenderer>>;
     /**
      * Seeds `<MultipleChoice>`'s option shuffle. Defaults to a fixed seed, so the

package/dist/components/ActivityPreview.d.ts

@@ -1,9 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { LearnerResponse, ItemOutcome, DraftNotComplete, ThemeTokens } from '@intellectif/lk-core';
 import { ReactNode } from 'react';
-import { R as RenderMode, H as HtmlSanitizer, a as LkStringsOverride } from '../strings-DPTyLpHt.js';
+import { e as RenderMode, H as HtmlSanitizer, a as LkStringsOverride } from '../strings-CtdSf2St.js';
 import { ActivityRenderer } from './ActivitySequence.js';
-import '../WrittenResponse-B5p_-RnJ.js';
+import '../machine-CuwKqWXC.js';
+import '../WrittenResponse-C0P34En1.js';
 
 interface ActivityPreviewProps {
     /**
@@ -35,7 +36,12 @@ interface ActivityPreviewProps {
      * `previewIncomplete` or `previewInvalid` string.
      */
     fallback?: (result: DraftNotComplete) => ReactNode;
-    /** Renderers for activity types beyond the built-ins, keyed by `type`, as on `<ActivitySequence>`. */
+    /**
+     * Renderers for activity types beyond the built-ins, keyed by `type`, as on
+     * `<ActivitySequence>`. An entry receives the shared prop contract and
+     * nothing else, so — like the shuffle seed below — the in-memory recording
+     * binding a previewed read-aloud is given does not reach one.
+     */
     renderers?: Readonly<Record<string, ActivityRenderer>>;
     /**
      * Seeds `<MultipleChoice>`'s option shuffle. Defaults to a fixed seed, so the

package/dist/components/ActivityPreview.js

@@ -1,13 +1,18 @@
 'use client';
-export { ActivityPreview } from '../chunk-PY53ABWC.js';
-import '../chunk-5N7OLFHB.js';
-import '../chunk-XAGWBVK3.js';
-import '../chunk-W4MXRZAB.js';
-import '../chunk-PSHNTDKG.js';
-import '../chunk-YZWXVZB3.js';
-import '../chunk-DQERNAWI.js';
-import '../chunk-R7DI5UMU.js';
+export { ActivityPreview } from '../chunk-YMBBM5K7.js';
+import '../chunk-LLXCX5KK.js';
+import '../chunk-LGCUOLP6.js';
+import '../chunk-72UGRIMM.js';
+import '../chunk-XUEIUEPI.js';
+import '../chunk-47HHC4GD.js';
+import '../chunk-D57QZILZ.js';
+import '../chunk-62AKSD5Y.js';
+import '../chunk-MCO52PV5.js';
+import '../chunk-YORQQXGO.js';
+import '../chunk-RCMYEWBE.js';
+import '../chunk-BO6P723E.js';
+import '../chunk-XIBOFTOL.js';
 import '../chunk-6N43WDVG.js';
-import '../chunk-3Q4I4KT6.js';
+import '../chunk-TDJEKXEP.js';
 //# sourceMappingURL=ActivityPreview.js.map
 //# sourceMappingURL=ActivityPreview.js.map

package/dist/components/ActivitySequence.cjs

@@ -1,23 +1,28 @@
 'use client';
 'use strict';
 
-var chunkHT4FFZZQ_cjs = require('../chunk-HT4FFZZQ.cjs');
-require('../chunk-74QXBWCI.cjs');
-require('../chunk-K7NMNOPI.cjs');
-require('../chunk-Z63JRG4M.cjs');
-require('../chunk-2GXSA322.cjs');
-require('../chunk-J73TDY7J.cjs');
-require('../chunk-UU2NV6SU.cjs');
-require('../chunk-K3EA547J.cjs');
-require('../chunk-SBIJJ374.cjs');
+var chunkJ2CDPIRC_cjs = require('../chunk-J2CDPIRC.cjs');
+require('../chunk-RRH7ZPXC.cjs');
+require('../chunk-YEYKJFEC.cjs');
+require('../chunk-NDQD3ZRY.cjs');
+require('../chunk-SE6WWDVW.cjs');
+require('../chunk-U3APKQ7P.cjs');
+require('../chunk-WTS34S5E.cjs');
+require('../chunk-36FTYJWJ.cjs');
+require('../chunk-F4TBCRGI.cjs');
+require('../chunk-UDCQTOVU.cjs');
+require('../chunk-OD65OZIW.cjs');
+require('../chunk-BRPEB43C.cjs');
+require('../chunk-USBANZ7K.cjs');
+require('../chunk-B2XQLU2E.cjs');
 require('../chunk-XOR4MPEN.cjs');
-require('../chunk-MA7GXUWC.cjs');
+require('../chunk-LB3FEV7Z.cjs');
 
 
 
 Object.defineProperty(exports, "ActivitySequence", {
   enumerable: true,
-  get: function () { return chunkHT4FFZZQ_cjs.ActivitySequence; }
+  get: function () { return chunkJ2CDPIRC_cjs.ActivitySequence; }
 });
 //# sourceMappingURL=ActivitySequence.cjs.map
 //# sourceMappingURL=ActivitySequence.cjs.map

package/dist/components/ActivitySequence.d.cts

@@ -1,13 +1,29 @@
-import { SequenceEntry, ActivityResult, LearnerResponse, InteractionEvent, ItemOutcome, ThemeTokens } from '@intellectif/lk-core';
+import { SequenceEntry, ActivityResult, LearnerResponse, InteractionEvent, SpeechAssessment, ItemOutcome, ThemeTokens } from '@intellectif/lk-core';
 import { ComponentType } from 'react';
-import { A as ActivityProps, d as RenderableActivity, R as RenderMode, S as SequenceMediaBudget, a as LkStringsOverride, H as HtmlSanitizer } from '../strings-DPTyLpHt.cjs';
-import { a as WrittenResponseSubmission } from '../WrittenResponse-DWtS4tOL.cjs';
+import { A as ActivityProps, g as RenderableActivity, e as RenderMode, S as SequenceMediaBudget, h as SequenceRecordingBinding, a as LkStringsOverride, H as HtmlSanitizer } from '../strings--ADnHcaA.cjs';
+import { a as WrittenResponseSubmission } from '../WrittenResponse-pB1ik8hg.cjs';
+import '../machine-CuwKqWXC.cjs';
 
 /**
  * What one finished slot in a sequence produced. Two kinds, because two kinds
  * of activity exist: those the SDK scores at submit time, and those a grader
  * scores later. Collapsing them would mean inventing a score for ungraded
  * work — the exact defect the deferred outcome exists to prevent.
+ *
+ * **A read-aloud hand-in adds no arm here, deliberately.** The obvious home for
+ * a handed-in take is `submitted`, and it is the wrong one: that arm's payload
+ * is typed `WrittenResponseSubmission`, this union is published from both the
+ * barrel and the `components/ActivitySequence` subpath, and a consumer narrows
+ * on `kind === 'submitted'` and reads `.text`. Widening the payload to a union
+ * would break every one of those reads — a breaking change to a published
+ * discriminated union, bought for a type that `responded` already describes: a
+ * read-aloud hand-in IS a raw `LearnerResponse` with no grade, which is exactly
+ * what `responded` carries.
+ *
+ * What a read-aloud does add is `unsubmitted`, for the one thing no existing
+ * arm can say honestly: a take that never reached storage. Any response would
+ * be a lie about it — a `recording` of `null` is the blank a learner chooses,
+ * and grades as 0.
  */
 type SequenceItemOutcome = {
     kind: 'scored';
@@ -17,6 +33,14 @@ type SequenceItemOutcome = {
     slotId: string;
     activityId: string;
     result: ActivityResult;
+    /**
+     * The answer this score grades, for a slot whose grade arrives after its
+     * answer was handed in and whose learner may hand in another: a
+     * `practice` read-aloud, whose `response.recording` names the take the
+     * score belongs to. Absent for every other slot, whose score and answer
+     * arrive together.
+     */
+    response?: LearnerResponse;
 } | {
     kind: 'submitted';
     index: number;
@@ -44,8 +68,28 @@ type SequenceItemOutcome = {
      * The raw answer, with no grade of any kind. This is what an `exam` slot
      * produces: the client is forbidden to score, so a response is all there
      * is until the server grades it.
+     *
+     * A read-aloud `recording` of `null` here is always a blank the learner
+     * chose to hand in, never a take that failed to upload — that is
+     * `unsubmitted`.
      */
     response: LearnerResponse;
+} | {
+    /**
+     * A question the learner tried to answer and could not hand in, and then
+     * left: a `practice` read-aloud whose take never reached your storage. It
+     * carries no response, because there is none.
+     *
+     * Deliberately not `responded` with a `recording` of `null`: that is the
+     * blank a learner chooses, and a grader marks it 0 with every word
+     * omitted — which would turn a storage outage into a zero. Grade nothing
+     * for this slot; the learner can still return to it, and a take stored
+     * then reaches you through `onSubmit`.
+     */
+    kind: 'unsubmitted';
+    index: number;
+    slotId: string;
+    activityId: string;
 };
 /**
  * A component that can render one activity inside a sequence. Register one per
@@ -69,6 +113,13 @@ interface ActivitySequenceProps {
      * Renderers for activity types beyond the built-ins, keyed by `data.type`.
      * A key matching a built-in overrides it, so a consumer can replace the
      * bundled renderer without forking the sequencer.
+     *
+     * A registered renderer is an `ActivityRenderer`, which is
+     * `ComponentType<ActivityProps>` — so it receives the shared prop contract
+     * and nothing beyond it. `shuffleSeed`, `recordingBinding` and `assessment`
+     * are all outside that contract and none of them reaches an override: a
+     * replacement for `read-aloud` has to be given its own binding by whoever
+     * wrote it.
      */
     renderers?: Readonly<Record<string, ActivityRenderer>>;
     /**
@@ -105,12 +156,44 @@ interface ActivitySequenceProps {
      * use `onFinished` for mixed sets — it is the general completion signal and
      * reports both kinds of outcome. It also carries `slotId` per item, which
      * this callback's bare array cannot.
+     *
+     * It fires straight after `onFinished`, with the same results, or never: a
+     * set `onFinished` reported with an ungraded slot is not reported here later,
+     * when a re-recorded take is graded.
      */
     onComplete?: (results: ActivityResult[]) => void;
     /**
      * Called once every activity has been completed, whether it was scored at
      * submit time or submitted for later grading. Use this for any set that
      * mixes graded and deferred-graded activities.
+     *
+     * **Once per set**, and that matters for a `practice` read-aloud, whose grade
+     * arrives after the submit that completed the slot. When the last slot is
+     * filled while a read-aloud's take is still being stored or assessed, this
+     * waits for it and reports the set then — with the grade in place, or with
+     * the slot's raw `responded` outcome when the take came back with no grade.
+     * A take that never settles is a question still being answered, so the set
+     * is not reported while it runs.
+     *
+     * **A failure the learner can still retry is in flight too.** While a take
+     * that failed to upload, or whose assessment failed, is offered "Try again"
+     * on the question the learner is looking at, the set is not reported: the
+     * retry may yet store and grade it. It completes once the learner moves to
+     * another question — as the last take the slot stored, or as `unsubmitted`
+     * when it never stored one, which is never a blank.
+     *
+     * **A score and a response always describe the same take.** A read-aloud
+     * recorded again replaces the earlier take's grade with the new take's
+     * `responded`, and a result that arrives for a take the learner has since
+     * replaced, or for a paper no longer on screen, is not recorded at all.
+     *
+     * `onComplete` fires in the same report or not at all, so the two never
+     * describe one set differently. What arrives after the set was reported is
+     * not reported here again, because a consumer who persists on this callback
+     * must not write one attempt twice: a later take reaches you through
+     * `onSubmit`, and its grade through `onActivityComplete`, the per-item persist
+     * hook keyed by `slotId` — which only ever grades the answer `onSubmit` last
+     * reported for that slot.
      */
     onFinished?: (items: SequenceItemOutcome[]) => void;
     /** Forwarded to each activity. */
@@ -127,6 +210,27 @@ interface ActivitySequenceProps {
      * {@link SequenceMediaBudget}.
      */
     mediaBudget?: SequenceMediaBudget;
+    /**
+     * Where every read-aloud take in this sequence is stored, and how a
+     * judgement comes back. Required by any `read-aloud` slot outside `review`:
+     * the component refuses to render a recorder whose take is stored nowhere.
+     *
+     * Named `recordingBinding` rather than `recording` because both
+     * `ReadAloudData.recording` (the bounds an item declares) and
+     * `ReadAloudLearnerResponse.recording` (the take a learner handed in) already
+     * exist — the plain name would read as one of those. Same name at both
+     * levels, different types, as `mediaBudget` has.
+     */
+    recordingBinding?: SequenceRecordingBinding;
+    /**
+     * Speech assessments keyed by `slotId`, forwarded to the matching read-aloud
+     * slot so `review` can show the per-word marks behind a stored grade.
+     *
+     * Read LIVE, like `outcomes` and unlike `responses`: an assessment is fetched
+     * beside the attempt it explains and lands after the first paint, and a
+     * mount-only read would show the grade with no marks under it for ever.
+     */
+    assessments?: Readonly<Record<string, SpeechAssessment>>;
     /** Overrides the SDK's chrome text for this sequence. See {@link LkIntlProvider}. */
     strings?: LkStringsOverride;
     /**
@@ -213,6 +317,6 @@ interface ActivitySequenceProps {
     locale?: string;
     disabled?: boolean;
 }
-declare function ActivitySequence({ activities, renderers, onActivityComplete, onComplete, onFinished, onSubmit, onInteraction, renderMode, shuffle, shuffleSeed, defaultIndex, onIndexChange, responses, submittedSlotIds, outcomes, sanitizeHtml, theme, locale, disabled, mediaBudget, strings, }: ActivitySequenceProps): React.JSX.Element;
+declare function ActivitySequence({ activities, renderers, onActivityComplete, onComplete, onFinished, onSubmit, onInteraction, renderMode, shuffle, shuffleSeed, defaultIndex, onIndexChange, responses, submittedSlotIds, outcomes, sanitizeHtml, theme, locale, disabled, mediaBudget, recordingBinding, assessments, strings, }: ActivitySequenceProps): React.JSX.Element;
 
 export { type ActivityRenderer, ActivitySequence, type ActivitySequenceProps, type SequenceItemOutcome };