@intellectif/lk-core 0.20.0 → 0.22.0

package/dist/schemas.d.cts

@@ -1,3 +1,3 @@
-import './activity-f0bgZSTP.cjs';
-export { A as AiPermissionsSchema, B as BlankConfigSchema, D as DictationDataSchema, a as DictationEquivalenceSchema, b as DictationSlowMediaSchema, c as DictationToleranceSchema, F as FeedbackSchema, d as FillInTheBlanksDataSchema, G as GapSelectBankSchema, e as GapSelectChoiceSchema, f as GapSelectDataSchema, g as GapSelectGapSchema, h as ItemGroupSchema, M as MediaPlaybackSchema, j as MediaSchema, l as MediaTimelineSchema, m as MediaTrackSchema, n as MediaUrlSchema, o as MultipleChoiceDataSchema, p as MultipleChoiceOptionMediaSchema, q as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as ReadAloudDataSchema, r as ReadAloudSlowMediaSchema, s as RedactedActivity, t as RedactedBlankConfig, u as RedactedBlankConfigSchema, v as RedactedDictationData, w as RedactedDictationDataSchema, x as RedactedDictationSlowMedia, y as RedactedDictationSlowMediaSchema, z as RedactedFillInTheBlanksData, C as RedactedFillInTheBlanksDataSchema, E as RedactedGapSelectBank, H as RedactedGapSelectBankSchema, J as RedactedGapSelectChoice, K as RedactedGapSelectChoiceSchema, L as RedactedGapSelectData, O as RedactedGapSelectDataSchema, P as RedactedGapSelectGap, Q as RedactedGapSelectGapSchema, S as RedactedItemGroupSchema, T as RedactedMediaSchema, U as RedactedMultipleChoiceData, V as RedactedMultipleChoiceDataSchema, W as RedactedMultipleChoiceOption, X as RedactedMultipleChoiceOptionMedia, Y as RedactedMultipleChoiceOptionMediaSchema, Z as RedactedMultipleChoiceOptionSchema, _ as RedactedReadAloudData, $ as RedactedReadAloudDataSchema, a0 as RedactedStimulus, a1 as RedactedStimulusSchema, a2 as RedactedWrittenResponseData, a3 as RedactedWrittenResponseDataSchema, a9 as StimulusSchema, aa as TextMatchPolicySchema, ac as TimelineChapterSchema, ae as TimelineCueSchema, af as WrittenResponseDataSchema, ag as WrittenResponseRubricCriterionSchema, ah as WrittenResponseRubricSchema, ai as dictationJsonSchema, aj as fillInTheBlanksJsonSchema, ak as gapSelectJsonSchema, al as itemGroupJsonSchema, am as jsonSchemaFor, an as multipleChoiceJsonSchema, ao as readAloudJsonSchema, ap as stimulusJsonSchema, aq as validateActivity, ar as validateItemGroup, as as writtenResponseJsonSchema } from './index-7S3-TLjT.cjs';
+import './activity-CYc7SD3d.cjs';
+export { A as AiPermissionsSchema, B as BlankConfigSchema, D as DictationDataSchema, a as DictationEquivalenceSchema, b as DictationSlowMediaSchema, c as DictationToleranceSchema, F as FeedbackSchema, d as FillInTheBlanksDataSchema, G as GapSelectBankSchema, e as GapSelectChoiceSchema, f as GapSelectDataSchema, g as GapSelectGapSchema, h as ItemGroupSchema, M as MediaPlaybackSchema, j as MediaSchema, l as MediaTimelineSchema, m as MediaTrackSchema, n as MediaUrlSchema, o as MultipleChoiceDataSchema, p as MultipleChoiceOptionMediaSchema, q as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as ReadAloudDataSchema, r as ReadAloudSlowMediaSchema, s as RedactedActivity, t as RedactedBlankConfig, u as RedactedBlankConfigSchema, v as RedactedDictationData, w as RedactedDictationDataSchema, x as RedactedDictationSlowMedia, y as RedactedDictationSlowMediaSchema, z as RedactedFillInTheBlanksData, C as RedactedFillInTheBlanksDataSchema, E as RedactedGapSelectBank, H as RedactedGapSelectBankSchema, J as RedactedGapSelectChoice, K as RedactedGapSelectChoiceSchema, L as RedactedGapSelectData, O as RedactedGapSelectDataSchema, P as RedactedGapSelectGap, Q as RedactedGapSelectGapSchema, S as RedactedItemGroupSchema, T as RedactedMediaSchema, U as RedactedMultipleChoiceData, V as RedactedMultipleChoiceDataSchema, W as RedactedMultipleChoiceOption, X as RedactedMultipleChoiceOptionMedia, Y as RedactedMultipleChoiceOptionMediaSchema, Z as RedactedMultipleChoiceOptionSchema, _ as RedactedReadAloudData, $ as RedactedReadAloudDataSchema, a0 as RedactedStimulus, a1 as RedactedStimulusSchema, a2 as RedactedWrittenResponseData, a3 as RedactedWrittenResponseDataSchema, a9 as StimulusSchema, aa as TextMatchPolicySchema, ac as TimelineChapterSchema, ae as TimelineCueSchema, af as WrittenResponseDataSchema, ag as WrittenResponseRubricCriterionSchema, ah as WrittenResponseRubricSchema, ai as dictationJsonSchema, aj as fillInTheBlanksJsonSchema, ak as gapSelectJsonSchema, al as itemGroupJsonSchema, am as jsonSchemaFor, an as multipleChoiceJsonSchema, ao as readAloudJsonSchema, ap as stimulusJsonSchema, aq as validateActivity, ar as validateItemGroup, as as writtenResponseJsonSchema } from './index-CxxiNSSH.cjs';
 import 'zod/v4';

package/dist/schemas.d.ts

