@intellectif/lk-core 0.13.1 → 0.14.0

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { ScoredItem } from './scoring.cjs';
-export { AssessmentScore, AssessmentSectionInput, Band, CompositionPolicy, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, DictationAlignment, DictationCharOp, DictationReference, DictationWordAlignment, PassFailureReason, RoundingMode, RoundingPolicy, ScoringOptions, SectionScore, alignDictation, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, gte, roundGrade, score } from './scoring.cjs';
-import { w as ItemOutcome, A as ActivityData, L as LearnerResponse, V as ValidationError, e as ActivityType, a as ActivityDataMap, C as CriterionScore, p as GradeRecord, N as NativeControlHint, c as ActivityMedia, K as ScoringResult, D as DeferredScoringPartial, f as DictationData, h as DictationLearnerResponse, F as FillInTheBlanksData, k as FillInTheBlanksLearnerResponse, m as GapSelectData, o as GapSelectLearnerResponse, y as MultipleChoiceData, z as MultipleChoiceLearnerResponse, W as WrittenResponseData, Q as WrittenResponseLearnerResponse } from './activity-DfAmJ1sl.cjs';
-export { b as ActivityFeedback, d as ActivityResult, B as BlankConfig, g as DictationEquivalence, i as DictationSlowMedia, j as DictationTolerance, G as GapSelectBank, l as GapSelectChoice, n as GapSelectGap, q as Grader, r as GraderKind, s as GraderUsage, t as GradingState, I as InlineCorrection, u as InteractionEvent, v as InteractionKind, x as LearnerResponseMap, M as MediaPlaybackPolicy, E as MultipleChoiceOption, H as MultipleChoiceOptionMedia, S as ScoringDetail, J as ScoringOutcome, T as TextMatchPolicy, O as TextMatchResult, P as ValidationResult, R as WrittenResponseRubric, U as WrittenResponseRubricCriterion, X as XAPIActor, Y as XAPIConfig, Z as XAPIContext, _ as XAPIContextActivities, $ as XAPIError, a0 as XAPIObject, a1 as XAPIResult, a2 as XAPIScore, a3 as XAPIStatement, a4 as XAPIVerbObject, a5 as levenshteinDistance, a6 as matchText } from './activity-DfAmJ1sl.cjs';
-import { Y as SequenceSlot, X as SequenceEntry, I as ItemGroup } from './index-BefQ8FAS.cjs';
-export { 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, i as MediaSchema, j as MediaUrlSchema, k as MultipleChoiceDataSchema, l as MultipleChoiceOptionMediaSchema, m as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as RedactedActivity, n as RedactedBlankConfig, o as RedactedBlankConfigSchema, p as RedactedDictationData, q as RedactedDictationDataSchema, r as RedactedDictationSlowMedia, s as RedactedDictationSlowMediaSchema, t as RedactedFillInTheBlanksData, u as RedactedFillInTheBlanksDataSchema, v as RedactedGapSelectBank, w as RedactedGapSelectBankSchema, x as RedactedGapSelectChoice, y as RedactedGapSelectChoiceSchema, z as RedactedGapSelectData, A as RedactedGapSelectDataSchema, C as RedactedGapSelectGap, E as RedactedGapSelectGapSchema, H as RedactedItemGroupSchema, J as RedactedMediaSchema, K as RedactedMultipleChoiceData, L as RedactedMultipleChoiceDataSchema, O as RedactedMultipleChoiceOption, P as RedactedMultipleChoiceOptionMedia, Q as RedactedMultipleChoiceOptionMediaSchema, S as RedactedMultipleChoiceOptionSchema, T as RedactedStimulus, U as RedactedStimulusSchema, V as RedactedWrittenResponseData, W as RedactedWrittenResponseDataSchema, Z as SequenceSlotGroup, _ as Stimulus, $ as StimulusKind, a0 as StimulusSchema, a1 as TextMatchPolicySchema, a2 as WrittenResponseDataSchema, a3 as WrittenResponseRubricCriterionSchema, a4 as WrittenResponseRubricSchema, a5 as dictationJsonSchema, a6 as fillInTheBlanksJsonSchema, a7 as gapSelectJsonSchema, a8 as itemGroupJsonSchema, a9 as jsonSchemaFor, aa as multipleChoiceJsonSchema, ab as stimulusJsonSchema, ac as validateActivity, ad as validateItemGroup, ae as writtenResponseJsonSchema } from './index-BefQ8FAS.cjs';
+import { ScoredItem, RoundingPolicy } from './scoring.cjs';
+export { AssessmentScore, AssessmentSectionInput, Band, CompositionPolicy, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, DictationAlignment, DictationCharOp, DictationReference, DictationWordAlignment, GradeReadAloudOptions, PassFailureReason, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, ReadAloudWordAlignment, ReadAloudWordState, RoundingMode, SPEECH_ASSESSMENT_MAX_WORDS, ScoringOptions, SectionScore, SpeechAssessment, SpeechMeasurement, SpeechPhoneme, SpeechPhonemeCandidate, SpeechPlausibilityPolicy, SpeechSyllable, SpeechUnscorable, SpeechUnscorableCode, SpeechWord, SpeechWordError, WavInspection, WavInspectionPolicy, alignDictation, alignReadAloud, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, gradeReadAloud, gte, inspectWav, outcomeFromUnscorable, roundGrade, score, validateSpeechAssessment } from './scoring.cjs';
+import { x as ItemOutcome, A as ActivityData, L as LearnerResponse, Z as ValidationError, e as ActivityType, a as ActivityDataMap, C as CriterionScore, q as GradeRecord, N as NativeControlHint, c as ActivityMedia, W as ScoringResult, f as DeferredScoringPartial, g as DictationData, i as DictationLearnerResponse, F as FillInTheBlanksData, l as FillInTheBlanksLearnerResponse, n as GapSelectData, p as GapSelectLearnerResponse, z as MultipleChoiceData, E as MultipleChoiceLearnerResponse, R as ReadAloudData, P as ReadAloudLearnerResponse, $ as WrittenResponseData, a0 as WrittenResponseLearnerResponse } from './activity-BVkg9VDo.cjs';
+export { b as ActivityFeedback, d as ActivityResult, B as BlankConfig, D as DeferredReason, h as DictationEquivalence, j as DictationSlowMedia, k as DictationTolerance, G as GapSelectBank, m as GapSelectChoice, o as GapSelectGap, r as Grader, s as GraderKind, t as GraderUsage, u as GradingState, I as InlineCorrection, v as InteractionEvent, w as InteractionKind, y as LearnerResponseMap, M as MediaPlaybackPolicy, H as MultipleChoiceOption, J as MultipleChoiceOptionMedia, K as ReadAloudDimension, O as ReadAloudDimensionWeight, Q as ReadAloudSlowMedia, S as RecordingBounds, T as RecordingRef, U as ScoringDetail, V as ScoringOutcome, X as TextMatchPolicy, Y as TextMatchResult, _ as ValidationResult, a1 as WrittenResponseRubric, a2 as WrittenResponseRubricCriterion, a3 as XAPIActor, a4 as XAPIConfig, a5 as XAPIContext, a6 as XAPIContextActivities, a7 as XAPIError, a8 as XAPIObject, a9 as XAPIResult, aa as XAPIScore, ab as XAPIStatement, ac as XAPIVerbObject, ad as levenshteinDistance, ae as matchText } from './activity-BVkg9VDo.cjs';
+import { a0 as SequenceSlot, $ as SequenceEntry, I as ItemGroup } from './index-BE1bM2Wi.cjs';
+export { 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, i as MediaSchema, j as MediaUrlSchema, k as MultipleChoiceDataSchema, l as MultipleChoiceOptionMediaSchema, m as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as ReadAloudDataSchema, n as ReadAloudSlowMediaSchema, o as RedactedActivity, p as RedactedBlankConfig, q as RedactedBlankConfigSchema, r as RedactedDictationData, s as RedactedDictationDataSchema, t as RedactedDictationSlowMedia, u as RedactedDictationSlowMediaSchema, v as RedactedFillInTheBlanksData, w as RedactedFillInTheBlanksDataSchema, x as RedactedGapSelectBank, y as RedactedGapSelectBankSchema, z as RedactedGapSelectChoice, A as RedactedGapSelectChoiceSchema, C as RedactedGapSelectData, E as RedactedGapSelectDataSchema, H as RedactedGapSelectGap, J as RedactedGapSelectGapSchema, K as RedactedItemGroupSchema, L as RedactedMediaSchema, O as RedactedMultipleChoiceData, P as RedactedMultipleChoiceDataSchema, Q as RedactedMultipleChoiceOption, S as RedactedMultipleChoiceOptionMedia, T as RedactedMultipleChoiceOptionMediaSchema, U as RedactedMultipleChoiceOptionSchema, V as RedactedReadAloudData, W as RedactedReadAloudDataSchema, X as RedactedStimulus, Y as RedactedStimulusSchema, Z as RedactedWrittenResponseData, _ as RedactedWrittenResponseDataSchema, a1 as SequenceSlotGroup, a2 as Stimulus, a3 as StimulusKind, a4 as StimulusSchema, a5 as TextMatchPolicySchema, a6 as WrittenResponseDataSchema, a7 as WrittenResponseRubricCriterionSchema, a8 as WrittenResponseRubricSchema, a9 as dictationJsonSchema, aa as fillInTheBlanksJsonSchema, ab as gapSelectJsonSchema, ac as itemGroupJsonSchema, ad as jsonSchemaFor, ae as multipleChoiceJsonSchema, af as readAloudJsonSchema, ag as stimulusJsonSchema, ah as validateActivity, ai as validateItemGroup, aj as writtenResponseJsonSchema } from './index-BE1bM2Wi.cjs';
 import { z } from 'zod/v4';
 export { AnsweredStatementParams, CompletedStatementParams, SubmittedStatementParams, XAPIObjectParams, XAPIStatementParams, XAPIVerb, XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor } from './xapi.cjs';
 
