@intellectif/lk-react 13.0.0 → 14.0.0

package/dist/components/ActivitySequence.d.ts

@@ -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.js';
-import { a as WrittenResponseSubmission } from '../WrittenResponse-B5p_-RnJ.js';
+import { A as ActivityProps, g as RenderableActivity, e as RenderMode, S as SequenceMediaBudget, h as SequenceRecordingBinding, a as LkStringsOverride, H as HtmlSanitizer } from '../strings-CtdSf2St.js';
+import { a as WrittenResponseSubmission } from '../WrittenResponse-C0P34En1.js';
+import '../machine-CuwKqWXC.js';
 
 /**
  * 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 };

package/dist/components/ActivitySequence.js

@@ -1,14 +1,19 @@
 'use client';
-export { ActivitySequence } from '../chunk-YILH4ETT.js';
-import '../chunk-NVP6UEQQ.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 { ActivitySequence } from '../chunk-I33FOKZ7.js';
+import '../chunk-SWY6PWXK.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=ActivitySequence.js.map
 //# sourceMappingURL=ActivitySequence.js.map

package/dist/components/Dictation.cjs

@@ -1,17 +1,19 @@
 'use client';
 'use strict';
 
-var chunkJ73TDY7J_cjs = require('../chunk-J73TDY7J.cjs');
-require('../chunk-K3EA547J.cjs');
-require('../chunk-SBIJJ374.cjs');
+var chunkWTS34S5E_cjs = require('../chunk-WTS34S5E.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, "Dictation", {
   enumerable: true,
-  get: function () { return chunkJ73TDY7J_cjs.Dictation; }
+  get: function () { return chunkWTS34S5E_cjs.Dictation; }
 });
 //# sourceMappingURL=Dictation.cjs.map
 //# sourceMappingURL=Dictation.cjs.map

package/dist/components/Dictation.d.cts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { DictationData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../strings-DPTyLpHt.cjs';
+import { A as ActivityProps } from '../strings--ADnHcaA.cjs';
+import '../machine-CuwKqWXC.cjs';
 
 interface DictationProps extends ActivityProps<DictationData> {
 }

package/dist/components/Dictation.d.ts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { DictationData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../strings-DPTyLpHt.js';
+import { A as ActivityProps } from '../strings-CtdSf2St.js';
+import '../machine-CuwKqWXC.js';
 
 interface DictationProps extends ActivityProps<DictationData> {
 }

package/dist/components/Dictation.js

@@ -1,8 +1,10 @@
 'use client';
-export { Dictation } from '../chunk-PSHNTDKG.js';
-import '../chunk-DQERNAWI.js';
-import '../chunk-R7DI5UMU.js';
+export { Dictation } from '../chunk-47HHC4GD.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=Dictation.js.map
 //# sourceMappingURL=Dictation.js.map

package/dist/components/FillInTheBlanks.cjs

@@ -1,17 +1,18 @@
 'use client';
 'use strict';
 
-var chunkZ63JRG4M_cjs = require('../chunk-Z63JRG4M.cjs');
-require('../chunk-K3EA547J.cjs');
-require('../chunk-SBIJJ374.cjs');
+var chunkSE6WWDVW_cjs = require('../chunk-SE6WWDVW.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, "FillInTheBlanks", {
   enumerable: true,
-  get: function () { return chunkZ63JRG4M_cjs.FillInTheBlanks; }
+  get: function () { return chunkSE6WWDVW_cjs.FillInTheBlanks; }
 });
 //# sourceMappingURL=FillInTheBlanks.cjs.map
 //# sourceMappingURL=FillInTheBlanks.cjs.map

package/dist/components/FillInTheBlanks.d.cts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FillInTheBlanksData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../strings-DPTyLpHt.cjs';
+import { A as ActivityProps } from '../strings--ADnHcaA.cjs';
+import '../machine-CuwKqWXC.cjs';
 
 interface FillInTheBlanksProps extends ActivityProps<FillInTheBlanksData> {
     /**

package/dist/components/FillInTheBlanks.d.ts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FillInTheBlanksData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../strings-DPTyLpHt.js';
+import { A as ActivityProps } from '../strings-CtdSf2St.js';
+import '../machine-CuwKqWXC.js';
 
 interface FillInTheBlanksProps extends ActivityProps<FillInTheBlanksData> {
     /**

package/dist/components/FillInTheBlanks.js

@@ -1,8 +1,9 @@
 'use client';
-export { FillInTheBlanks } from '../chunk-XAGWBVK3.js';
-import '../chunk-DQERNAWI.js';
-import '../chunk-R7DI5UMU.js';
+export { FillInTheBlanks } from '../chunk-72UGRIMM.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=FillInTheBlanks.js.map
 //# sourceMappingURL=FillInTheBlanks.js.map

package/dist/components/GapSelect.cjs

@@ -1,17 +1,18 @@
 'use client';
 'use strict';
 
-var chunk2GXSA322_cjs = require('../chunk-2GXSA322.cjs');
-require('../chunk-K3EA547J.cjs');
-require('../chunk-SBIJJ374.cjs');
+var chunkU3APKQ7P_cjs = require('../chunk-U3APKQ7P.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, "GapSelect", {
   enumerable: true,
-  get: function () { return chunk2GXSA322_cjs.GapSelect; }
+  get: function () { return chunkU3APKQ7P_cjs.GapSelect; }
 });
 //# sourceMappingURL=GapSelect.cjs.map
 //# sourceMappingURL=GapSelect.cjs.map

package/dist/components/GapSelect.d.cts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { GapSelectData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../strings-DPTyLpHt.cjs';
+import { A as ActivityProps } from '../strings--ADnHcaA.cjs';
+import '../machine-CuwKqWXC.cjs';
 
 interface GapSelectProps extends ActivityProps<GapSelectData> {
     /**

package/dist/components/GapSelect.d.ts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { GapSelectData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../strings-DPTyLpHt.js';
+import { A as ActivityProps } from '../strings-CtdSf2St.js';
+import '../machine-CuwKqWXC.js';
 
 interface GapSelectProps extends ActivityProps<GapSelectData> {
     /**

package/dist/components/GapSelect.js

@@ -1,8 +1,9 @@
 'use client';
-export { GapSelect } from '../chunk-W4MXRZAB.js';
-import '../chunk-DQERNAWI.js';
-import '../chunk-R7DI5UMU.js';
+export { GapSelect } from '../chunk-XUEIUEPI.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=GapSelect.js.map
 //# sourceMappingURL=GapSelect.js.map

package/dist/components/MultipleChoice.cjs

@@ -1,17 +1,18 @@
 'use client';
 'use strict';
 
-var chunkK7NMNOPI_cjs = require('../chunk-K7NMNOPI.cjs');
-require('../chunk-K3EA547J.cjs');
-require('../chunk-SBIJJ374.cjs');
+var chunkNDQD3ZRY_cjs = require('../chunk-NDQD3ZRY.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, "MultipleChoice", {
   enumerable: true,
-  get: function () { return chunkK7NMNOPI_cjs.MultipleChoice; }
+  get: function () { return chunkNDQD3ZRY_cjs.MultipleChoice; }
 });
 //# sourceMappingURL=MultipleChoice.cjs.map
 //# sourceMappingURL=MultipleChoice.cjs.map

package/dist/components/MultipleChoice.d.cts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { MultipleChoiceData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../strings-DPTyLpHt.cjs';
+import { A as ActivityProps } from '../strings--ADnHcaA.cjs';
+import '../machine-CuwKqWXC.cjs';
 
 interface MultipleChoiceProps extends ActivityProps<MultipleChoiceData> {
     /**

package/dist/components/MultipleChoice.d.ts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { MultipleChoiceData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../strings-DPTyLpHt.js';
+import { A as ActivityProps } from '../strings-CtdSf2St.js';
+import '../machine-CuwKqWXC.js';
 
 interface MultipleChoiceProps extends ActivityProps<MultipleChoiceData> {
     /**

package/dist/components/MultipleChoice.js

@@ -1,8 +1,9 @@
 'use client';
-export { MultipleChoice } from '../chunk-5N7OLFHB.js';
-import '../chunk-DQERNAWI.js';
-import '../chunk-R7DI5UMU.js';
+export { MultipleChoice } from '../chunk-LGCUOLP6.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=MultipleChoice.js.map
 //# sourceMappingURL=MultipleChoice.js.map

package/dist/components/PronunciationFeedback.cjs

@@ -0,0 +1,16 @@
+'use client';
+'use strict';
+
+var chunkF4TBCRGI_cjs = require('../chunk-F4TBCRGI.cjs');
+require('../chunk-OD65OZIW.cjs');
+require('../chunk-USBANZ7K.cjs');
+require('../chunk-LB3FEV7Z.cjs');
+
+
+
+Object.defineProperty(exports, "PronunciationFeedback", {
+  enumerable: true,
+  get: function () { return chunkF4TBCRGI_cjs.PronunciationFeedback; }
+});
+//# sourceMappingURL=PronunciationFeedback.cjs.map
+//# sourceMappingURL=PronunciationFeedback.cjs.map

package/dist/components/PronunciationFeedback.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"PronunciationFeedback.cjs"}

package/dist/components/PronunciationFeedback.d.cts

@@ -0,0 +1,64 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReadAloudData, SpeechAssessment, GradeRecord, ThemeTokens } from '@intellectif/lk-core';
+import { a as LkStringsOverride } from '../strings--ADnHcaA.cjs';
+import '../machine-CuwKqWXC.cjs';
+
+interface PronunciationFeedbackProps {
+    /**
+     * The item's reading and its language. Only these two fields, because they
+     * are the only ones a mark depends on — everything else about the activity
+     * belongs to whoever rendered it.
+     */
+    data: Pick<ReadAloudData, 'referenceText' | 'locale'>;
+    /**
+     * The assessor's evidence. Checked with `validateSpeechAssessment` before it
+     * is aligned: see the note on this component about what a bad one costs.
+     */
+    assessment: SpeechAssessment;
+    /**
+     * The grade the evidence produced, when one exists. Its `criteria` are what
+     * the dimensions are read from, because they are the numbers the learner was
+     * actually graded on. A grade that cannot be read — a score that is not a
+     * number between 0 and its maximum, a `passed` that is not a boolean — is
+     * shown as could-not-be-graded, never as a percentage made up from it.
+     */
+    grade?: GradeRecord;
+    /**
+     * The learner's own take, playable. With it, each word that carries timings
+     * gets a button that plays just that word.
+     */
+    audioUrl?: string;
+    /**
+     * Confidence above which a break note is shown, 0..1. **No default**: how
+     * confident an engine has to be before a pause is worth telling a learner
+     * about is a calibration, and the SDK has no calibrated answer. Without it no
+     * break note is shown at all.
+     */
+    breakThreshold?: number;
+    /** The same, for the monotone note read off `assessment.prosody`. */
+    monotoneThreshold?: number;
+    /**
+     * BCP 47 tag stamped as `lang` on the root: the INTERFACE language, the one
+     * this component's own sentences are written in. It is not `data.locale`,
+     * which is the language of the reading and is put on the words themselves.
+     */
+    locale?: string;
+    /** Per-instance token overrides, applied as inline CSS vars on the root. */
+    theme?: Partial<ThemeTokens>;
+    /** Overrides the SDK's chrome text for this panel. See {@link LkIntlProvider}. */
+    strings?: LkStringsOverride;
+}
+
+/**
+ * Public pronunciation-feedback panel: the core wrapped in
+ * `ActivityErrorBoundary` so a render failure (the dev throw for evidence
+ * `validateSpeechAssessment` refuses among them) degrades to an accessible
+ * fallback instead of crashing the host.
+ *
+ * **No `activityTitle`.** Its `data` is two fields of a read-aloud item and
+ * carries no title, so the production fallback is the unnamed one. Naming it
+ * would mean inventing a title for a panel that never had one.
+ */
+declare function PronunciationFeedback(props: PronunciationFeedbackProps): react_jsx_runtime.JSX.Element;
+
+export { PronunciationFeedback, type PronunciationFeedbackProps };