@@ -1,3 +1,3 @@
-import './activity-f0bgZSTP.js';
-export { A as AiPermissionsSchema, B as BlankConfigSchema, D as DictationDataSchema, a as DictationEquivalenceSchema, b as DictationSlowMediaSchema, c as DictationToleranceSchema, F as FeedbackSchema, d as FillInTheBlanksDataSchema, G as GapSelectBankSchema, e as GapSelectChoiceSchema, f as GapSelectDataSchema, g as GapSelectGapSchema, h as ItemGroupSchema, M as MediaPlaybackSchema, j as MediaSchema, l as MediaTimelineSchema, m as MediaTrackSchema, n as MediaUrlSchema, o as MultipleChoiceDataSchema, p as MultipleChoiceOptionMediaSchema, q as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as ReadAloudDataSchema, r as ReadAloudSlowMediaSchema, s as RedactedActivity, t as RedactedBlankConfig, u as RedactedBlankConfigSchema, v as RedactedDictationData, w as RedactedDictationDataSchema, x as RedactedDictationSlowMedia, y as RedactedDictationSlowMediaSchema, z as RedactedFillInTheBlanksData, C as RedactedFillInTheBlanksDataSchema, E as RedactedGapSelectBank, H as RedactedGapSelectBankSchema, J as RedactedGapSelectChoice, K as RedactedGapSelectChoiceSchema, L as RedactedGapSelectData, O as RedactedGapSelectDataSchema, P as RedactedGapSelectGap, Q as RedactedGapSelectGapSchema, S as RedactedItemGroupSchema, T as RedactedMediaSchema, U as RedactedMultipleChoiceData, V as RedactedMultipleChoiceDataSchema, W as RedactedMultipleChoiceOption, X as RedactedMultipleChoiceOptionMedia, Y as RedactedMultipleChoiceOptionMediaSchema, Z as RedactedMultipleChoiceOptionSchema, _ as RedactedReadAloudData, $ as RedactedReadAloudDataSchema, a0 as RedactedStimulus, a1 as RedactedStimulusSchema, a2 as RedactedWrittenResponseData, a3 as RedactedWrittenResponseDataSchema, a9 as StimulusSchema, aa as TextMatchPolicySchema, ac as TimelineChapterSchema, ae as TimelineCueSchema, af as WrittenResponseDataSchema, ag as WrittenResponseRubricCriterionSchema, ah as WrittenResponseRubricSchema, ai as dictationJsonSchema, aj as fillInTheBlanksJsonSchema, ak as gapSelectJsonSchema, al as itemGroupJsonSchema, am as jsonSchemaFor, an as multipleChoiceJsonSchema, ao as readAloudJsonSchema, ap as stimulusJsonSchema, aq as validateActivity, ar as validateItemGroup, as as writtenResponseJsonSchema } from './index-BA9f2ydg.js';
+import './activity-CYc7SD3d.js';
+export { A as AiPermissionsSchema, B as BlankConfigSchema, D as DictationDataSchema, a as DictationEquivalenceSchema, b as DictationSlowMediaSchema, c as DictationToleranceSchema, F as FeedbackSchema, d as FillInTheBlanksDataSchema, G as GapSelectBankSchema, e as GapSelectChoiceSchema, f as GapSelectDataSchema, g as GapSelectGapSchema, h as ItemGroupSchema, M as MediaPlaybackSchema, j as MediaSchema, l as MediaTimelineSchema, m as MediaTrackSchema, n as MediaUrlSchema, o as MultipleChoiceDataSchema, p as MultipleChoiceOptionMediaSchema, q as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as ReadAloudDataSchema, r as ReadAloudSlowMediaSchema, s as RedactedActivity, t as RedactedBlankConfig, u as RedactedBlankConfigSchema, v as RedactedDictationData, w as RedactedDictationDataSchema, x as RedactedDictationSlowMedia, y as RedactedDictationSlowMediaSchema, z as RedactedFillInTheBlanksData, C as RedactedFillInTheBlanksDataSchema, E as RedactedGapSelectBank, H as RedactedGapSelectBankSchema, J as RedactedGapSelectChoice, K as RedactedGapSelectChoiceSchema, L as RedactedGapSelectData, O as RedactedGapSelectDataSchema, P as RedactedGapSelectGap, Q as RedactedGapSelectGapSchema, S as RedactedItemGroupSchema, T as RedactedMediaSchema, U as RedactedMultipleChoiceData, V as RedactedMultipleChoiceDataSchema, W as RedactedMultipleChoiceOption, X as RedactedMultipleChoiceOptionMedia, Y as RedactedMultipleChoiceOptionMediaSchema, Z as RedactedMultipleChoiceOptionSchema, _ as RedactedReadAloudData, $ as RedactedReadAloudDataSchema, a0 as RedactedStimulus, a1 as RedactedStimulusSchema, a2 as RedactedWrittenResponseData, a3 as RedactedWrittenResponseDataSchema, a9 as StimulusSchema, aa as TextMatchPolicySchema, ac as TimelineChapterSchema, ae as TimelineCueSchema, af as WrittenResponseDataSchema, ag as WrittenResponseRubricCriterionSchema, ah as WrittenResponseRubricSchema, ai as dictationJsonSchema, aj as fillInTheBlanksJsonSchema, ak as gapSelectJsonSchema, al as itemGroupJsonSchema, am as jsonSchemaFor, an as multipleChoiceJsonSchema, ao as readAloudJsonSchema, ap as stimulusJsonSchema, aq as validateActivity, ar as validateItemGroup, as as writtenResponseJsonSchema } from './index-0Z3-nnAP.js';
 import 'zod/v4';

package/dist/scoring.cjs

@@ -13,7 +13,13 @@
 
 
 
-var _chunkCOBK2RUXcjs = require('./chunk-COBK2RUX.cjs');
+
+
+
+
+
+
+var _chunkWQVZPIN7cjs = require('./chunk-WQVZPIN7.cjs');
 
 
 
@@ -59,5 +65,11 @@ var _chunkD4TOPSHVcjs = require('./chunk-D4TOPSHV.cjs');
 
 
 