@@ -537,12 +537,14 @@ declare class UnknownActivityTypeError extends Error {
     constructor(activityType: string);
 }
 /**
- * Thrown when `score()` is asked to grade a `redact()` projection (or any
- * activity data whose answer key is missing, yielding a non-finite score).
- * Redacted data is learner-safe precisely because the key was removed, so a
- * score derived from it is meaningless — previously this produced a silent
- * `NaN` that serialized to `null` in a grade column. `evaluate()` returns
- * `{ status: 'unscorable' }` for the same input instead of throwing.
+ * Thrown when a grading entry point is asked to grade a `redact()` projection
+ * (or any activity data whose answer key is missing, yielding a non-finite
+ * score). Redacted data is learner-safe precisely because the key was removed,
+ * so a score derived from it is meaningless — previously this produced a silent
+ * `NaN` that serialized to `null` in a grade column. `evaluate()` answers the
+ * same input without throwing, but it never grades it: a synchronously graded
+ * type comes back `unscorable`, and a deferred one `deferred`, as it does for
+ * any item of that type.
  */
 declare class RedactedScoringError extends Error {
     readonly activityType: string;
@@ -569,6 +571,19 @@ interface GradeFromRubricOptions {
     passThreshold?: number;
     /** Narrative feedback for the learner, carried onto the record verbatim. */
     feedback?: string | null;
+    /**
+     * Compare the pass line the way the score is displayed — both sides rounded,
+     * via `gte` — whichever threshold applies: `passThreshold` above, the
+     * activity's own, or the 0.7 default. The returned `score` stays unrounded.
+     * Opt-in, as on `score()` and `evaluate()`: switching it on moves pass/fail
+     * for totals in the rounding band.
+     *
+     * Checked before any criterion is read: `null` reads as no policy, and a
+     * policy that cannot be applied — an unknown `mode`, or a `dp` that is not a
+     * whole number from 0 to 15 — throws a `RangeError`, even for a rubric that
+     * turns out to be unscorable.
+     */
+    rounding?: RoundingPolicy;
 }
 /**
  * Computes the weighted total from per-criterion scores — the arithmetic that
@@ -817,7 +832,9 @@ type PartialScoringResult = Omit<ScoringResult, 'passed'>;
  * - `public` — safe to send to a learner before they answer.
  * - `answer-key` — reveals (or helps infer) the correct answer or the scoring
  *   rules; removed unless `reveal: 'after-submit'` is requested.
- * - `author-only` — never leaves the authoring/grading context (e.g. rubrics).
+ * - `author-only` — never leaves the authoring/grading context (e.g. the
+ *   author transcript of a listening group's stimulus). A rubric is NOT one:
+ *   it tells the learner what they are assessed on, so it is `public`.
  */
 type Sensitivity = 'public' | 'answer-key' | 'author-only';
 /**
@@ -1016,9 +1033,13 @@ interface RedactOptions {
      *
      * Overrides can only be applied to fields; they cannot re-open a field the
      * caller has not classified, because unclassified still means removed.
-     * Note that tightening below what the type's `redactedSchema` requires is
-     * allowed — the schema check only rejects payloads that reveal MORE than
-     * the learner-safe shape.
+     * What can be tightened is a field the type's `redactedSchema` leaves
+     * OPTIONAL, as it leaves the rubric above: the schema check rejects a
+     * payload that reveals more than the learner-safe shape, and equally one
+     * that is missing part of it. Tightening a field the redacted shape requires
+     * — a read-aloud item's `scoring`, `recording`, `referenceText` or `locale`,
+     * without which the learner has no item to read — throws
+     * {@link ActivitySchemaError} instead of hiding it.
      */
     policy?: FieldPolicy;
 }