package/dist/components/PronunciationFeedback.d.ts

@@ -0,0 +1,64 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReadAloudData, SpeechAssessment, GradeRecord, ThemeTokens } from '@intellectif/lk-core';
+import { a as LkStringsOverride } from '../strings-CtdSf2St.js';
+import '../machine-CuwKqWXC.js';
+
+interface PronunciationFeedbackProps {
+    /**
+     * The item's reading and its language. Only these two fields, because they
+     * are the only ones a mark depends on — everything else about the activity
+     * belongs to whoever rendered it.
+     */
+    data: Pick<ReadAloudData, 'referenceText' | 'locale'>;
+    /**
+     * The assessor's evidence. Checked with `validateSpeechAssessment` before it
+     * is aligned: see the note on this component about what a bad one costs.
+     */
+    assessment: SpeechAssessment;
+    /**
+     * The grade the evidence produced, when one exists. Its `criteria` are what
+     * the dimensions are read from, because they are the numbers the learner was
+     * actually graded on. A grade that cannot be read — a score that is not a
+     * number between 0 and its maximum, a `passed` that is not a boolean — is
+     * shown as could-not-be-graded, never as a percentage made up from it.
+     */
+    grade?: GradeRecord;
+    /**
+     * The learner's own take, playable. With it, each word that carries timings
+     * gets a button that plays just that word.
+     */
+    audioUrl?: string;
+    /**
+     * Confidence above which a break note is shown, 0..1. **No default**: how
+     * confident an engine has to be before a pause is worth telling a learner
+     * about is a calibration, and the SDK has no calibrated answer. Without it no
+     * break note is shown at all.
+     */
+    breakThreshold?: number;
+    /** The same, for the monotone note read off `assessment.prosody`. */
+    monotoneThreshold?: number;
+    /**
+     * BCP 47 tag stamped as `lang` on the root: the INTERFACE language, the one
+     * this component's own sentences are written in. It is not `data.locale`,
+     * which is the language of the reading and is put on the words themselves.
+     */
+    locale?: string;
+    /** Per-instance token overrides, applied as inline CSS vars on the root. */
+    theme?: Partial<ThemeTokens>;
+    /** Overrides the SDK's chrome text for this panel. See {@link LkIntlProvider}. */
+    strings?: LkStringsOverride;
+}
+
+/**
+ * Public pronunciation-feedback panel: the core wrapped in
+ * `ActivityErrorBoundary` so a render failure (the dev throw for evidence
+ * `validateSpeechAssessment` refuses among them) degrades to an accessible
+ * fallback instead of crashing the host.
+ *
+ * **No `activityTitle`.** Its `data` is two fields of a read-aloud item and
+ * carries no title, so the production fallback is the unnamed one. Naming it
+ * would mean inventing a title for a panel that never had one.
+ */
+declare function PronunciationFeedback(props: PronunciationFeedbackProps): react_jsx_runtime.JSX.Element;
+
+export { PronunciationFeedback, type PronunciationFeedbackProps };