-exports.DEFAULT_PASS_THRESHOLD = _chunkCOBK2RUXcjs.DEFAULT_PASS_THRESHOLD; exports.DICTATION_MAX_ACCEPTED_TRANSCRIPTS = _chunkD4TOPSHVcjs.DICTATION_MAX_ACCEPTED_TRANSCRIPTS; exports.DICTATION_MAX_EQUIVALENCES = _chunkD4TOPSHVcjs.DICTATION_MAX_EQUIVALENCES; exports.DICTATION_MAX_EQUIVALENCE_LENGTH = _chunkD4TOPSHVcjs.DICTATION_MAX_EQUIVALENCE_LENGTH; exports.DICTATION_MAX_TEXT_LENGTH = _chunkD4TOPSHVcjs.DICTATION_MAX_TEXT_LENGTH; exports.DICTATION_MAX_TRANSCRIPT_LENGTH = _chunkD4TOPSHVcjs.DICTATION_MAX_TRANSCRIPT_LENGTH; exports.READ_ALOUD_MAX_DIMENSION_WEIGHT = _chunkD4TOPSHVcjs.READ_ALOUD_MAX_DIMENSION_WEIGHT; exports.READ_ALOUD_MAX_REFERENCE_LENGTH = _chunkD4TOPSHVcjs.READ_ALOUD_MAX_REFERENCE_LENGTH; exports.READ_ALOUD_MAX_SECONDS = _chunkD4TOPSHVcjs.READ_ALOUD_MAX_SECONDS; exports.READ_ALOUD_MAX_TAKES = _chunkD4TOPSHVcjs.READ_ALOUD_MAX_TAKES; exports.SPEECH_ASSESSMENT_MAX_WORDS = _chunkD4TOPSHVcjs.SPEECH_ASSESSMENT_MAX_WORDS; exports.alignDictation = _chunkD4TOPSHVcjs.alignDictation; exports.alignReadAloud = _chunkCOBK2RUXcjs.alignReadAloud; exports.classifyBand = _chunkCOBK2RUXcjs.classifyBand; exports.composeAssessmentScore = _chunkCOBK2RUXcjs.composeAssessmentScore; exports.computePassThreshold = _chunkCOBK2RUXcjs.computePassThreshold; exports.dictationReferenceWords = _chunkD4TOPSHVcjs.dictationReferenceWords; exports.diffDictationChars = _chunkCOBK2RUXcjs.diffDictationChars; exports.evaluate = _chunkCOBK2RUXcjs.evaluate; exports.gradeReadAloud = _chunkCOBK2RUXcjs.gradeReadAloud; exports.gte = _chunkCOBK2RUXcjs.gte; exports.inspectWav = _chunkCOBK2RUXcjs.inspectWav; exports.levenshteinDistance = _chunkD4TOPSHVcjs.levenshteinDistance; exports.matchText = _chunkD4TOPSHVcjs.matchText; exports.outcomeFromUnscorable = _chunkCOBK2RUXcjs.outcomeFromUnscorable; exports.roundGrade = _chunkCOBK2RUXcjs.roundGrade; exports.score = _chunkCOBK2RUXcjs.score; exports.validateSpeechAssessment = _chunkCOBK2RUXcjs.validateSpeechAssessment;
+
+
+
+
+
+
+exports.DEFAULT_ITEM_SCORING_POLICY = _chunkWQVZPIN7cjs.DEFAULT_ITEM_SCORING_POLICY; exports.DEFAULT_PASS_THRESHOLD = _chunkWQVZPIN7cjs.DEFAULT_PASS_THRESHOLD; exports.DICTATION_MAX_ACCEPTED_TRANSCRIPTS = _chunkD4TOPSHVcjs.DICTATION_MAX_ACCEPTED_TRANSCRIPTS; exports.DICTATION_MAX_EQUIVALENCES = _chunkD4TOPSHVcjs.DICTATION_MAX_EQUIVALENCES; exports.DICTATION_MAX_EQUIVALENCE_LENGTH = _chunkD4TOPSHVcjs.DICTATION_MAX_EQUIVALENCE_LENGTH; exports.DICTATION_MAX_TEXT_LENGTH = _chunkD4TOPSHVcjs.DICTATION_MAX_TEXT_LENGTH; exports.DICTATION_MAX_TRANSCRIPT_LENGTH = _chunkD4TOPSHVcjs.DICTATION_MAX_TRANSCRIPT_LENGTH; exports.ITEM_SCORING_MAX_RETRIES = _chunkWQVZPIN7cjs.ITEM_SCORING_MAX_RETRIES; exports.READ_ALOUD_MAX_DIMENSION_WEIGHT = _chunkD4TOPSHVcjs.READ_ALOUD_MAX_DIMENSION_WEIGHT; exports.READ_ALOUD_MAX_REFERENCE_LENGTH = _chunkD4TOPSHVcjs.READ_ALOUD_MAX_REFERENCE_LENGTH; exports.READ_ALOUD_MAX_SECONDS = _chunkD4TOPSHVcjs.READ_ALOUD_MAX_SECONDS; exports.READ_ALOUD_MAX_TAKES = _chunkD4TOPSHVcjs.READ_ALOUD_MAX_TAKES; exports.SPEECH_ASSESSMENT_MAX_WORDS = _chunkD4TOPSHVcjs.SPEECH_ASSESSMENT_MAX_WORDS; exports.alignDictation = _chunkD4TOPSHVcjs.alignDictation; exports.alignReadAloud = _chunkWQVZPIN7cjs.alignReadAloud; exports.classifyBand = _chunkWQVZPIN7cjs.classifyBand; exports.composeAssessmentScore = _chunkWQVZPIN7cjs.composeAssessmentScore; exports.computePassThreshold = _chunkWQVZPIN7cjs.computePassThreshold; exports.dictationReferenceWords = _chunkD4TOPSHVcjs.dictationReferenceWords; exports.diffDictationChars = _chunkWQVZPIN7cjs.diffDictationChars; exports.evaluate = _chunkWQVZPIN7cjs.evaluate; exports.evaluateTries = _chunkWQVZPIN7cjs.evaluateTries; exports.gradeReadAloud = _chunkWQVZPIN7cjs.gradeReadAloud; exports.gte = _chunkWQVZPIN7cjs.gte; exports.inspectWav = _chunkWQVZPIN7cjs.inspectWav; exports.levenshteinDistance = _chunkD4TOPSHVcjs.levenshteinDistance; exports.matchText = _chunkD4TOPSHVcjs.matchText; exports.outcomeFromUnscorable = _chunkWQVZPIN7cjs.outcomeFromUnscorable; exports.resolveItemScoringPolicy = _chunkWQVZPIN7cjs.resolveItemScoringPolicy; exports.roundGrade = _chunkWQVZPIN7cjs.roundGrade; exports.score = _chunkWQVZPIN7cjs.score; exports.scoreTries = _chunkWQVZPIN7cjs.scoreTries; exports.validateItemScoringPolicy = _chunkWQVZPIN7cjs.validateItemScoringPolicy; exports.validateSpeechAssessment = _chunkWQVZPIN7cjs.validateSpeechAssessment;
 //# sourceMappingURL=scoring.cjs.map

