@intellectif/lk-react 12.0.0 → 13.0.0

package/dist/chunk-MA7GXUWC.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/i18n/strings.ts","../src/i18n/LkIntlProvider.tsx"],"names":["createContext","useMemo","jsx","useContext"],"mappings":"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","file":"chunk-MA7GXUWC.cjs","sourcesContent":["import type { Stimulus } from '@intellectif/lk-core';\nimport type { MediaTransportStrings } from '../components/types.js';\n\n/**\n * Every string the SDK's own chrome renders.\n *\n * Until 0.8.1 these were literals, and `locale` set only the `lang` attribute —\n * so a learner sitting a Spanish paper read a Spanish passage inside an English\n * scaffold, and \"No plays remaining\" on a listening exam was untranslatable.\n * This is the whole surface, in one place, so a consumer can replace it.\n *\n * **Interpolation and plurals are functions, not format strings.** A message\n * like `\"Question {n} of {total}\"` needs a parser, and a parser needs plural\n * rules for every locale the SDK does not know. A function hands both problems\n * to the consumer, who has `Intl.PluralRules` and knows their own language:\n *\n * ```ts\n * questionProgress: (index, total) => `Pregunta ${index} de ${total}`,\n * wordCount: (n) => `${n} ${n === 1 ? 'palabra' : 'palabras'}`,\n * ```\n *\n * It also lets a translation reorder its arguments, which a positional token\n * cannot, and TypeScript checks the arity. No parser, no message catalogue\n * format, no runtime dependency.\n *\n * **What is deliberately NOT here: thrown errors.** Every `throw` in this\n * package is addressed to the developer who wired the component up, not to the\n * learner. Translating them would make them unsearchable and would put the one\n * audience who can act on them behind a translation. They stay English.\n */\nexport interface LkStrings {\n  // ── Submission ─────────────────────────────────────────────────────────\n  /** Multiple Choice submit button, and Written Response. */\n  submit: string;\n  /** Fill-in-the-Blanks in `practice`: the learner is checking their own work. */\n  checkAnswers: string;\n  /** Fill-in-the-Blanks in `exam`: nothing is checked on the client. */\n  submitAnswers: string;\n\n  // ── Outcome, announced after submit ────────────────────────────────────\n  /**\n   * The scored result, read by a screen reader on submit.\n   *\n   * `percent` is already rounded to a whole number. The authored overall\n   * feedback is appended SEPARATELY by the component, so a translation of this\n   * sentence never has to carry the author's words — the two were previously\n   * concatenated into one literal, which made the score sentence untranslatable\n   * without also touching authored content.\n   */\n  scoreAnnouncement: (percent: number, passed: boolean) => string;\n  /** Prefix announced on submit, before the score sentence. */\n  answerSubmitted: string;\n  /** An answer submitted for grading that has none yet. Never rendered as 0%. */\n  notGradedYet: string;\n  /** An outcome that carries no grade and never will. */\n  noGradeAvailable: string;\n\n  // ── Feedback disclosure ────────────────────────────────────────────────\n  showFeedback: string;\n  hideFeedback: string;\n\n  // ── Fill-in-the-Blanks ─────────────────────────────────────────────────\n  /** Accessible name of a blank's input. `ordinal` is 1-based. */\n  blankLabel: (ordinal: number) => string;\n\n  // ── Gap select ────────────────────────────────────────────────────────────\n  /** Accessible name of the selector for one gap in a Gap Select passage. */\n  gapLabel: (ordinal: number) => string;\n  /**\n   * The empty first entry of a gap's selector — how a learner leaves a gap\n   * alone, and how they take an answer back. Never a real choice.\n   */\n  gapPlaceholder: string;\n  showHint: string;\n  hideHint: string;\n\n  // ── Written Response ───────────────────────────────────────────────────\n  /**\n   * Announced when an essay is handed in. Distinct from {@link LkStrings.awaitingGrade},\n   * which is the `review`-mode state of a submission made earlier: this one\n   * confirms the act, and is the only thing a learner hears at the moment they\n   * commit work that nothing on the client will grade.\n   */\n  responseSubmitted: string;\n  /** Live word counter. Needs the count for languages whose plural rules differ. */\n  wordCount: (count: number) => string;\n  /** The authored bounds, e.g. \"50–200 words\". `min` is 0 when unbounded below. */\n  wordBounds: (min: number, max: number) => string;\n  /** A rubric criterion the grader marked not applicable. */\n  notApplicable: string;\n  /** A returned grade flagged for a human to look at — learner-visible by design. */\n  awaitingHumanReview: string;\n  /** Submitted, no grade back yet. */\n  awaitingGrade: string;\n  /** The grader could not produce a grade. */\n  couldNotBeGraded: string;\n\n  // ── Sequence pager ─────────────────────────────────────────────────────\n  previous: string;\n  next: string;\n  /** Progress label, also the question region's accessible name. `index` is 1-based. */\n  questionProgress: (index: number, total: number) => string;\n  /** Shown when no renderer is registered for an activity type. */\n  unsupportedActivity: string;\n\n  // ── Dictation ──────────────────────────────────────────────────────────\n  /** Accessible name of the box the learner types the recording into. */\n  dictationInputLabel: string;\n  /** Accessible name of the group holding the recording. */\n  dictationRecording: string;\n  /** Accessible name of the group holding the slower recording, and its default `alt`. */\n  dictationSlowRecording: string;\n  /** The progressive-hint button, with how many transcript words are shown so far. */\n  dictationRevealNextWord: (revealed: number, total: number) => string;\n  /** Hides every revealed hint word again. */\n  dictationResetHints: string;\n  /** The solution toggle: shows the transcript after the attempt is marked. */\n  showSolution: string;\n  hideSolution: string;\n  /** Accessible name of the revealed transcript. */\n  dictationSolutionLabel: string;\n  /** Accessible name of the word-by-word marked result. */\n  dictationMarksLabel: string;\n  /** Tells the learner the marks compare the normalised text, not what they typed. */\n  dictationDiffNote: string;\n  /**\n   * The four sentences a screen reader hears for a marked word — the only\n   * channel the marks have for assistive technology; the glyphs and the\n   * character diff are decoration.\n   */\n  dictationWordCorrect: (word: string) => string;\n  dictationWordWrong: (word: string, expected: string) => string;\n  dictationWordMissing: (expected: string) => string;\n  dictationWordExtra: (word: string) => string;\n  /** The legend rows; the character-level marks reuse the same four. */\n  dictationLegendCorrect: string;\n  dictationLegendWrong: string;\n  dictationLegendMissing: string;\n  dictationLegendExtra: string;\n  /** Marked result of an attempt with no words in it once punctuation and spacing are ignored, an empty one included. */\n  dictationNothingTyped: string;\n  /**\n   * Appended to the score announcement, e.g. \"4 of 6 words correct.\" — a whole\n   * sentence, because authored feedback may follow it.\n   */\n  dictationWordsSummary: (correct: number, total: number) => string;\n\n  // ── Authoring preview ──────────────────────────────────────────────────\n  /**\n   * `<ActivityPreview>`, in place of a draft that still has something missing.\n   * Author-facing, not learner-facing — but an editor is translated too.\n   */\n  previewIncomplete: string;\n  /** `<ActivityPreview>`, in place of a draft with something wrong in it. */\n  previewInvalid: string;\n\n  // ── Embedded media ────────────────────────────────────────────────────────\n  /**\n   * Accessible name of a provider iframe whose author supplied no `alt`.\n   * `MediaSchema` requires `alt` on an embed, so validated content never\n   * reaches this — but `validateActivity` is opt-in, and a screen-reader\n   * learner meeting an unvalidated one should not meet it in English.\n   */\n  embeddedMedia: string;\n\n  // ── Shared stimulus ────────────────────────────────────────────────────\n  /**\n   * Accessible name of the stimulus region when the author gave it no title.\n   * Keyed by `Stimulus['kind']`, because \"Recording\" and \"Passage\" do not share\n   * a gender or an article in every language.\n   */\n  stimulusKind: Record<Stimulus['kind'], string>;\n  /**\n   * How far the material carries, e.g. \"Questions 3–8\". Called with equal\n   * `first` and `last` for a single question, so a translation can choose its\n   * own singular rather than receive a pre-pluralised English one.\n   */\n  stimulusRange: (first: number, last: number) => string;\n\n  // ── Error boundary ─────────────────────────────────────────────────────\n  /** Production fallback when an activity throws during render. */\n  activityFailed: string;\n  /** The same, when the activity's title is known. */\n  activityFailedNamed: (title: string) => string;\n  /** Production fallback when the activity has no title to name. */\n  activityFailedUnnamed: string;\n\n  // ── Audio transport ────────────────────────────────────────────────────\n  /**\n   * The listening-paper transport. Shipped in 0.8.0 as its own `mediaStrings`\n   * prop, which still works — this is the same shape, reachable from the one\n   * provider so a consumer does not wire two mechanisms.\n   */\n  media: MediaTransportStrings;\n}\n\n/** A partial override, nested one level for {@link LkStrings.media}. */\nexport type LkStringsOverride = Partial<Omit<LkStrings, 'media' | 'stimulusKind'>> & {\n  media?: Partial<MediaTransportStrings>;\n  stimulusKind?: Partial<Record<Stimulus['kind'], string>>;\n};\n\n/**\n * English defaults, byte-identical to what every component rendered before the\n * strings surface existed. Supplying no override changes nothing on screen.\n */\nexport const DEFAULT_STRINGS: LkStrings = {\n  submit: 'Submit',\n  checkAnswers: 'Check answers',\n  submitAnswers: 'Submit answers',\n\n  scoreAnnouncement: (percent, passed) =>\n    `Score ${percent}%. ${passed ? 'Passed.' : 'Not passed.'}`,\n  answerSubmitted: 'Answer submitted.',\n  notGradedYet: 'Not graded yet.',\n  noGradeAvailable: 'No grade available.',\n\n  showFeedback: 'Show feedback',\n  hideFeedback: 'Hide feedback',\n\n  blankLabel: (ordinal) => `Fill in blank ${ordinal}`,\n\n  gapLabel: (ordinal) => `Choose the answer for gap ${ordinal}`,\n  gapPlaceholder: 'Choose…',\n  showHint: 'Show hint',\n  hideHint: 'Hide hint',\n\n  responseSubmitted:\n    'Response submitted. It will be graded and your result will appear here later.',\n  wordCount: (count) => `${count} ${count === 1 ? 'word' : 'words'}`,\n  wordBounds: (min, max) => (min > 0 ? `${min}–${max} words` : `up to ${max} words`),\n  notApplicable: 'Not applicable',\n  awaitingHumanReview: 'This grade is awaiting review by a teacher.',\n  awaitingGrade: 'Not graded yet. This response is waiting for its grade.',\n  couldNotBeGraded: 'This response could not be graded.',\n\n  previous: 'Previous',\n  next: 'Next',\n  questionProgress: (index, total) => `Question ${index} of ${total}`,\n  unsupportedActivity: 'This activity type has no renderer. Supply one through the renderers prop.',\n\n  dictationInputLabel: 'Type what you hear',\n  dictationRecording: 'Recording',\n  dictationSlowRecording: 'Slow recording',\n  dictationRevealNextWord: (revealed, total) =>\n    `Reveal the next word (${revealed} of ${total} shown)`,\n  dictationResetHints: 'Reset hints',\n  showSolution: 'Show solution',\n  hideSolution: 'Hide solution',\n  dictationSolutionLabel: 'Solution',\n  dictationMarksLabel: 'Your answer, word by word',\n  dictationDiffNote: 'Compared after ignoring case, punctuation and extra spaces.',\n  dictationWordCorrect: (word) => `“${word}” is correct`,\n  dictationWordWrong: (word, expected) => `“${word}” should be “${expected}”`,\n  dictationWordMissing: (expected) => `“${expected}” is missing`,\n  dictationWordExtra: (word) => `“${word}” is extra`,\n  dictationLegendCorrect: 'Correct',\n  dictationLegendWrong: 'Wrong',\n  dictationLegendMissing: 'Missing',\n  dictationLegendExtra: 'Extra',\n  dictationNothingTyped: 'Nothing to compare: no words were entered.',\n  dictationWordsSummary: (correct, total) =>\n    `${correct} of ${total} ${total === 1 ? 'word' : 'words'} correct.`,\n\n  previewIncomplete: 'This activity is not finished yet, so it cannot be previewed.',\n  previewInvalid: 'This activity has a problem to fix before it can be previewed.',\n\n  embeddedMedia: 'Embedded media',\n\n  stimulusKind: {\n    text: 'Passage',\n    audio: 'Recording',\n    video: 'Video',\n    image: 'Image',\n    mixed: 'Material',\n  },\n  stimulusRange: (first, last) =>\n    first === last ? `Question ${first}` : `Questions ${first}–${last}`,\n\n  activityFailed: 'Activity failed to render',\n  activityFailedNamed: (title) => `\"${title}\" could not be displayed.`,\n  activityFailedUnnamed: 'This activity could not be displayed.',\n\n  media: {\n    play: 'Play',\n    pause: 'Pause',\n    preparing: 'Preparing…',\n    mute: 'Mute',\n    unmute: 'Unmute',\n    volume: 'Volume',\n    speed: 'Playback speed',\n    seek: 'Seek',\n    timeValue: (elapsed, duration) => `${elapsed} of ${duration}`,\n    playsRemaining: (remaining, max) =>\n      `${remaining} of ${max} play${max === 1 ? '' : 's'} remaining`,\n    noPlaysRemaining: 'No plays remaining',\n    lastPlayConfirm: 'This is your last play. Start it now?',\n    lastPlayStart: 'Start last play',\n    lastPlayCancel: 'Not yet',\n    seekBlocked: 'Rewinding is not available for this recording.',\n    rateBlocked: 'Playback speed is fixed for this recording.',\n    playFailed: 'The recording could not be started. Try again.',\n  },\n};\n\n/**\n * Layers an override onto a base dictionary.\n *\n * Two levels deep and no further, because the shape is two levels deep. A\n * generic deep merge would silently accept a nested object where a function\n * belongs and fail at render instead of at the call site.\n */\nexport function mergeStrings(base: LkStrings, override?: LkStringsOverride): LkStrings {\n  if (override === undefined) {\n    return base;\n  }\n  const { media, stimulusKind, ...flat } = override;\n  return {\n    ...base,\n    ...flat,\n    stimulusKind: { ...base.stimulusKind, ...stimulusKind },\n    media: { ...base.media, ...media },\n  };\n}\n","'use client';\n\nimport { createContext, useContext, useMemo } from 'react';\nimport type { LkStrings, LkStringsOverride } from './strings.js';\nimport { DEFAULT_STRINGS, mergeStrings } from './strings.js';\n\nexport type { LkStrings, LkStringsOverride } from './strings.js';\nexport { DEFAULT_STRINGS, mergeStrings } from './strings.js';\n\n/** Writing direction of the surrounding UI. `auto` defers to the locale. */\nexport type LkDirection = 'ltr' | 'rtl' | 'auto';\n\ninterface LkIntlValue {\n  strings: LkStrings;\n  locale: string | undefined;\n  direction: 'ltr' | 'rtl';\n}\n\nconst LkIntlContext = createContext<LkIntlValue | null>(null);\n\n/**\n * Locales written right-to-left, by language subtag.\n *\n * A short list rather than a dependency: these are the RTL scripts in living\n * use, and the set has not changed in decades. `Intl.Locale.textInfo` would be\n * better but is not available everywhere this package runs, and an explicit\n * `direction` prop overrides this in either direction anyway.\n */\nconst RTL_LANGUAGES = new Set(['ar', 'arc', 'dv', 'fa', 'he', 'ku', 'ps', 'sd', 'ug', 'ur', 'yi']);\n\n/** Resolves a BCP 47 tag to a writing direction. */\nexport function directionForLocale(locale: string | undefined): 'ltr' | 'rtl' {\n  if (locale === undefined) {\n    return 'ltr';\n  }\n  const language = locale.split('-')[0]?.toLowerCase() ?? '';\n  return RTL_LANGUAGES.has(language) ? 'rtl' : 'ltr';\n}\n\nexport interface LkIntlProviderProps {\n  /**\n   * Replaces the SDK's own chrome text. Anything omitted keeps its English\n   * default, so a partial translation degrades to mixed rather than to blank.\n   *\n   * A nested provider REPLACES the one above it rather than layering onto it —\n   * as a nested `ThemeProvider` restarts from `defaultTheme`. To layer, use a\n   * component's own `strings` prop, or compose with `mergeStrings`.\n   */\n  strings?: LkStringsOverride;\n  /**\n   * BCP 47 tag for the SDK's chrome — NOT for the authored content, which\n   * carries its own `locale`. Sets `lang` on the wrapper so a screen reader\n   * reads \"Question 3 of 10\" in the interface language rather than in the\n   * language of the passage beside it (WCAG 3.1.2).\n   */\n  locale?: string;\n  /**\n   * Writing direction. Defaults to `auto`, which derives it from `locale`.\n   * Set it explicitly when the surrounding application already manages `dir`\n   * and you do not want a second element declaring one.\n   */\n  direction?: LkDirection;\n  children: React.ReactNode;\n}\n\n/**\n * Supplies the SDK's chrome text and writing direction to everything beneath.\n *\n * Mirrors `ThemeProvider`: a provider for the whole tree, and a per-component\n * prop for the exceptions. The component prop wins, so a single activity can\n * be relabelled without a second provider.\n *\n * ```tsx\n * <LkIntlProvider locale=\"es\" strings={{\n *   submit: 'Enviar',\n *   checkAnswers: 'Comprobar respuestas',\n *   questionProgress: (i, total) => `Pregunta ${i} de ${total}`,\n *   wordCount: (n) => `${n} ${n === 1 ? 'palabra' : 'palabras'}`,\n *   media: { noPlaysRemaining: 'No quedan reproducciones' },\n * }}>\n *   <ActivitySequence … />\n * </LkIntlProvider>\n * ```\n *\n * The SDK ships **English only**. Bundling Spanish, Portuguese or Arabic would\n * mean shipping translations nobody in this repo can review, and a wrong\n * \"No plays remaining\" on a listening exam is worse than an English one that a\n * teacher can see is untranslated. The mechanism is the deliverable; the words\n * belong to whoever speaks the language.\n */\nexport function LkIntlProvider({\n  strings,\n  locale,\n  direction = 'auto',\n  children,\n}: LkIntlProviderProps): React.JSX.Element {\n  const value = useMemo<LkIntlValue>(\n    () => ({\n      strings: mergeStrings(DEFAULT_STRINGS, strings),\n      locale,\n      direction: direction === 'auto' ? directionForLocale(locale) : direction,\n    }),\n    [strings, locale, direction],\n  );\n\n  // Declare `dir` only when something actually told us the direction. With no\n  // locale and no explicit `direction`, writing dir=\"ltr\" would flip an RTL\n  // host's own subtree back to left-to-right — the context value stays\n  // concrete for `useLkDirection`; it is only the DOM declaration we withhold.\n  const declared = direction === 'auto' && locale === undefined ? undefined : value.direction;\n\n  return (\n    <LkIntlContext.Provider value={value}>\n      <div className=\"lk-intl\" lang={locale} dir={declared}>\n        {children}\n      </div>\n    </LkIntlContext.Provider>\n  );\n}\n\n/**\n * The strings in force, with an optional per-component override layered on top.\n *\n * Usable without a provider: every component calls this, and one rendered\n * standalone still needs its labels. Falling back to the English defaults is\n * what keeps `<MultipleChoice>` working with no setup at all.\n */\nexport function useLkStrings(override?: LkStringsOverride): LkStrings {\n  const context = useContext(LkIntlContext);\n  const base = context?.strings ?? DEFAULT_STRINGS;\n  return useMemo(() => mergeStrings(base, override), [base, override]);\n}\n\n/** The direction in force. `ltr` with no provider. */\nexport function useLkDirection(): 'ltr' | 'rtl' {\n  return useContext(LkIntlContext)?.direction ?? 'ltr';\n}\n"]}

package/dist/{chunk-5IH3NRXE.js → chunk-NVP6UEQQ.js}

@@ -1,6 +1,6 @@
 'use client';
-import { ActivityMedia } from './chunk-2Y6V5E7H.js';
-import { useLkStrings } from './chunk-CK7Z275S.js';
+import { ActivityMedia } from './chunk-R7DI5UMU.js';
+import { useLkStrings } from './chunk-3Q4I4KT6.js';
 import { useId, useMemo } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
@@ -57,5 +57,5 @@ function StimulusPanel({
 }
 
 export { StimulusPanel };
-//# sourceMappingURL=chunk-5IH3NRXE.js.map
-//# sourceMappingURL=chunk-5IH3NRXE.js.map
+//# sourceMappingURL=chunk-NVP6UEQQ.js.map
+//# sourceMappingURL=chunk-NVP6UEQQ.js.map

package/dist/{chunk-5IH3NRXE.js.map → chunk-NVP6UEQQ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/StimulusPanel/StimulusPanel.tsx"],"names":[],"mappings":"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","file":"chunk-5IH3NRXE.js","sourcesContent":["'use client';\n\nimport type { InteractionEvent, Stimulus } from '@intellectif/lk-core';\nimport { useId, useMemo } from 'react';\nimport { useLkStrings } from '../../i18n/LkIntlProvider.js';\nimport type { LkStringsOverride } from '../../i18n/strings.js';\nimport { ActivityMedia } from '../shared/ActivityMedia.js';\nimport type {\n  HtmlSanitizer,\n  MediaBudgetBinding,\n  MediaTransportStrings,\n  RenderMode,\n} from '../types.js';\n\nexport interface StimulusPanelProps {\n  stimulus: Stimulus;\n  /**\n   * 1-based presented positions of the first and last question this material\n   * serves, rendered as \"Questions 3–8\" so a learner knows how far the\n   * passage carries.\n   */\n  range?: { first: number; last: number };\n  /** Renders `stimulus.bodyHtml` when provided. See `HtmlSanitizer`. */\n  sanitizeHtml?: HtmlSanitizer;\n  locale?: string;\n  /**\n   * Forwarded to the stimulus's own media. `review` keeps the browser's control\n   * bar even under an enforcing policy — a graded paper cannot be changed by\n   * listening again.\n   */\n  renderMode?: RenderMode;\n  /**\n   * Binds this group's recording to a play budget the consumer persists. One\n   * recording serves every question in the group, so the key is derived from\n   * the ENTRY rather than the slot — see `stimulusMediaKey()` in lk-core.\n   */\n  mediaBudget?: MediaBudgetBinding;\n  /** Translations for the audio transport chrome. */\n  mediaStrings?: Partial<MediaTransportStrings>;\n  onInteraction?: (event: InteractionEvent) => void;\n  disabled?: boolean;\n  /** Overrides the SDK's chrome text for this panel. See {@link LkIntlProvider}. */\n  strings?: LkStringsOverride;\n}\n\n/**\n * Presents a shared stimulus — the passage, recording or image an item group's\n * questions refer to. A landmark region named by its title (or by its kind),\n * so a screen-reader user can jump back to the material from any question.\n *\n * Rich text follows the SDK-wide rule: `bodyHtml` is rendered only through a\n * caller-supplied sanitiser, and the plain `body` is the fallback — which the\n * schema guarantees exists whenever `bodyHtml` does.\n */\nexport function StimulusPanel({\n  stimulus,\n  range,\n  sanitizeHtml,\n  locale,\n  renderMode,\n  mediaBudget,\n  mediaStrings,\n  onInteraction,\n  disabled,\n  strings,\n}: StimulusPanelProps): React.JSX.Element {\n  const titleId = useId();\n  const s = useLkStrings(strings);\n\n  const bodyHtml = useMemo(() => {\n    if (sanitizeHtml === undefined || typeof stimulus.bodyHtml !== 'string') {\n      return null;\n    }\n    return sanitizeHtml(stimulus.bodyHtml);\n  }, [stimulus.bodyHtml, sanitizeHtml]);\n\n  const rangeText = range === undefined ? null : s.stimulusRange(range.first, range.last);\n\n  const naming =\n    stimulus.title !== undefined\n      ? { 'aria-labelledby': titleId }\n      : { 'aria-label': s.stimulusKind[stimulus.kind] };\n\n  // The AUTHORED parts carry the stimulus language; the SDK's own chrome does\n  // not. Declaring `stimulus.locale` on the whole region made a screen reader\n  // read \"Recording\" and \"Questions 3–5\" — English strings this package ships\n  // — in the passage's voice, so a Spanish listening panel announced its own\n  // name and the only orientation text in it with Spanish phonetics\n  // (WCAG 3.1.2 Language of Parts). Scope the declaration to the content it\n  // actually describes.\n  const contentLang = stimulus.locale !== undefined ? { lang: stimulus.locale } : {};\n\n  return (\n    <section className=\"lk-stimulus\" data-kind={stimulus.kind} lang={locale} {...naming}>\n      {stimulus.title !== undefined ? (\n        <p className=\"lk-stimulus-title\" id={titleId} {...contentLang}>\n          {stimulus.title}\n        </p>\n      ) : null}\n      {rangeText !== null ? <p className=\"lk-stimulus-range\">{rangeText}</p> : null}\n      {stimulus.media !== undefined ? (\n        <ActivityMedia\n          media={stimulus.media}\n          {...(renderMode !== undefined ? { renderMode } : {})}\n          {...(mediaBudget !== undefined ? { mediaBudget } : {})}\n          {...(mediaStrings !== undefined ? { mediaStrings } : {})}\n          {...(strings !== undefined ? { strings } : {})}\n          {...(onInteraction !== undefined ? { onInteraction } : {})}\n          {...(disabled !== undefined ? { disabled } : {})}\n          {...(locale !== undefined ? { locale } : {})}\n        />\n      ) : null}\n      {bodyHtml !== null ? (\n        <div\n          className=\"lk-stimulus-body\"\n          data-format=\"html\"\n          {...contentLang}\n          // biome-ignore lint/security/noDangerouslySetInnerHtml: rendered only through the caller-supplied HtmlSanitizer — the SDK never injects unsanitised markup\n          dangerouslySetInnerHTML={{ __html: bodyHtml }}\n        />\n      ) : stimulus.body !== undefined ? (\n        <div className=\"lk-stimulus-body\" data-format=\"text\" {...contentLang}>\n          {stimulus.body}\n        </div>\n      ) : null}\n      {stimulus.attribution !== undefined ? (\n        <p className=\"lk-stimulus-attribution\" {...contentLang}>\n          <cite>{stimulus.attribution}</cite>\n        </p>\n      ) : null}\n    </section>\n  );\n}\n"]}
+{"version":3,"sources":["../src/components/StimulusPanel/StimulusPanel.tsx"],"names":[],"mappings":"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","file":"chunk-NVP6UEQQ.js","sourcesContent":["'use client';\n\nimport type { InteractionEvent, Stimulus } from '@intellectif/lk-core';\nimport { useId, useMemo } from 'react';\nimport { useLkStrings } from '../../i18n/LkIntlProvider.js';\nimport type { LkStringsOverride } from '../../i18n/strings.js';\nimport { ActivityMedia } from '../shared/ActivityMedia.js';\nimport type {\n  HtmlSanitizer,\n  MediaBudgetBinding,\n  MediaTransportStrings,\n  RenderMode,\n} from '../types.js';\n\nexport interface StimulusPanelProps {\n  stimulus: Stimulus;\n  /**\n   * 1-based presented positions of the first and last question this material\n   * serves, rendered as \"Questions 3–8\" so a learner knows how far the\n   * passage carries.\n   */\n  range?: { first: number; last: number };\n  /** Renders `stimulus.bodyHtml` when provided. See `HtmlSanitizer`. */\n  sanitizeHtml?: HtmlSanitizer;\n  locale?: string;\n  /**\n   * Forwarded to the stimulus's own media. `review` keeps the browser's control\n   * bar even under an enforcing policy — a graded paper cannot be changed by\n   * listening again.\n   */\n  renderMode?: RenderMode;\n  /**\n   * Binds this group's recording to a play budget the consumer persists. One\n   * recording serves every question in the group, so the key is derived from\n   * the ENTRY rather than the slot — see `stimulusMediaKey()` in lk-core.\n   */\n  mediaBudget?: MediaBudgetBinding;\n  /** Translations for the audio transport chrome. */\n  mediaStrings?: Partial<MediaTransportStrings>;\n  onInteraction?: (event: InteractionEvent) => void;\n  disabled?: boolean;\n  /** Overrides the SDK's chrome text for this panel. See {@link LkIntlProvider}. */\n  strings?: LkStringsOverride;\n}\n\n/**\n * Presents a shared stimulus — the passage, recording or image an item group's\n * questions refer to. A landmark region named by its title (or by its kind),\n * so a screen-reader user can jump back to the material from any question.\n *\n * Rich text follows the SDK-wide rule: `bodyHtml` is rendered only through a\n * caller-supplied sanitiser, and the plain `body` is the fallback — which the\n * schema guarantees exists whenever `bodyHtml` does.\n */\nexport function StimulusPanel({\n  stimulus,\n  range,\n  sanitizeHtml,\n  locale,\n  renderMode,\n  mediaBudget,\n  mediaStrings,\n  onInteraction,\n  disabled,\n  strings,\n}: StimulusPanelProps): React.JSX.Element {\n  const titleId = useId();\n  const s = useLkStrings(strings);\n\n  const bodyHtml = useMemo(() => {\n    if (sanitizeHtml === undefined || typeof stimulus.bodyHtml !== 'string') {\n      return null;\n    }\n    return sanitizeHtml(stimulus.bodyHtml);\n  }, [stimulus.bodyHtml, sanitizeHtml]);\n\n  const rangeText = range === undefined ? null : s.stimulusRange(range.first, range.last);\n\n  const naming =\n    stimulus.title !== undefined\n      ? { 'aria-labelledby': titleId }\n      : { 'aria-label': s.stimulusKind[stimulus.kind] };\n\n  // The AUTHORED parts carry the stimulus language; the SDK's own chrome does\n  // not. Declaring `stimulus.locale` on the whole region made a screen reader\n  // read \"Recording\" and \"Questions 3–5\" — English strings this package ships\n  // — in the passage's voice, so a Spanish listening panel announced its own\n  // name and the only orientation text in it with Spanish phonetics\n  // (WCAG 3.1.2 Language of Parts). Scope the declaration to the content it\n  // actually describes.\n  const contentLang = stimulus.locale !== undefined ? { lang: stimulus.locale } : {};\n\n  return (\n    <section className=\"lk-stimulus\" data-kind={stimulus.kind} lang={locale} {...naming}>\n      {stimulus.title !== undefined ? (\n        <p className=\"lk-stimulus-title\" id={titleId} {...contentLang}>\n          {stimulus.title}\n        </p>\n      ) : null}\n      {rangeText !== null ? <p className=\"lk-stimulus-range\">{rangeText}</p> : null}\n      {stimulus.media !== undefined ? (\n        <ActivityMedia\n          media={stimulus.media}\n          {...(renderMode !== undefined ? { renderMode } : {})}\n          {...(mediaBudget !== undefined ? { mediaBudget } : {})}\n          {...(mediaStrings !== undefined ? { mediaStrings } : {})}\n          {...(strings !== undefined ? { strings } : {})}\n          {...(onInteraction !== undefined ? { onInteraction } : {})}\n          {...(disabled !== undefined ? { disabled } : {})}\n          {...(locale !== undefined ? { locale } : {})}\n        />\n      ) : null}\n      {bodyHtml !== null ? (\n        <div\n          className=\"lk-stimulus-body\"\n          data-format=\"html\"\n          {...contentLang}\n          // biome-ignore lint/security/noDangerouslySetInnerHtml: rendered only through the caller-supplied HtmlSanitizer — the SDK never injects unsanitised markup\n          dangerouslySetInnerHTML={{ __html: bodyHtml }}\n        />\n      ) : stimulus.body !== undefined ? (\n        <div className=\"lk-stimulus-body\" data-format=\"text\" {...contentLang}>\n          {stimulus.body}\n        </div>\n      ) : null}\n      {stimulus.attribution !== undefined ? (\n        <p className=\"lk-stimulus-attribution\" {...contentLang}>\n          <cite>{stimulus.attribution}</cite>\n        </p>\n      ) : null}\n    </section>\n  );\n}\n"]}

package/dist/{chunk-6KMEB7TF.cjs → chunk-NVUFEMPZ.cjs}

@@ -1,12 +1,13 @@
 'use client';
 'use strict';
 
-var chunkG6PUWKQC_cjs = require('./chunk-G6PUWKQC.cjs');
-var chunkLIHKQEIP_cjs = require('./chunk-LIHKQEIP.cjs');
-var chunkNK5EVL5C_cjs = require('./chunk-NK5EVL5C.cjs');
-var chunk64AJVB6O_cjs = require('./chunk-64AJVB6O.cjs');
-var chunkEWTAMY6L_cjs = require('./chunk-EWTAMY6L.cjs');
-var chunkKYOCDRUO_cjs = require('./chunk-KYOCDRUO.cjs');
+var chunkK7NMNOPI_cjs = require('./chunk-K7NMNOPI.cjs');
+var chunkZ63JRG4M_cjs = require('./chunk-Z63JRG4M.cjs');
+var chunk2GXSA322_cjs = require('./chunk-2GXSA322.cjs');
+var chunkJ73TDY7J_cjs = require('./chunk-J73TDY7J.cjs');
+var chunkUU2NV6SU_cjs = require('./chunk-UU2NV6SU.cjs');
+var chunkK3EA547J_cjs = require('./chunk-K3EA547J.cjs');
+var chunkMA7GXUWC_cjs = require('./chunk-MA7GXUWC.cjs');
 var lkCore = require('@intellectif/lk-core');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
@@ -26,7 +27,7 @@ function ActivityPreview({
   theme,
   locale
 }) {
-  const s = chunkKYOCDRUO_cjs.useLkStrings(strings);
+  const s = chunkMA7GXUWC_cjs.useLkStrings(strings);
   const type = isRecord(draft) && typeof draft.type === "string" ? draft.type : void 0;
   const contentKey = contentKeyOf(draft);
   const result = react.useMemo(
@@ -93,7 +94,7 @@ function ActivityPreview({
   const data = result.data;
   const key = `${renderMode}:${responseKey}:${recordingKeyOf(data)}`;
   if (marking?.kind === "failed") {
-    return /* @__PURE__ */ jsxRuntime.jsx(chunkEWTAMY6L_cjs.ActivityErrorBoundary, { activityTitle: data.title, strings: s, children: /* @__PURE__ */ jsxRuntime.jsx(Rethrow, { error: marking.error }) }, key);
+    return /* @__PURE__ */ jsxRuntime.jsx(chunkK3EA547J_cjs.ActivityErrorBoundary, { activityTitle: data.title, strings: s, children: /* @__PURE__ */ jsxRuntime.jsx(Rethrow, { error: marking.error }) }, key);
   }
   const shared = {
     renderMode,
@@ -120,7 +121,7 @@ function ActivityPreview({
   switch (data.type) {
     case "multiple-choice":
       return /* @__PURE__ */ jsxRuntime.jsx(
-        chunkG6PUWKQC_cjs.MultipleChoice,
+        chunkK7NMNOPI_cjs.MultipleChoice,
         {
           data,
           shuffleSeed: shuffleSeed ?? PREVIEW_SHUFFLE_SEED,
@@ -129,10 +130,10 @@ function ActivityPreview({
         key
       );
     case "fill-in-the-blanks":
-      return /* @__PURE__ */ jsxRuntime.jsx(chunkLIHKQEIP_cjs.FillInTheBlanks, { data, ...shared }, key);
+      return /* @__PURE__ */ jsxRuntime.jsx(chunkZ63JRG4M_cjs.FillInTheBlanks, { data, ...shared }, key);
     case "gap-select":
       return /* @__PURE__ */ jsxRuntime.jsx(
-        chunkNK5EVL5C_cjs.GapSelect,
+        chunk2GXSA322_cjs.GapSelect,
         {
           data,
           shuffleSeed: shuffleSeed ?? PREVIEW_SHUFFLE_SEED,
@@ -141,7 +142,9 @@ function ActivityPreview({
         key
       );
     case "written-response":
-      return /* @__PURE__ */ jsxRuntime.jsx(chunk64AJVB6O_cjs.WrittenResponse, { data, ...shared }, key);
+      return /* @__PURE__ */ jsxRuntime.jsx(chunkUU2NV6SU_cjs.WrittenResponse, { data, ...shared }, key);
+    case "dictation":
+      return /* @__PURE__ */ jsxRuntime.jsx(chunkJ73TDY7J_cjs.Dictation, { data, ...shared }, key);
     default:
       return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "lk-preview-unsupported", role: "note", children: s.unsupportedActivity });
   }
@@ -154,7 +157,17 @@ function isRecord(value) {
 }
 function recordingKeyOf(data) {
   const media = isRecord(data) ? data.media : void 0;
-  return isRecord(media) ? contentKeyOf([media.type, media.url, media.playback]) : "";
+  const slowMedia = isRecord(data) ? data.slowMedia : void 0;
+  const slowUrl = isRecord(slowMedia) ? slowMedia.url : void 0;
+  if (!isRecord(media) && slowUrl === void 0) {
+    return "";
+  }
+  return contentKeyOf([
+    isRecord(media) ? media.type : void 0,
+    isRecord(media) ? media.url : void 0,
+    isRecord(media) ? media.playback : void 0,
+    slowUrl
+  ]);
 }
 var identities = /* @__PURE__ */ new WeakMap();
 var lastIdentity = 0;
@@ -205,5 +218,5 @@ function contentKeyOf(value, enclosing = /* @__PURE__ */ new Set()) {
 }
 
 exports.ActivityPreview = ActivityPreview;
-//# sourceMappingURL=chunk-6KMEB7TF.cjs.map
-//# sourceMappingURL=chunk-6KMEB7TF.cjs.map
+//# sourceMappingURL=chunk-NVUFEMPZ.cjs.map
+//# sourceMappingURL=chunk-NVUFEMPZ.cjs.map

package/dist/chunk-NVUFEMPZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/ActivityPreview/ActivityPreview.tsx"],"names":["useLkStrings","useMemo","validateDraft","evaluate","slotMediaKey","jsx","Fragment","ActivityErrorBoundary","MultipleChoice","FillInTheBlanks","GapSelect","WrittenResponse","Dictation"],"mappings":"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","file":"chunk-NVUFEMPZ.cjs","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 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\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  /** Renderers for activity types beyond the built-ins, keyed by `type`, as on `<ActivitySequence>`. */\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    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 a dictation's slower file, which follows the same policy and\n * 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"]}