@@ -1095,6 +1116,13 @@ declare const gapSelectType: ActivityTypeDescriptor<GapSelectData, GapSelectLear
  * computation identical in a browser and on a server.
  */
 declare const dictationType: ActivityTypeDescriptor<DictationData, DictationLearnerResponse>;
+/**
+ * Built-in Read Aloud descriptor. Grading is DEFERRED: the SDK calls no
+ * assessor, so the synchronous outcome reports only whether a recording was
+ * stored, and `gradeReadAloud` produces the grade once the application holds a
+ * speech assessment.
+ */
+declare const readAloudType: ActivityTypeDescriptor<ReadAloudData, ReadAloudLearnerResponse>;
 
 /**
  * Seeded, deterministic shuffling — the ONE algorithm every presentation-order
@@ -1195,4 +1223,4 @@ interface ThemeTokens {
     '--lk-transition-base': string;
 }
 
-export { ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CriterionScore, DeferredScoringError, DeferredScoringPartial, DictationData, DictationLearnerResponse, type DraftComplete, type DraftContext, type DraftIssue, type DraftNotComplete, type DraftSeverity, type DraftValidationResult, type FieldPolicy, FillInTheBlanksData, FillInTheBlanksLearnerResponse, type FlattenSequenceOptions, GapSelectData, GapSelectLearnerResponse, type GradeFromRubricOptions, GradeRecord, ItemGroup, ItemOutcome, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedPlaybackPolicy, type ResponseDiffEntry, ScoredItem, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, assertRedacted, assertRedactedItemGroup, canonicalJson, contentHash, countWords, createDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };
+export { ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CriterionScore, DeferredScoringError, DeferredScoringPartial, DictationData, DictationLearnerResponse, type DraftComplete, type DraftContext, type DraftIssue, type DraftNotComplete, type DraftSeverity, type DraftValidationResult, type FieldPolicy, FillInTheBlanksData, FillInTheBlanksLearnerResponse, type FlattenSequenceOptions, GapSelectData, GapSelectLearnerResponse, type GradeFromRubricOptions, GradeRecord, ItemGroup, ItemOutcome, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, ReadAloudData, ReadAloudLearnerResponse, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedPlaybackPolicy, type ResponseDiffEntry, RoundingPolicy, ScoredItem, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, assertRedacted, assertRedactedItemGroup, canonicalJson, contentHash, countWords, createDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, readAloudType, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { ScoredItem } from './scoring.js';
-export { AssessmentScore, AssessmentSectionInput, Band, CompositionPolicy, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, DictationAlignment, DictationCharOp, DictationReference, DictationWordAlignment, PassFailureReason, RoundingMode, RoundingPolicy, ScoringOptions, SectionScore, alignDictation, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, gte, roundGrade, score } from './scoring.js';
-import { w as ItemOutcome, A as ActivityData, L as LearnerResponse, V as ValidationError, e as ActivityType, a as ActivityDataMap, C as CriterionScore, p as GradeRecord, N as NativeControlHint, c as ActivityMedia, K as ScoringResult, D as DeferredScoringPartial, f as DictationData, h as DictationLearnerResponse, F as FillInTheBlanksData, k as FillInTheBlanksLearnerResponse, m as GapSelectData, o as GapSelectLearnerResponse, y as MultipleChoiceData, z as MultipleChoiceLearnerResponse, W as WrittenResponseData, Q as WrittenResponseLearnerResponse } from './activity-DfAmJ1sl.js';
-export { b as ActivityFeedback, d as ActivityResult, B as BlankConfig, g as DictationEquivalence, i as DictationSlowMedia, j as DictationTolerance, G as GapSelectBank, l as GapSelectChoice, n as GapSelectGap, q as Grader, r as GraderKind, s as GraderUsage, t as GradingState, I as InlineCorrection, u as InteractionEvent, v as InteractionKind, x as LearnerResponseMap, M as MediaPlaybackPolicy, E as MultipleChoiceOption, H as MultipleChoiceOptionMedia, S as ScoringDetail, J as ScoringOutcome, T as TextMatchPolicy, O as TextMatchResult, P as ValidationResult, R as WrittenResponseRubric, U as WrittenResponseRubricCriterion, X as XAPIActor, Y as XAPIConfig, Z as XAPIContext, _ as XAPIContextActivities, $ as XAPIError, a0 as XAPIObject, a1 as XAPIResult, a2 as XAPIScore, a3 as XAPIStatement, a4 as XAPIVerbObject, a5 as levenshteinDistance, a6 as matchText } from './activity-DfAmJ1sl.js';
-import { Y as SequenceSlot, X as SequenceEntry, I as ItemGroup } from './index-BiIvdASA.js';
-export { 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, i as MediaSchema, j as MediaUrlSchema, k as MultipleChoiceDataSchema, l as MultipleChoiceOptionMediaSchema, m as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as RedactedActivity, n as RedactedBlankConfig, o as RedactedBlankConfigSchema, p as RedactedDictationData, q as RedactedDictationDataSchema, r as RedactedDictationSlowMedia, s as RedactedDictationSlowMediaSchema, t as RedactedFillInTheBlanksData, u as RedactedFillInTheBlanksDataSchema, v as RedactedGapSelectBank, w as RedactedGapSelectBankSchema, x as RedactedGapSelectChoice, y as RedactedGapSelectChoiceSchema, z as RedactedGapSelectData, A as RedactedGapSelectDataSchema, C as RedactedGapSelectGap, E as RedactedGapSelectGapSchema, H as RedactedItemGroupSchema, J as RedactedMediaSchema, K as RedactedMultipleChoiceData, L as RedactedMultipleChoiceDataSchema, O as RedactedMultipleChoiceOption, P as RedactedMultipleChoiceOptionMedia, Q as RedactedMultipleChoiceOptionMediaSchema, S as RedactedMultipleChoiceOptionSchema, T as RedactedStimulus, U as RedactedStimulusSchema, V as RedactedWrittenResponseData, W as RedactedWrittenResponseDataSchema, Z as SequenceSlotGroup, _ as Stimulus, $ as StimulusKind, a0 as StimulusSchema, a1 as TextMatchPolicySchema, a2 as WrittenResponseDataSchema, a3 as WrittenResponseRubricCriterionSchema, a4 as WrittenResponseRubricSchema, a5 as dictationJsonSchema, a6 as fillInTheBlanksJsonSchema, a7 as gapSelectJsonSchema, a8 as itemGroupJsonSchema, a9 as jsonSchemaFor, aa as multipleChoiceJsonSchema, ab as stimulusJsonSchema, ac as validateActivity, ad as validateItemGroup, ae as writtenResponseJsonSchema } from './index-BiIvdASA.js';
+import { ScoredItem, RoundingPolicy } from './scoring.js';
+export { AssessmentScore, AssessmentSectionInput, Band, CompositionPolicy, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, DictationAlignment, DictationCharOp, DictationReference, DictationWordAlignment, GradeReadAloudOptions, PassFailureReason, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, ReadAloudWordAlignment, ReadAloudWordState, RoundingMode, SPEECH_ASSESSMENT_MAX_WORDS, ScoringOptions, SectionScore, SpeechAssessment, SpeechMeasurement, SpeechPhoneme, SpeechPhonemeCandidate, SpeechPlausibilityPolicy, SpeechSyllable, SpeechUnscorable, SpeechUnscorableCode, SpeechWord, SpeechWordError, WavInspection, WavInspectionPolicy, alignDictation, alignReadAloud, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, gradeReadAloud, gte, inspectWav, outcomeFromUnscorable, roundGrade, score, validateSpeechAssessment } from './scoring.js';
+import { x as ItemOutcome, A as ActivityData, L as LearnerResponse, Z as ValidationError, e as ActivityType, a as ActivityDataMap, C as CriterionScore, q as GradeRecord, N as NativeControlHint, c as ActivityMedia, W as ScoringResult, f as DeferredScoringPartial, g as DictationData, i as DictationLearnerResponse, F as FillInTheBlanksData, l as FillInTheBlanksLearnerResponse, n as GapSelectData, p as GapSelectLearnerResponse, z as MultipleChoiceData, E as MultipleChoiceLearnerResponse, R as ReadAloudData, P as ReadAloudLearnerResponse, $ as WrittenResponseData, a0 as WrittenResponseLearnerResponse } from './activity-BVkg9VDo.js';
+export { b as ActivityFeedback, d as ActivityResult, B as BlankConfig, D as DeferredReason, h as DictationEquivalence, j as DictationSlowMedia, k as DictationTolerance, G as GapSelectBank, m as GapSelectChoice, o as GapSelectGap, r as Grader, s as GraderKind, t as GraderUsage, u as GradingState, I as InlineCorrection, v as InteractionEvent, w as InteractionKind, y as LearnerResponseMap, M as MediaPlaybackPolicy, H as MultipleChoiceOption, J as MultipleChoiceOptionMedia, K as ReadAloudDimension, O as ReadAloudDimensionWeight, Q as ReadAloudSlowMedia, S as RecordingBounds, T as RecordingRef, U as ScoringDetail, V as ScoringOutcome, X as TextMatchPolicy, Y as TextMatchResult, _ as ValidationResult, a1 as WrittenResponseRubric, a2 as WrittenResponseRubricCriterion, a3 as XAPIActor, a4 as XAPIConfig, a5 as XAPIContext, a6 as XAPIContextActivities, a7 as XAPIError, a8 as XAPIObject, a9 as XAPIResult, aa as XAPIScore, ab as XAPIStatement, ac as XAPIVerbObject, ad as levenshteinDistance, ae as matchText } from './activity-BVkg9VDo.js';
+import { a0 as SequenceSlot, $ as SequenceEntry, I as ItemGroup } from './index-v2_-Fyn3.js';
+export { 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, i as MediaSchema, j as MediaUrlSchema, k as MultipleChoiceDataSchema, l as MultipleChoiceOptionMediaSchema, m as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as ReadAloudDataSchema, n as ReadAloudSlowMediaSchema, o as RedactedActivity, p as RedactedBlankConfig, q as RedactedBlankConfigSchema, r as RedactedDictationData, s as RedactedDictationDataSchema, t as RedactedDictationSlowMedia, u as RedactedDictationSlowMediaSchema, v as RedactedFillInTheBlanksData, w as RedactedFillInTheBlanksDataSchema, x as RedactedGapSelectBank, y as RedactedGapSelectBankSchema, z as RedactedGapSelectChoice, A as RedactedGapSelectChoiceSchema, C as RedactedGapSelectData, E as RedactedGapSelectDataSchema, H as RedactedGapSelectGap, J as RedactedGapSelectGapSchema, K as RedactedItemGroupSchema, L as RedactedMediaSchema, O as RedactedMultipleChoiceData, P as RedactedMultipleChoiceDataSchema, Q as RedactedMultipleChoiceOption, S as RedactedMultipleChoiceOptionMedia, T as RedactedMultipleChoiceOptionMediaSchema, U as RedactedMultipleChoiceOptionSchema, V as RedactedReadAloudData, W as RedactedReadAloudDataSchema, X as RedactedStimulus, Y as RedactedStimulusSchema, Z as RedactedWrittenResponseData, _ as RedactedWrittenResponseDataSchema, a1 as SequenceSlotGroup, a2 as Stimulus, a3 as StimulusKind, a4 as StimulusSchema, a5 as TextMatchPolicySchema, a6 as WrittenResponseDataSchema, a7 as WrittenResponseRubricCriterionSchema, a8 as WrittenResponseRubricSchema, a9 as dictationJsonSchema, aa as fillInTheBlanksJsonSchema, ab as gapSelectJsonSchema, ac as itemGroupJsonSchema, ad as jsonSchemaFor, ae as multipleChoiceJsonSchema, af as readAloudJsonSchema, ag as stimulusJsonSchema, ah as validateActivity, ai as validateItemGroup, aj as writtenResponseJsonSchema } from './index-v2_-Fyn3.js';
 import { z } from 'zod/v4';
 export { AnsweredStatementParams, CompletedStatementParams, SubmittedStatementParams, XAPIObjectParams, XAPIStatementParams, XAPIVerb, XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor } from './xapi.js';
 
@@ -537,12 +537,14 @@ declare class UnknownActivityTypeError extends Error {
     constructor(activityType: string);
 }
 /**
- * Thrown when `score()` is asked to grade a `redact()` projection (or any
- * activity data whose answer key is missing, yielding a non-finite score).
- * Redacted data is learner-safe precisely because the key was removed, so a
- * score derived from it is meaningless — previously this produced a silent
- * `NaN` that serialized to `null` in a grade column. `evaluate()` returns
- * `{ status: 'unscorable' }` for the same input instead of throwing.
+ * Thrown when a grading entry point is asked to grade a `redact()` projection
+ * (or any activity data whose answer key is missing, yielding a non-finite
+ * score). Redacted data is learner-safe precisely because the key was removed,
+ * so a score derived from it is meaningless — previously this produced a silent
+ * `NaN` that serialized to `null` in a grade column. `evaluate()` answers the
+ * same input without throwing, but it never grades it: a synchronously graded
+ * type comes back `unscorable`, and a deferred one `deferred`, as it does for
+ * any item of that type.
  */
 declare class RedactedScoringError extends Error {
     readonly activityType: string;
@@ -569,6 +571,19 @@ interface GradeFromRubricOptions {
     passThreshold?: number;
     /** Narrative feedback for the learner, carried onto the record verbatim. */
     feedback?: string | null;
+    /**
+     * Compare the pass line the way the score is displayed — both sides rounded,
+     * via `gte` — whichever threshold applies: `passThreshold` above, the
+     * activity's own, or the 0.7 default. The returned `score` stays unrounded.
+     * Opt-in, as on `score()` and `evaluate()`: switching it on moves pass/fail
+     * for totals in the rounding band.
+     *
+     * Checked before any criterion is read: `null` reads as no policy, and a
+     * policy that cannot be applied — an unknown `mode`, or a `dp` that is not a
+     * whole number from 0 to 15 — throws a `RangeError`, even for a rubric that
+     * turns out to be unscorable.
+     */
+    rounding?: RoundingPolicy;
 }
 /**
  * Computes the weighted total from per-criterion scores — the arithmetic that
@@ -817,7 +832,9 @@ type PartialScoringResult = Omit<ScoringResult, 'passed'>;
  * - `public` — safe to send to a learner before they answer.
  * - `answer-key` — reveals (or helps infer) the correct answer or the scoring
  *   rules; removed unless `reveal: 'after-submit'` is requested.
- * - `author-only` — never leaves the authoring/grading context (e.g. rubrics).
+ * - `author-only` — never leaves the authoring/grading context (e.g. the
+ *   author transcript of a listening group's stimulus). A rubric is NOT one:
+ *   it tells the learner what they are assessed on, so it is `public`.
  */
 type Sensitivity = 'public' | 'answer-key' | 'author-only';
 /**
@@ -1016,9 +1033,13 @@ interface RedactOptions {
      *
      * Overrides can only be applied to fields; they cannot re-open a field the
      * caller has not classified, because unclassified still means removed.
-     * Note that tightening below what the type's `redactedSchema` requires is
-     * allowed — the schema check only rejects payloads that reveal MORE than
-     * the learner-safe shape.
+     * What can be tightened is a field the type's `redactedSchema` leaves
+     * OPTIONAL, as it leaves the rubric above: the schema check rejects a
+     * payload that reveals more than the learner-safe shape, and equally one
+     * that is missing part of it. Tightening a field the redacted shape requires
+     * — a read-aloud item's `scoring`, `recording`, `referenceText` or `locale`,
+     * without which the learner has no item to read — throws
+     * {@link ActivitySchemaError} instead of hiding it.
      */
     policy?: FieldPolicy;
 }