package/dist/scoring.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/scoring.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,y6DAAC","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/scoring.cjs"}
+{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/scoring.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,y1EAAC","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/scoring.cjs"}

package/dist/scoring.d.cts

@@ -1,5 +1,5 @@
-import { Y as ItemOutcome, R as Grader, E as DictationData, a as ActivityData, a6 as ReadAloudData, aj as ValidationResult, a9 as ReadAloudLearnerResponse, Q as GradeRecord, Z as LearnerResponse, f as ActivityType, af as ScoringResult } from './activity-f0bgZSTP.cjs';
-export { ac as RecordingRef, ag as TextMatchPolicy, ah as TextMatchResult, ay as levenshteinDistance, az as matchText } from './activity-f0bgZSTP.cjs';
+import { a3 as ItemOutcome, Y as Grader, L as DictationData, a as ActivityData, ad as ReadAloudData, aq as ValidationResult, ag as ReadAloudLearnerResponse, X as GradeRecord, a4 as LearnerResponse, f as ActivityType, am as ScoringResult } from './activity-CYc7SD3d.cjs';
+export { aj as RecordingRef, an as TextMatchPolicy, ao as TextMatchResult, aF as levenshteinDistance, aG as matchText } from './activity-CYc7SD3d.cjs';
 
 /**
  * Rounding for assessment scores.
@@ -216,6 +216,122 @@ interface AssessmentScore {
  */
 declare function composeAssessmentScore(sections: readonly AssessmentSectionInput[], policy: CompositionPolicy): AssessmentScore;
 
+/**
+ * How the questions on a paper are scored when a learner can try again or ask
+ * for hints: how many tries there are, which one counts, and what each try and
+ * each hint costs.
+ *
+ * It sits beside the {@link DeliveryPolicy} and is set per paper in the same
+ * way, but it is a separate object for a reason: every delivery setting takes
+ * something away from what a learner is shown and cannot move a grade, while
+ * every setting here moves one. A delivery policy can be read charitably; this
+ * one cannot, because a grade-moving setting has no safe direction to read a
+ * mistake in. {@link resolveItemScoringPolicy} throws on one.
+ *
+ * Every setting is optional, and absent or `null` is its default. The defaults
+ * are exactly how questions were scored before this policy existed: one try,
+ * nothing costs anything, and the first (only) try counts.
+ *
+ * **The SDK's components apply it in `practice`**, where they grade. An exam's
+ * hints stay free and uncounted, as they always were. See
+ * https://github.com/intellectif/learning-kit/blob/main/docs/scoring.md
+ *
+ * @see {@link scoreTries} for the arithmetic.
+ */
+interface ItemScoringPolicy {
+    /**
+     * What each hint costs, as a fraction of the question's marks: `0.1` takes
+     * a tenth of them per hint. A hint is any a learner is shown before
+     * answering — an author's hint on a blank, a dictation's hint word, an AI
+     * hint — and is counted in the response's `hintsRevealed`.
+     *
+     * A number from 0 to 1. Default 0.
+     */
+    hintPenalty?: number | null;
+    /**
+     * How many more tries a learner gets after an answer that did not earn full
+     * marks: "Try again". A whole number from 0 to 10. Default 0 — one try, as
+     * before.
+     */
+    retries?: number | null;
+    /**
+     * What each try after the first costs, as a fraction of the question's
+     * marks: with `0.25`, a right answer on the second try earns 75%. A number
+     * from 0 to 1. Default 0.
+     *
+     * It applies only where a later try can count — `counts: 'best'` or
+     * `'last'` — and {@link validateItemScoringPolicy} refuses it otherwise.
+     */
+    retryPenalty?: number | null;
+    /**
+     * Which try's score is the question's score.
+     *
+     * - `first` (default): the first. Tries after it are for learning, and
+     *   change no grade — which is why it is the default: switching tries on
+     *   moves no grade until a school also chooses one of the others.
+     * - `best`: the highest, after what each try cost. Never goes down.
+     * - `last`: the latest the policy allows.
+     */
+    counts?: ItemScoringCount | null;
+}
+/** Which try counts: see {@link ItemScoringPolicy.counts}. */
+type ItemScoringCount = 'first' | 'best' | 'last';
+/**
+ * A policy with every setting spelled out: what
+ * {@link resolveItemScoringPolicy} returns and what an attempt plan records,
+ * so the record never depends on a default that may one day change.
+ */
+interface ResolvedItemScoringPolicy {
+    hintPenalty: number;
+    retries: number;
+    retryPenalty: number;
+    counts: ItemScoringCount;
+}
+/** One thing {@link validateItemScoringPolicy} found wrong with a policy. */
+interface ItemScoringPolicyIssue {
+    /** The setting, e.g. `hintPenalty`, or `''` for the policy itself. */
+    path: string;
+    message: string;
+}
+/** One graded try at a question, as {@link scoreTries} reads it. */
+interface ItemTry {
+    /** What the try's answer scored, before anything it cost: from `score()`. */
+    score: number;
+    maxScore: number;
+    /**
+     * Hints shown before this try was submitted, counted from the start of the
+     * question — so a later try's count includes an earlier one's. The response's
+     * `hintsRevealed`. Anything but a whole number of 0 or more reads as 0.
+     */
+    hintsRevealed?: number | undefined;
+}
+/** One try, as {@link scoreTries} scored it. */
+interface ItemTryScore {
+    /** What the answer scored, before anything it cost. */
+    score: number;
+    /** What it scored after what it cost, never below 0. */
+    scored: number;
+    maxScore: number;
+    /** The hints it was charged for. */
+    hintsRevealed: number;
+    /** What it cost, as a fraction of `maxScore`: hints, and the tries before it. */
+    penalty: number;
+}
+/** A question's score under a policy, from its tries. */
+interface ItemTriesScore {
+    /** The counted try's score after what it cost, never below 0. */
+    score: number;
+    maxScore: number;
+    /** 0-based: the try whose score counts. */
+    counted: number;
+    /**
+     * Every try the policy allows, in order, as scored. A try past the
+     * allowance (`1 + retries`) is left out: a learner cannot be given one, so a
+     * record that holds one is not believed.
+     */
+    tries: ItemTryScore[];
+}
+
 /**
  * Speech assessment: the neutral shape a pronunciation assessor's result is
  * mapped into, and the types a read-aloud grade reads and writes.
@@ -582,6 +698,65 @@ declare const DICTATION_MAX_EQUIVALENCES = 100;
  */
 declare const DICTATION_MAX_ACCEPTED_TRANSCRIPTS = 10;
 
+/**
+ * The policy that changes nothing: one try, nothing costs anything, the first
+ * try counts. What an absent policy resolves to, and exactly how questions were
+ * scored before policies existed.
+ */
+declare const DEFAULT_ITEM_SCORING_POLICY: ResolvedItemScoringPolicy;
+/** The most tries after the first a policy can give. */
+declare const ITEM_SCORING_MAX_RETRIES = 10;
+/**
+ * Checks a policy before it is stored or used: every setting absent, `null`,
+ * or a value it can take — costs from 0 to 1, `retries` a whole number from 0
+ * to {@link ITEM_SCORING_MAX_RETRIES}, `counts` one of `first`, `best` or
+ * `last` — and no setting it does not know.
+ *
+ * It also refuses a `retryPenalty` above 0 while the first try counts: that
+ * cost can never be charged, and a school that set it believes retries cost
+ * something. Choose `counts: 'best'` or `'last'`.
+ */
+declare function validateItemScoringPolicy(policy: unknown): {
+    success: true;
+    data: ItemScoringPolicy;
+} | {
+    success: false;
+    issues: ItemScoringPolicyIssue[];
+};
+/**
+ * A policy with every setting spelled out.
+ *
+ * **It throws rather than guess.** A delivery policy reads a setting it cannot
+ * read as a restriction, because that is the safe way round; a setting here
+ * moves a grade, and there is no safe way round — a cost misread as 0 raises
+ * grades, misread as 1 lowers them. So a policy {@link validateItemScoringPolicy}
+ * refuses is refused here too, with a `RangeError` naming what is wrong, as an
+ * unreadable `rounding` is.
+ */
+declare function resolveItemScoringPolicy(policy: unknown): ResolvedItemScoringPolicy;
+/**
+ * A question's score under a policy, from its tries in the order they were
+ * made.
+ *
+ * - **What a try costs** is a fraction of the question's marks, subtracted
+ *   from what its answer scored: `hintPenalty` for every hint shown before it
+ *   (its `hintsRevealed`, which counts from the start of the question), and
+ *   `retryPenalty` for every try before it. A try never scores below 0.
+ * - **Which try counts** is the policy's `counts`: the first, the best after
+ *   costs (the earliest, where two are equal), or the last.
+ * - **Only the tries the policy allows are read**: the first `1 + retries`. A
+ *   record with more cannot have come from a learner under this policy.
+ *
+ * Nothing that cost nothing is changed: with no cost to charge, a try's score
+ * is exactly what its answer scored.
+ *
+ * @throws RangeError for a policy {@link resolveItemScoringPolicy} refuses, for
+ *         an empty list of tries, and for a try whose `score` and `maxScore`
+ *         cannot be a grade — the rule `outcomeFromGrade` applies: `maxScore`
+ *         positive and finite, `score` finite from 0 to it.
+ */
+declare function scoreTries(tries: readonly ItemTry[], policy?: ItemScoringPolicy | ResolvedItemScoringPolicy | null): ItemTriesScore;
+
 /**
  * The pass line, and the authored feedback it selects.
  *
@@ -831,6 +1006,28 @@ interface ScoringOptions {
      */
     rounding?: RoundingPolicy;
 }