package/dist/components/PronunciationFeedback.js

@@ -0,0 +1,7 @@
+'use client';
+export { PronunciationFeedback } from '../chunk-62AKSD5Y.js';
+import '../chunk-YORQQXGO.js';
+import '../chunk-BO6P723E.js';
+import '../chunk-TDJEKXEP.js';
+//# sourceMappingURL=PronunciationFeedback.js.map
+//# sourceMappingURL=PronunciationFeedback.js.map

package/dist/components/PronunciationFeedback.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"PronunciationFeedback.js"}

package/dist/components/ReadAloud.cjs

@@ -0,0 +1,21 @@
+'use client';
+'use strict';
+
+var chunk36FTYJWJ_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-LB3FEV7Z.cjs');
+
+
+
+Object.defineProperty(exports, "ReadAloud", {
+  enumerable: true,
+  get: function () { return chunk36FTYJWJ_cjs.ReadAloud; }
+});
+//# sourceMappingURL=ReadAloud.cjs.map
+//# sourceMappingURL=ReadAloud.cjs.map

package/dist/components/ReadAloud.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"ReadAloud.cjs"}

package/dist/components/ReadAloud.d.cts

@@ -0,0 +1,15 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { c as ReadAloudProps } from '../strings--ADnHcaA.cjs';
+export { R as ReadAloudAssessResult, d as RecordingBinding } from '../strings--ADnHcaA.cjs';
+export { R as RecordedTake } from '../machine-CuwKqWXC.cjs';
+import '@intellectif/lk-core';
+
+/**
+ * Public Read Aloud activity: the core wrapped in `ActivityErrorBoundary` so a
+ * render failure (including the dev schema-validation throw and the
+ * missing-`upload` guard) degrades to an accessible fallback instead of
+ * crashing the host.
+ */
+declare function ReadAloud(props: ReadAloudProps): react_jsx_runtime.JSX.Element;
+
+export { ReadAloud, ReadAloudProps };