@@ -1095,6 +1116,13 @@ declare const gapSelectType: ActivityTypeDescriptor<GapSelectData, GapSelectLear
  * computation identical in a browser and on a server.
  */
 declare const dictationType: ActivityTypeDescriptor<DictationData, DictationLearnerResponse>;
+/**
+ * Built-in Read Aloud descriptor. Grading is DEFERRED: the SDK calls no
+ * assessor, so the synchronous outcome reports only whether a recording was
+ * stored, and `gradeReadAloud` produces the grade once the application holds a
+ * speech assessment.
+ */
+declare const readAloudType: ActivityTypeDescriptor<ReadAloudData, ReadAloudLearnerResponse>;
 
 /**
  * Seeded, deterministic shuffling — the ONE algorithm every presentation-order
@@ -1195,4 +1223,4 @@ interface ThemeTokens {
     '--lk-transition-base': string;
 }
 
-export { ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CriterionScore, DeferredScoringError, DeferredScoringPartial, DictationData, DictationLearnerResponse, type DraftComplete, type DraftContext, type DraftIssue, type DraftNotComplete, type DraftSeverity, type DraftValidationResult, type FieldPolicy, FillInTheBlanksData, FillInTheBlanksLearnerResponse, type FlattenSequenceOptions, GapSelectData, GapSelectLearnerResponse, type GradeFromRubricOptions, GradeRecord, ItemGroup, ItemOutcome, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedPlaybackPolicy, type ResponseDiffEntry, ScoredItem, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, assertRedacted, assertRedactedItemGroup, canonicalJson, contentHash, countWords, createDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };
+export { ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CriterionScore, DeferredScoringError, DeferredScoringPartial, DictationData, DictationLearnerResponse, type DraftComplete, type DraftContext, type DraftIssue, type DraftNotComplete, type DraftSeverity, type DraftValidationResult, type FieldPolicy, FillInTheBlanksData, FillInTheBlanksLearnerResponse, type FlattenSequenceOptions, GapSelectData, GapSelectLearnerResponse, type GradeFromRubricOptions, GradeRecord, ItemGroup, ItemOutcome, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, ReadAloudData, ReadAloudLearnerResponse, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedPlaybackPolicy, type ResponseDiffEntry, RoundingPolicy, ScoredItem, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, assertRedacted, assertRedactedItemGroup, canonicalJson, contentHash, countWords, createDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, readAloudType, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };

package/dist/index.js

@@ -1,24 +1,29 @@
 import {
   DEFAULT_PASS_THRESHOLD,
+  alignReadAloud,
   classifyBand,
   composeAssessmentScore,
   computePassThreshold,
   diffDictationChars,
   evaluate,
   gradeFromRubric,
+  gradeReadAloud,
   gte,
   hasGrade,
+  inspectWav,
   outcomeFromGrade,
+  outcomeFromUnscorable,
   roundGrade,
-  score
-} from "./chunk-FGN4LLSP.js";
+  score,
+  validateSpeechAssessment
+} from "./chunk-RTIR6R2U.js";
 import {
   XAPIVerb,
   XAPI_VERB_DISPLAY,
   validateXAPIStatement,
   xAPIBuilder,
   xapiDefinitionFor
-} from "./chunk-PYP3HCRQ.js";
+} from "./chunk-R7PV3XIC.js";
 import {
   ItemGroupSchema,
   RedactedItemGroupSchema,
@@ -30,11 +35,12 @@ import {
   itemGroupJsonSchema,
   jsonSchemaFor,
   multipleChoiceJsonSchema,
+  readAloudJsonSchema,
   stimulusJsonSchema,
   validateActivity,
   validateItemGroup,
   writtenResponseJsonSchema
-} from "./chunk-Y36S3X3L.js";
+} from "./chunk-NBADQ3JU.js";
 import {
   ActivitySchemaError,
   BlankConfigSchema,
@@ -64,6 +70,12 @@ import {
   MultipleChoiceOptionMediaSchema,
   MultipleChoiceOptionSchema,
   NativeControlHintSchema,
+  READ_ALOUD_MAX_DIMENSION_WEIGHT,
+  READ_ALOUD_MAX_REFERENCE_LENGTH,
+  READ_ALOUD_MAX_SECONDS,
+  READ_ALOUD_MAX_TAKES,
+  ReadAloudDataSchema,
+  ReadAloudSlowMediaSchema,
   RedactedBlankConfigSchema,
   RedactedDictationDataSchema,
   RedactedDictationSlowMediaSchema,
@@ -76,8 +88,10 @@ import {
   RedactedMultipleChoiceDataSchema,
   RedactedMultipleChoiceOptionMediaSchema,
   RedactedMultipleChoiceOptionSchema,
+  RedactedReadAloudDataSchema,
   RedactedScoringError,
   RedactedWrittenResponseDataSchema,
+  SPEECH_ASSESSMENT_MAX_WORDS,
   TextMatchPolicySchema,
   UnknownActivityTypeError,
   WrittenResponseDataSchema,
@@ -104,12 +118,13 @@ import {
   matchText,
   multipleChoiceType,
   pathKey,
+  readAloudType,
   refusesEmpty,
   registerActivityType,
   registeredActivityTypes,
   withValidationScope,
   writtenResponseType
-} from "./chunk-XKKKWKRH.js";
+} from "./chunk-6RND47QE.js";
 
 // src/content-hash.ts
 function canonicalJson(value, seen = /* @__PURE__ */ new Set()) {
@@ -1210,6 +1225,12 @@ export {
   MultipleChoiceOptionMediaSchema,
   MultipleChoiceOptionSchema,
   NativeControlHintSchema,
+  READ_ALOUD_MAX_DIMENSION_WEIGHT,
+  READ_ALOUD_MAX_REFERENCE_LENGTH,
+  READ_ALOUD_MAX_SECONDS,
+  READ_ALOUD_MAX_TAKES,
+  ReadAloudDataSchema,
+  ReadAloudSlowMediaSchema,
   RedactedBlankConfigSchema,
   RedactedDictationDataSchema,
   RedactedDictationSlowMediaSchema,
@@ -1223,9 +1244,11 @@ export {
   RedactedMultipleChoiceDataSchema,
   RedactedMultipleChoiceOptionMediaSchema,
   RedactedMultipleChoiceOptionSchema,
+  RedactedReadAloudDataSchema,
   RedactedScoringError,
   RedactedStimulusSchema,
   RedactedWrittenResponseDataSchema,
+  SPEECH_ASSESSMENT_MAX_WORDS,
   StimulusSchema,
   TextMatchPolicySchema,
   UnknownActivityTypeError,
@@ -1235,6 +1258,7 @@ export {
   XAPIVerb,
   XAPI_VERB_DISPLAY,
   alignDictation,
+  alignReadAloud,
   assertRedacted,
   assertRedactedItemGroup,
   canonicalJson,
@@ -1261,9 +1285,11 @@ export {
   gapSelectType,
   getActivityTypeDescriptor,
   gradeFromRubric,
+  gradeReadAloud,
   gte,
   hasGrade,
   hashSeed,
+  inspectWav,
   isItemGroup,
   itemGroupJsonSchema,
   jsonSchemaFor,
@@ -1272,8 +1298,11 @@ export {
   multipleChoiceJsonSchema,
   multipleChoiceType,
   outcomeFromGrade,
+  outcomeFromUnscorable,
   planAttempt,
   planMediaBudgets,
+  readAloudJsonSchema,
+  readAloudType,
   redact,
   redactItemGroup,
   registerActivityType,
@@ -1294,6 +1323,7 @@ export {
   validateDraft,
   validateItemGroup,
   validateItemGroupDraft,
+  validateSpeechAssessment,
   validateXAPIStatement,
   verifyAttemptPlan,
   writtenResponseJsonSchema,