+/**
+ * Options for {@link evaluate} and {@link evaluateTries}: {@link ScoringOptions},
+ * and the paper's scoring policy.
+ */
+interface EvaluateOptions extends ScoringOptions {
+    /**
+     * What hints and tries cost, and which try counts — see
+     * {@link ItemScoringPolicy}. Absent or `null`, nothing costs anything and the
+     * outcome is exactly what it was before policies existed.
+     *
+     * `evaluate` reads the hints from the response's `hintsRevealed`. The count
+     * is the client's: when your server knows better — it served the AI hints,
+     * say — write its own count there before you evaluate.
+     *
+     * Checked at the call: a policy `validateItemScoringPolicy` refuses throws a
+     * `RangeError`. A grade-moving setting has no safe way to be misread. Under a
+     * policy, a scored outcome whose numbers cannot be a grade — a registered
+     * scorer out of contract — has nothing to charge a cost to, and comes back
+     * `unscorable`.
+     */
+    scoring?: ItemScoringPolicy | null;
+}
 /**
  * Scores a learner response against activity data and returns a full
  * {@link ScoringResult}.
@@ -858,10 +1055,49 @@ declare function score(activityType: ActivityType, activityData: ActivityData, l
  *   "wrong".
  * - An unregistered `data.type` returns `{ status: 'unscorable' }` rather
  *   than throwing, so a mixed-version content bank cannot crash an exam run.
+ * - With a scoring policy (`options.scoring`), a scored outcome is charged what
+ *   the response's hints cost, and `passed` is read from what is left. The
+ *   `details` and authored `feedback` stay the answer's. For several tries at
+ *   one question, use {@link evaluateTries}.
  *
  * The activity type is read from `data.type` — there is no separate type
  * parameter to disagree with the payload.
  */
-declare function evaluate(data: ActivityData, response: LearnerResponse, options?: ScoringOptions): ItemOutcome;
+declare function evaluate(data: ActivityData, response: LearnerResponse, options?: EvaluateOptions): ItemOutcome;
+/** A question's outcome over its tries: see {@link evaluateTries}. */
+interface ItemTriesOutcome {
+    /**
+     * The question's outcome under the policy. Scored: the counted try's
+     * `details` and authored `feedback` — they describe that answer — with its
+     * `score` after what it cost and `passed` read from that score. Anything
+     * else — deferred, unscorable — is the first try's outcome as `evaluate`
+     * gives it.
+     */
+    outcome: ItemOutcome;
+    /** 0-based: the try whose score counts. `null` when the outcome is not scored. */
+    counted: number | null;
+    /**
+     * Every try the policy allows, as scored: before and after what it cost.
+     * Empty when the outcome is not scored, or when, with no policy, it is an
+     * outcome `evaluate` passes through that cannot be a grade.
+     */
+    tries: ItemTryScore[];
+}
+/**
+ * A question's outcome from every try a learner made at it, in order, under a
+ * paper's scoring policy: what a server that scores practice itself calls,
+ * with the tries it stored, to reach the grade the SDK's components reached.
+ *
+ * Each response is scored as {@link evaluate} scores it, and costed and chosen
+ * as {@link scoreTries} does: hints from each response's `hintsRevealed`,
+ * which counts from the start of the question; the tries before each one;
+ * and the try `counts` names. Only the first `1 + retries` responses are read.
+ *
+ * With no policy it is `evaluate` of the first response: one try, as before.
+ * With no response at all, the question was never answered —
+ * `{ status: 'deferred', reason: 'no_response_recorded' }`, as a missing slot
+ * is everywhere else.
+ */
+declare function evaluateTries(data: ActivityData, responses: readonly LearnerResponse[], options?: EvaluateOptions): ItemTriesOutcome;
 
-export { type AssessmentScore, type AssessmentSectionInput, type Band, type CompositionPolicy, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, type DictationAlignment, type DictationCharOp, type DictationReference, type DictationWordAlignment, type GradeReadAloudOptions, GradeRecord, ItemOutcome, type PassFailureReason, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, ReadAloudData, ReadAloudLearnerResponse, type ReadAloudWordAlignment, type ReadAloudWordState, type RoundingMode, type RoundingPolicy, SPEECH_ASSESSMENT_MAX_WORDS, type ScoredItem, type ScoringOptions, type SectionScore, type SpeechAssessment, type SpeechMeasurement, type SpeechPhoneme, type SpeechPhonemeCandidate, type SpeechPlausibilityPolicy, type SpeechSyllable, type SpeechUnscorable, type SpeechUnscorableCode, type SpeechWord, type SpeechWordError, type WavInspection, type WavInspectionPolicy, alignDictation, alignReadAloud, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, gradeReadAloud, gte, inspectWav, outcomeFromUnscorable, roundGrade, score, validateSpeechAssessment };
+export { type AssessmentScore, type AssessmentSectionInput, type Band, type CompositionPolicy, DEFAULT_ITEM_SCORING_POLICY, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, type DictationAlignment, type DictationCharOp, type DictationReference, type DictationWordAlignment, type EvaluateOptions, type GradeReadAloudOptions, GradeRecord, ITEM_SCORING_MAX_RETRIES, ItemOutcome, type ItemScoringCount, type ItemScoringPolicy, type ItemScoringPolicyIssue, type ItemTriesOutcome, type ItemTriesScore, type ItemTry, type ItemTryScore, type PassFailureReason, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, ReadAloudData, ReadAloudLearnerResponse, type ReadAloudWordAlignment, type ReadAloudWordState, type ResolvedItemScoringPolicy, type RoundingMode, type RoundingPolicy, SPEECH_ASSESSMENT_MAX_WORDS, type ScoredItem, type ScoringOptions, type SectionScore, type SpeechAssessment, type SpeechMeasurement, type SpeechPhoneme, type SpeechPhonemeCandidate, type SpeechPlausibilityPolicy, type SpeechSyllable, type SpeechUnscorable, type SpeechUnscorableCode, type SpeechWord, type SpeechWordError, type WavInspection, type WavInspectionPolicy, alignDictation, alignReadAloud, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, evaluateTries, gradeReadAloud, gte, inspectWav, outcomeFromUnscorable, resolveItemScoringPolicy, roundGrade, score, scoreTries, validateItemScoringPolicy, validateSpeechAssessment };

package/dist/scoring.d.ts

@@ -1,5 +1,5 @@
-import { Y as ItemOutcome, R as Grader, E as DictationData, a as ActivityData, a6 as ReadAloudData, aj as ValidationResult, a9 as ReadAloudLearnerResponse, Q as GradeRecord, Z as LearnerResponse, f as ActivityType, af as ScoringResult } from './activity-f0bgZSTP.js';
-export { ac as RecordingRef, ag as TextMatchPolicy, ah as TextMatchResult, ay as levenshteinDistance, az as matchText } from './activity-f0bgZSTP.js';
+import { a3 as ItemOutcome, Y as Grader, L as DictationData, a as ActivityData, ad as ReadAloudData, aq as ValidationResult, ag as ReadAloudLearnerResponse, X as GradeRecord, a4 as LearnerResponse, f as ActivityType, am as ScoringResult } from './activity-CYc7SD3d.js';
+export { aj as RecordingRef, an as TextMatchPolicy, ao as TextMatchResult, aF as levenshteinDistance, aG as matchText } from './activity-CYc7SD3d.js';
 
 /**
  * Rounding for assessment scores.
@@ -216,6 +216,122 @@ interface AssessmentScore {
  */
 declare function composeAssessmentScore(sections: readonly AssessmentSectionInput[], policy: CompositionPolicy): AssessmentScore;
 
+/**
+ * How the questions on a paper are scored when a learner can try again or ask
+ * for hints: how many tries there are, which one counts, and what each try and
+ * each hint costs.
+ *
+ * It sits beside the {@link DeliveryPolicy} and is set per paper in the same
+ * way, but it is a separate object for a reason: every delivery setting takes
+ * something away from what a learner is shown and cannot move a grade, while
+ * every setting here moves one. A delivery policy can be read charitably; this
+ * one cannot, because a grade-moving setting has no safe direction to read a
+ * mistake in. {@link resolveItemScoringPolicy} throws on one.
+ *
+ * Every setting is optional, and absent or `null` is its default. The defaults
+ * are exactly how questions were scored before this policy existed: one try,
+ * nothing costs anything, and the first (only) try counts.
+ *
+ * **The SDK's components apply it in `practice`**, where they grade. An exam's
+ * hints stay free and uncounted, as they always were. See
+ * https://github.com/intellectif/learning-kit/blob/main/docs/scoring.md
+ *
+ * @see {@link scoreTries} for the arithmetic.
+ */
+interface ItemScoringPolicy {
+    /**
+     * What each hint costs, as a fraction of the question's marks: `0.1` takes
+     * a tenth of them per hint. A hint is any a learner is shown before
+     * answering — an author's hint on a blank, a dictation's hint word, an AI
+     * hint — and is counted in the response's `hintsRevealed`.
+     *
+     * A number from 0 to 1. Default 0.
+     */
+    hintPenalty?: number | null;
+    /**
+     * How many more tries a learner gets after an answer that did not earn full
+     * marks: "Try again". A whole number from 0 to 10. Default 0 — one try, as
+     * before.
+     */
+    retries?: number | null;
+    /**
+     * What each try after the first costs, as a fraction of the question's
+     * marks: with `0.25`, a right answer on the second try earns 75%. A number
+     * from 0 to 1. Default 0.
+     *
+     * It applies only where a later try can count — `counts: 'best'` or
+     * `'last'` — and {@link validateItemScoringPolicy} refuses it otherwise.
+     */
+    retryPenalty?: number | null;
+    /**
+     * Which try's score is the question's score.
+     *
+     * - `first` (default): the first. Tries after it are for learning, and
+     *   change no grade — which is why it is the default: switching tries on
+     *   moves no grade until a school also chooses one of the others.
+     * - `best`: the highest, after what each try cost. Never goes down.
+     * - `last`: the latest the policy allows.
+     */
+    counts?: ItemScoringCount | null;
+}
+/** Which try counts: see {@link ItemScoringPolicy.counts}. */
+type ItemScoringCount = 'first' | 'best' | 'last';
+/**
+ * A policy with every setting spelled out: what
+ * {@link resolveItemScoringPolicy} returns and what an attempt plan records,
+ * so the record never depends on a default that may one day change.
+ */
+interface ResolvedItemScoringPolicy {
+    hintPenalty: number;
+    retries: number;
+    retryPenalty: number;
+    counts: ItemScoringCount;
+}
+/** One thing {@link validateItemScoringPolicy} found wrong with a policy. */
+interface ItemScoringPolicyIssue {
+    /** The setting, e.g. `hintPenalty`, or `''` for the policy itself. */
+    path: string;
+    message: string;
+}
+/** One graded try at a question, as {@link scoreTries} reads it. */
+interface ItemTry {
+    /** What the try's answer scored, before anything it cost: from `score()`. */
+    score: number;
+    maxScore: number;
+    /**
+     * Hints shown before this try was submitted, counted from the start of the
+     * question — so a later try's count includes an earlier one's. The response's
+     * `hintsRevealed`. Anything but a whole number of 0 or more reads as 0.
+     */
+    hintsRevealed?: number | undefined;
+}
+/** One try, as {@link scoreTries} scored it. */
+interface ItemTryScore {
+    /** What the answer scored, before anything it cost. */
+    score: number;
+    /** What it scored after what it cost, never below 0. */
+    scored: number;
+    maxScore: number;
+    /** The hints it was charged for. */
+    hintsRevealed: number;
+    /** What it cost, as a fraction of `maxScore`: hints, and the tries before it. */
+    penalty: number;
+}
+/** A question's score under a policy, from its tries. */
+interface ItemTriesScore {
+    /** The counted try's score after what it cost, never below 0. */
+    score: number;
+    maxScore: number;
+    /** 0-based: the try whose score counts. */
+    counted: number;
+    /**
+     * Every try the policy allows, in order, as scored. A try past the
+     * allowance (`1 + retries`) is left out: a learner cannot be given one, so a
+     * record that holds one is not believed.
+     */
+    tries: ItemTryScore[];
+}
+
 /**
  * Speech assessment: the neutral shape a pronunciation assessor's result is
  * mapped into, and the types a read-aloud grade reads and writes.
@@ -582,6 +698,65 @@ declare const DICTATION_MAX_EQUIVALENCES = 100;
  */
 declare const DICTATION_MAX_ACCEPTED_TRANSCRIPTS = 10;
 
+/**
+ * The policy that changes nothing: one try, nothing costs anything, the first
+ * try counts. What an absent policy resolves to, and exactly how questions were
+ * scored before policies existed.
+ */
+declare const DEFAULT_ITEM_SCORING_POLICY: ResolvedItemScoringPolicy;
+/** The most tries after the first a policy can give. */
+declare const ITEM_SCORING_MAX_RETRIES = 10;
+/**
+ * Checks a policy before it is stored or used: every setting absent, `null`,
+ * or a value it can take — costs from 0 to 1, `retries` a whole number from 0
+ * to {@link ITEM_SCORING_MAX_RETRIES}, `counts` one of `first`, `best` or
+ * `last` — and no setting it does not know.
+ *
+ * It also refuses a `retryPenalty` above 0 while the first try counts: that
+ * cost can never be charged, and a school that set it believes retries cost
+ * something. Choose `counts: 'best'` or `'last'`.
+ */
+declare function validateItemScoringPolicy(policy: unknown): {
+    success: true;
+    data: ItemScoringPolicy;
+} | {
+    success: false;
+    issues: ItemScoringPolicyIssue[];
+};
+/**
+ * A policy with every setting spelled out.
+ *
+ * **It throws rather than guess.** A delivery policy reads a setting it cannot
+ * read as a restriction, because that is the safe way round; a setting here
+ * moves a grade, and there is no safe way round — a cost misread as 0 raises
+ * grades, misread as 1 lowers them. So a policy {@link validateItemScoringPolicy}
+ * refuses is refused here too, with a `RangeError` naming what is wrong, as an
+ * unreadable `rounding` is.
+ */
+declare function resolveItemScoringPolicy(policy: unknown): ResolvedItemScoringPolicy;
+/**
+ * A question's score under a policy, from its tries in the order they were
+ * made.
+ *
+ * - **What a try costs** is a fraction of the question's marks, subtracted
+ *   from what its answer scored: `hintPenalty` for every hint shown before it
+ *   (its `hintsRevealed`, which counts from the start of the question), and
+ *   `retryPenalty` for every try before it. A try never scores below 0.
+ * - **Which try counts** is the policy's `counts`: the first, the best after
+ *   costs (the earliest, where two are equal), or the last.
+ * - **Only the tries the policy allows are read**: the first `1 + retries`. A
+ *   record with more cannot have come from a learner under this policy.
+ *
+ * Nothing that cost nothing is changed: with no cost to charge, a try's score
+ * is exactly what its answer scored.
+ *
+ * @throws RangeError for a policy {@link resolveItemScoringPolicy} refuses, for
+ *         an empty list of tries, and for a try whose `score` and `maxScore`
+ *         cannot be a grade — the rule `outcomeFromGrade` applies: `maxScore`
+ *         positive and finite, `score` finite from 0 to it.
+ */
+declare function scoreTries(tries: readonly ItemTry[], policy?: ItemScoringPolicy | ResolvedItemScoringPolicy | null): ItemTriesScore;
+
 /**
  * The pass line, and the authored feedback it selects.
  *
@@ -831,6 +1006,28 @@ interface ScoringOptions {
      */
     rounding?: RoundingPolicy;
 }
+/**
+ * Options for {@link evaluate} and {@link evaluateTries}: {@link ScoringOptions},
+ * and the paper's scoring policy.
+ */
+interface EvaluateOptions extends ScoringOptions {
+    /**
+     * What hints and tries cost, and which try counts — see
+     * {@link ItemScoringPolicy}. Absent or `null`, nothing costs anything and the
+     * outcome is exactly what it was before policies existed.
+     *
+     * `evaluate` reads the hints from the response's `hintsRevealed`. The count
+     * is the client's: when your server knows better — it served the AI hints,
+     * say — write its own count there before you evaluate.
+     *
+     * Checked at the call: a policy `validateItemScoringPolicy` refuses throws a
+     * `RangeError`. A grade-moving setting has no safe way to be misread. Under a
+     * policy, a scored outcome whose numbers cannot be a grade — a registered
+     * scorer out of contract — has nothing to charge a cost to, and comes back
+     * `unscorable`.
+     */
+    scoring?: ItemScoringPolicy | null;
+}
 /**
  * Scores a learner response against activity data and returns a full
  * {@link ScoringResult}.
@@ -858,10 +1055,49 @@ declare function score(activityType: ActivityType, activityData: ActivityData, l
  *   "wrong".
  * - An unregistered `data.type` returns `{ status: 'unscorable' }` rather
  *   than throwing, so a mixed-version content bank cannot crash an exam run.
+ * - With a scoring policy (`options.scoring`), a scored outcome is charged what
+ *   the response's hints cost, and `passed` is read from what is left. The
+ *   `details` and authored `feedback` stay the answer's. For several tries at
+ *   one question, use {@link evaluateTries}.
  *
  * The activity type is read from `data.type` — there is no separate type
  * parameter to disagree with the payload.
  */
-declare function evaluate(data: ActivityData, response: LearnerResponse, options?: ScoringOptions): ItemOutcome;
+declare function evaluate(data: ActivityData, response: LearnerResponse, options?: EvaluateOptions): ItemOutcome;
+/** A question's outcome over its tries: see {@link evaluateTries}. */
+interface ItemTriesOutcome {
+    /**
+     * The question's outcome under the policy. Scored: the counted try's
+     * `details` and authored `feedback` — they describe that answer — with its
+     * `score` after what it cost and `passed` read from that score. Anything
+     * else — deferred, unscorable — is the first try's outcome as `evaluate`
+     * gives it.
+     */
+    outcome: ItemOutcome;
+    /** 0-based: the try whose score counts. `null` when the outcome is not scored. */
+    counted: number | null;
+    /**
+     * Every try the policy allows, as scored: before and after what it cost.
+     * Empty when the outcome is not scored, or when, with no policy, it is an
+     * outcome `evaluate` passes through that cannot be a grade.
+     */
+    tries: ItemTryScore[];
+}
+/**
+ * A question's outcome from every try a learner made at it, in order, under a
+ * paper's scoring policy: what a server that scores practice itself calls,
+ * with the tries it stored, to reach the grade the SDK's components reached.
+ *
+ * Each response is scored as {@link evaluate} scores it, and costed and chosen
+ * as {@link scoreTries} does: hints from each response's `hintsRevealed`,
+ * which counts from the start of the question; the tries before each one;
+ * and the try `counts` names. Only the first `1 + retries` responses are read.
+ *
+ * With no policy it is `evaluate` of the first response: one try, as before.
+ * With no response at all, the question was never answered —
+ * `{ status: 'deferred', reason: 'no_response_recorded' }`, as a missing slot
+ * is everywhere else.
+ */
+declare function evaluateTries(data: ActivityData, responses: readonly LearnerResponse[], options?: EvaluateOptions): ItemTriesOutcome;
 
-export { type AssessmentScore, type AssessmentSectionInput, type Band, type CompositionPolicy, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, type DictationAlignment, type DictationCharOp, type DictationReference, type DictationWordAlignment, type GradeReadAloudOptions, GradeRecord, ItemOutcome, type PassFailureReason, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, ReadAloudData, ReadAloudLearnerResponse, type ReadAloudWordAlignment, type ReadAloudWordState, type RoundingMode, type RoundingPolicy, SPEECH_ASSESSMENT_MAX_WORDS, type ScoredItem, type ScoringOptions, type SectionScore, type SpeechAssessment, type SpeechMeasurement, type SpeechPhoneme, type SpeechPhonemeCandidate, type SpeechPlausibilityPolicy, type SpeechSyllable, type SpeechUnscorable, type SpeechUnscorableCode, type SpeechWord, type SpeechWordError, type WavInspection, type WavInspectionPolicy, alignDictation, alignReadAloud, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, gradeReadAloud, gte, inspectWav, outcomeFromUnscorable, roundGrade, score, validateSpeechAssessment };
+export { type AssessmentScore, type AssessmentSectionInput, type Band, type CompositionPolicy, DEFAULT_ITEM_SCORING_POLICY, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, type DictationAlignment, type DictationCharOp, type DictationReference, type DictationWordAlignment, type EvaluateOptions, type GradeReadAloudOptions, GradeRecord, ITEM_SCORING_MAX_RETRIES, ItemOutcome, type ItemScoringCount, type ItemScoringPolicy, type ItemScoringPolicyIssue, type ItemTriesOutcome, type ItemTriesScore, type ItemTry, type ItemTryScore, type PassFailureReason, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, ReadAloudData, ReadAloudLearnerResponse, type ReadAloudWordAlignment, type ReadAloudWordState, type ResolvedItemScoringPolicy, type RoundingMode, type RoundingPolicy, SPEECH_ASSESSMENT_MAX_WORDS, type ScoredItem, type ScoringOptions, type SectionScore, type SpeechAssessment, type SpeechMeasurement, type SpeechPhoneme, type SpeechPhonemeCandidate, type SpeechPlausibilityPolicy, type SpeechSyllable, type SpeechUnscorable, type SpeechUnscorableCode, type SpeechWord, type SpeechWordError, type WavInspection, type WavInspectionPolicy, alignDictation, alignReadAloud, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, evaluateTries, gradeReadAloud, gte, inspectWav, outcomeFromUnscorable, resolveItemScoringPolicy, roundGrade, score, scoreTries, validateItemScoringPolicy, validateSpeechAssessment };