@intellectif/lk-core 0.17.0 → 0.19.0

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { v as AiSupportedActivityType, g as AiActivityInput, k as AiFeature, Z as LearnerResponse, Y as ItemOutcome, j as AiExplanationRequest, o as AiGrade, p as AiHintRequest, ad as ScoringDetail, q as AiItemFacts, w as AiTextResult, u as AiRefusal, a as ActivityData, ai as ValidationError, f as ActivityType, b as ActivityDataMap, C as CriterionScore, Q as GradeRecord, a5 as NativeControlHint, d as ActivityMedia, af as ScoringResult, z as DeferredScoringPartial, E as DictationData, G as DictationLearnerResponse, J as FillInTheBlanksData, K as FillInTheBlanksLearnerResponse, N as GapSelectData, P as GapSelectLearnerResponse, a1 as MultipleChoiceData, a2 as MultipleChoiceLearnerResponse, a6 as ReadAloudData, a9 as ReadAloudLearnerResponse, ak as WrittenResponseData, al as WrittenResponseLearnerResponse } from './activity-BmjBjXVJ.cjs';
-export { A as ActivityAiPermissions, c as ActivityFeedback, e as ActivityResult, h as AiBlankFact, i as AiDictationFacts, l as AiFillInTheBlanksFacts, m as AiGapFact, n as AiGapSelectFacts, r as AiMultipleChoiceFacts, s as AiOptionFact, t as AiProvenance, x as AiVerdict, y as AiWordFact, B as BlankConfig, D as DeferredReason, F as DictationEquivalence, H as DictationSlowMedia, I as DictationTolerance, L as GapSelectBank, M as GapSelectChoice, O as GapSelectGap, R as Grader, S as GraderKind, T as GraderUsage, U as GradingState, V as InlineCorrection, W as InteractionEvent, X as InteractionKind, _ as LearnerResponseMap, $ as MediaPlaybackPolicy, a0 as MediaTrack, a3 as MultipleChoiceOption, a4 as MultipleChoiceOptionMedia, a7 as ReadAloudDimension, a8 as ReadAloudDimensionWeight, aa as ReadAloudSlowMedia, ab as RecordingBounds, ac as RecordingRef, ae as ScoringOutcome, ag as TextMatchPolicy, ah as TextMatchResult, aj as ValidationResult, am as WrittenResponseRubric, an as WrittenResponseRubricCriterion, ao as XAPIActor, ap as XAPIConfig, aq as XAPIContext, ar as XAPIContextActivities, as as XAPIError, at as XAPIObject, au as XAPIResult, av as XAPIScore, aw as XAPIStatement, ax as XAPIVerbObject, ay as levenshteinDistance, az as matchText } from './activity-BmjBjXVJ.cjs';
+import { v as AiSupportedActivityType, g as AiActivityInput, k as AiFeature, Z as LearnerResponse, Y as ItemOutcome, j as AiExplanationRequest, o as AiGrade, p as AiHintRequest, ad as ScoringDetail, q as AiItemFacts, w as AiTextResult, u as AiRefusal, a as ActivityData, ai as ValidationError, f as ActivityType, b as ActivityDataMap, C as CriterionScore, Q as GradeRecord, a5 as NativeControlHint, d as ActivityMedia, af as ScoringResult, z as DeferredScoringPartial, E as DictationData, G as DictationLearnerResponse, J as FillInTheBlanksData, K as FillInTheBlanksLearnerResponse, N as GapSelectData, P as GapSelectLearnerResponse, a1 as MultipleChoiceData, a2 as MultipleChoiceLearnerResponse, a6 as ReadAloudData, a9 as ReadAloudLearnerResponse, ak as WrittenResponseData, al as WrittenResponseLearnerResponse } from './activity-f0bgZSTP.cjs';
+export { A as ActivityAiPermissions, c as ActivityFeedback, e as ActivityResult, h as AiBlankFact, i as AiDictationFacts, l as AiFillInTheBlanksFacts, m as AiGapFact, n as AiGapSelectFacts, r as AiMultipleChoiceFacts, s as AiOptionFact, t as AiProvenance, x as AiVerdict, y as AiWordFact, B as BlankConfig, D as DeferredReason, F as DictationEquivalence, H as DictationSlowMedia, I as DictationTolerance, L as GapSelectBank, M as GapSelectChoice, O as GapSelectGap, R as Grader, S as GraderKind, T as GraderUsage, U as GradingState, V as InlineCorrection, W as InteractionEvent, X as InteractionKind, _ as LearnerResponseMap, $ as MediaPlaybackPolicy, a0 as MediaTrack, a3 as MultipleChoiceOption, a4 as MultipleChoiceOptionMedia, a7 as ReadAloudDimension, a8 as ReadAloudDimensionWeight, aa as ReadAloudSlowMedia, ab as RecordingBounds, ac as RecordingRef, ae as ScoringOutcome, ag as TextMatchPolicy, ah as TextMatchResult, aj as ValidationResult, am as WrittenResponseRubric, an as WrittenResponseRubricCriterion, ao as XAPIActor, ap as XAPIConfig, aq as XAPIContext, ar as XAPIContextActivities, as as XAPIError, at as XAPIObject, au as XAPIResult, av as XAPIScore, aw as XAPIStatement, ax as XAPIVerbObject, ay as levenshteinDistance, az as matchText } from './activity-f0bgZSTP.cjs';
 import { ScoredItem, RoundingPolicy, CompositionPolicy, AssessmentScore } from './scoring.cjs';
 export { AssessmentSectionInput, Band, 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 { a5 as SequenceSlot, a4 as SequenceEntry, I as ItemGroup, i as MediaProgress } from './index-CvfeD_cU.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, k as MediaTimeline, 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, a6 as SequenceSlotGroup, a7 as Stimulus, a8 as StimulusKind, a9 as StimulusSchema, aa as TextMatchPolicySchema, ab as TimelineChapter, ac as TimelineChapterSchema, ad as TimelineCue, 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-CvfeD_cU.cjs';
+import { a5 as SequenceSlot, a4 as SequenceEntry, I as ItemGroup, i as MediaProgress } from './index-bpuDhvXV.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, k as MediaTimeline, 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, a6 as SequenceSlotGroup, a7 as Stimulus, a8 as StimulusKind, a9 as StimulusSchema, aa as TextMatchPolicySchema, ab as TimelineChapter, ac as TimelineChapterSchema, ad as TimelineCue, 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-bpuDhvXV.cjs';
 import { z } from 'zod/v4';
 export { AnsweredStatementParams, CompletedStatementParams, SubmittedStatementParams, XAPIObjectParams, XAPIStatementParams, XAPIVerb, XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor } from './xapi.cjs';
 
@@ -45,11 +45,15 @@ declare function aiGradeOf(result: {
 declare function buildAiFacts(data: AiActivityInput, response: LearnerResponse | null, details: readonly ScoringDetail[] | null): AiItemFacts | null;
 /**
  * The request for an explanation of `response`, or `null` when there is none
- * to give: an unsupported type, an author who switched explanations off, or
- * nothing graded to explain.
+ * to give: an unsupported type, an author who switched explanations off,
+ * nothing graded to explain, or a grade of record that cannot be a grade.
  *
  * A scored `outcome` — the grade of record a review shows — wins over grading
- * locally, so the explanation speaks to the grade on the screen.
+ * locally, so the explanation speaks to the grade on the screen. One whose
+ * numbers cannot be a grade (the rule `outcomeFromGrade` applies: `maxScore`
+ * positive and finite, `score` finite from 0 to it) gets no explanation at all:
+ * explaining 85 "out of 1" would tell the model a wrong answer was correct, and
+ * grading locally instead would speak to a grade the screen does not show.
  */
 declare function aiExplanationRequest(input: {
     data: AiActivityInput;
@@ -743,10 +747,12 @@ interface GradeFromRubricOptions {
  * total a pure function of the judgements, so a grade can be recomputed and
  * audited years later.
  *
- * Weights are normalised by their sum, so they need not add to 1. Criteria
- * marked `notApplicable`, and those carrying no numeric `score` (a purely
- * banded judgement), are excluded from both numerator and denominator. When
- * nothing scoreable remains the result is `unscorable`, never a zero.
+ * Weights are normalised by their sum, so they need not add to 1; each must be
+ * zero or more, and their sum a positive, finite number, or the result is
+ * `unscorable`. Criteria marked `notApplicable`, and those carrying no numeric
+ * `score` (a purely banded judgement), are excluded from both numerator and
+ * denominator, weight included. When nothing scoreable remains the result is
+ * `unscorable`, never a zero.
  *
  * Scores need not be in [0,1]: set `maxScore` on a criterion to declare what
  * its score is out of, and each is normalised before weighting. A grader
@@ -771,6 +777,19 @@ declare function gradeFromRubric(criteria: readonly CriterionScore[], activityDa
  * a grade that arrived asynchronously renders through the same path as a
  * synchronously scored item. The score/passed/feedback fields are mirrored
  * onto the outcome for uniform reads; `grade` carries the full record.
+ *
+ * A record whose numbers cannot be a grade is refused, as `evaluate` refuses a
+ * non-finite score and {@link gradeFromRubric} one outside [0,1]. `maxScore`
+ * must be a positive, finite number and `score` a finite number from 0 to it (a
+ * hair above, one part in a billion, is float noise and passes as it is).
+ * Anything else — NaN, 85 "out of 1", a score out of 0 — comes back as
+ * `{ status: 'deferred', reason: 'grade_rejected', maxScore: 1, rejectedGrade }`
+ * with the record kept verbatim. Not `graded`, or its `passed` would be read as
+ * a verdict; not `unscorable`, which `composeAssessmentScore` drops from the
+ * denominator while letting the attempt go final — so a failing grade on the
+ * wrong scale would vanish and the rest would be recorded as a pass. Deferred
+ * is what it is: the slot is still owed a real grade, so a composed attempt
+ * stays `provisional` and names the slot in `rejectedSlotIds`.
  */
 declare function outcomeFromGrade(grade: GradeRecord): ItemOutcome;
 /**

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { v as AiSupportedActivityType, g as AiActivityInput, k as AiFeature, Z as LearnerResponse, Y as ItemOutcome, j as AiExplanationRequest, o as AiGrade, p as AiHintRequest, ad as ScoringDetail, q as AiItemFacts, w as AiTextResult, u as AiRefusal, a as ActivityData, ai as ValidationError, f as ActivityType, b as ActivityDataMap, C as CriterionScore, Q as GradeRecord, a5 as NativeControlHint, d as ActivityMedia, af as ScoringResult, z as DeferredScoringPartial, E as DictationData, G as DictationLearnerResponse, J as FillInTheBlanksData, K as FillInTheBlanksLearnerResponse, N as GapSelectData, P as GapSelectLearnerResponse, a1 as MultipleChoiceData, a2 as MultipleChoiceLearnerResponse, a6 as ReadAloudData, a9 as ReadAloudLearnerResponse, ak as WrittenResponseData, al as WrittenResponseLearnerResponse } from './activity-BmjBjXVJ.js';
-export { A as ActivityAiPermissions, c as ActivityFeedback, e as ActivityResult, h as AiBlankFact, i as AiDictationFacts, l as AiFillInTheBlanksFacts, m as AiGapFact, n as AiGapSelectFacts, r as AiMultipleChoiceFacts, s as AiOptionFact, t as AiProvenance, x as AiVerdict, y as AiWordFact, B as BlankConfig, D as DeferredReason, F as DictationEquivalence, H as DictationSlowMedia, I as DictationTolerance, L as GapSelectBank, M as GapSelectChoice, O as GapSelectGap, R as Grader, S as GraderKind, T as GraderUsage, U as GradingState, V as InlineCorrection, W as InteractionEvent, X as InteractionKind, _ as LearnerResponseMap, $ as MediaPlaybackPolicy, a0 as MediaTrack, a3 as MultipleChoiceOption, a4 as MultipleChoiceOptionMedia, a7 as ReadAloudDimension, a8 as ReadAloudDimensionWeight, aa as ReadAloudSlowMedia, ab as RecordingBounds, ac as RecordingRef, ae as ScoringOutcome, ag as TextMatchPolicy, ah as TextMatchResult, aj as ValidationResult, am as WrittenResponseRubric, an as WrittenResponseRubricCriterion, ao as XAPIActor, ap as XAPIConfig, aq as XAPIContext, ar as XAPIContextActivities, as as XAPIError, at as XAPIObject, au as XAPIResult, av as XAPIScore, aw as XAPIStatement, ax as XAPIVerbObject, ay as levenshteinDistance, az as matchText } from './activity-BmjBjXVJ.js';
+import { v as AiSupportedActivityType, g as AiActivityInput, k as AiFeature, Z as LearnerResponse, Y as ItemOutcome, j as AiExplanationRequest, o as AiGrade, p as AiHintRequest, ad as ScoringDetail, q as AiItemFacts, w as AiTextResult, u as AiRefusal, a as ActivityData, ai as ValidationError, f as ActivityType, b as ActivityDataMap, C as CriterionScore, Q as GradeRecord, a5 as NativeControlHint, d as ActivityMedia, af as ScoringResult, z as DeferredScoringPartial, E as DictationData, G as DictationLearnerResponse, J as FillInTheBlanksData, K as FillInTheBlanksLearnerResponse, N as GapSelectData, P as GapSelectLearnerResponse, a1 as MultipleChoiceData, a2 as MultipleChoiceLearnerResponse, a6 as ReadAloudData, a9 as ReadAloudLearnerResponse, ak as WrittenResponseData, al as WrittenResponseLearnerResponse } from './activity-f0bgZSTP.js';
+export { A as ActivityAiPermissions, c as ActivityFeedback, e as ActivityResult, h as AiBlankFact, i as AiDictationFacts, l as AiFillInTheBlanksFacts, m as AiGapFact, n as AiGapSelectFacts, r as AiMultipleChoiceFacts, s as AiOptionFact, t as AiProvenance, x as AiVerdict, y as AiWordFact, B as BlankConfig, D as DeferredReason, F as DictationEquivalence, H as DictationSlowMedia, I as DictationTolerance, L as GapSelectBank, M as GapSelectChoice, O as GapSelectGap, R as Grader, S as GraderKind, T as GraderUsage, U as GradingState, V as InlineCorrection, W as InteractionEvent, X as InteractionKind, _ as LearnerResponseMap, $ as MediaPlaybackPolicy, a0 as MediaTrack, a3 as MultipleChoiceOption, a4 as MultipleChoiceOptionMedia, a7 as ReadAloudDimension, a8 as ReadAloudDimensionWeight, aa as ReadAloudSlowMedia, ab as RecordingBounds, ac as RecordingRef, ae as ScoringOutcome, ag as TextMatchPolicy, ah as TextMatchResult, aj as ValidationResult, am as WrittenResponseRubric, an as WrittenResponseRubricCriterion, ao as XAPIActor, ap as XAPIConfig, aq as XAPIContext, ar as XAPIContextActivities, as as XAPIError, at as XAPIObject, au as XAPIResult, av as XAPIScore, aw as XAPIStatement, ax as XAPIVerbObject, ay as levenshteinDistance, az as matchText } from './activity-f0bgZSTP.js';
 import { ScoredItem, RoundingPolicy, CompositionPolicy, AssessmentScore } from './scoring.js';
 export { AssessmentSectionInput, Band, 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 { a5 as SequenceSlot, a4 as SequenceEntry, I as ItemGroup, i as MediaProgress } from './index-G_KusUcK.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, k as MediaTimeline, 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, a6 as SequenceSlotGroup, a7 as Stimulus, a8 as StimulusKind, a9 as StimulusSchema, aa as TextMatchPolicySchema, ab as TimelineChapter, ac as TimelineChapterSchema, ad as TimelineCue, 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-G_KusUcK.js';
+import { a5 as SequenceSlot, a4 as SequenceEntry, I as ItemGroup, i as MediaProgress } from './index-DMCM3e3P.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, k as MediaTimeline, 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, a6 as SequenceSlotGroup, a7 as Stimulus, a8 as StimulusKind, a9 as StimulusSchema, aa as TextMatchPolicySchema, ab as TimelineChapter, ac as TimelineChapterSchema, ad as TimelineCue, 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-DMCM3e3P.js';
 import { z } from 'zod/v4';
 export { AnsweredStatementParams, CompletedStatementParams, SubmittedStatementParams, XAPIObjectParams, XAPIStatementParams, XAPIVerb, XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor } from './xapi.js';
 
@@ -45,11 +45,15 @@ declare function aiGradeOf(result: {
 declare function buildAiFacts(data: AiActivityInput, response: LearnerResponse | null, details: readonly ScoringDetail[] | null): AiItemFacts | null;
 /**
  * The request for an explanation of `response`, or `null` when there is none
- * to give: an unsupported type, an author who switched explanations off, or
- * nothing graded to explain.
+ * to give: an unsupported type, an author who switched explanations off,
+ * nothing graded to explain, or a grade of record that cannot be a grade.
  *
  * A scored `outcome` — the grade of record a review shows — wins over grading
- * locally, so the explanation speaks to the grade on the screen.
+ * locally, so the explanation speaks to the grade on the screen. One whose
+ * numbers cannot be a grade (the rule `outcomeFromGrade` applies: `maxScore`
+ * positive and finite, `score` finite from 0 to it) gets no explanation at all:
+ * explaining 85 "out of 1" would tell the model a wrong answer was correct, and
+ * grading locally instead would speak to a grade the screen does not show.
  */
 declare function aiExplanationRequest(input: {
     data: AiActivityInput;
@@ -743,10 +747,12 @@ interface GradeFromRubricOptions {
  * total a pure function of the judgements, so a grade can be recomputed and
  * audited years later.
  *
- * Weights are normalised by their sum, so they need not add to 1. Criteria
- * marked `notApplicable`, and those carrying no numeric `score` (a purely
- * banded judgement), are excluded from both numerator and denominator. When
- * nothing scoreable remains the result is `unscorable`, never a zero.
+ * Weights are normalised by their sum, so they need not add to 1; each must be
+ * zero or more, and their sum a positive, finite number, or the result is
+ * `unscorable`. Criteria marked `notApplicable`, and those carrying no numeric
+ * `score` (a purely banded judgement), are excluded from both numerator and
+ * denominator, weight included. When nothing scoreable remains the result is
+ * `unscorable`, never a zero.
  *
  * Scores need not be in [0,1]: set `maxScore` on a criterion to declare what
  * its score is out of, and each is normalised before weighting. A grader
@@ -771,6 +777,19 @@ declare function gradeFromRubric(criteria: readonly CriterionScore[], activityDa
  * a grade that arrived asynchronously renders through the same path as a
  * synchronously scored item. The score/passed/feedback fields are mirrored
  * onto the outcome for uniform reads; `grade` carries the full record.
+ *
+ * A record whose numbers cannot be a grade is refused, as `evaluate` refuses a
+ * non-finite score and {@link gradeFromRubric} one outside [0,1]. `maxScore`
+ * must be a positive, finite number and `score` a finite number from 0 to it (a
+ * hair above, one part in a billion, is float noise and passes as it is).
+ * Anything else — NaN, 85 "out of 1", a score out of 0 — comes back as
+ * `{ status: 'deferred', reason: 'grade_rejected', maxScore: 1, rejectedGrade }`
+ * with the record kept verbatim. Not `graded`, or its `passed` would be read as
+ * a verdict; not `unscorable`, which `composeAssessmentScore` drops from the
+ * denominator while letting the attempt go final — so a failing grade on the
+ * wrong scale would vanish and the rest would be recorded as a pass. Deferred
+ * is what it is: the slot is still owed a real grade, so a composed attempt
+ * stays `provisional` and names the slot in `rejectedSlotIds`.
  */
 declare function outcomeFromGrade(grade: GradeRecord): ItemOutcome;
 /**

package/dist/index.js

@@ -1,22 +1,3 @@
-import {
-  DEFAULT_PASS_THRESHOLD,
-  alignReadAloud,
-  classifyBand,
-  composeAssessmentScore,
-  computePassThreshold,
-  diffDictationChars,
-  evaluate,
-  gradeFromRubric,
-  gradeReadAloud,
-  gte,
-  hasGrade,
-  inspectWav,
-  outcomeFromGrade,
-  outcomeFromUnscorable,
-  roundGrade,
-  score,
-  validateSpeechAssessment
-} from "./chunk-WXS5EB65.js";
 import {
   XAPIVerb,
   XAPI_VERB_DISPLAY,
@@ -50,6 +31,40 @@ import {
   validateItemGroup,
   writtenResponseJsonSchema
 } from "./chunk-Z7QQZ53L.js";
+import {
+  AI_EXPLANATION_TYPES,
+  AI_HINT_TYPES,
+  AI_TEXT_MAX_LENGTH,
+  aiAllowedByContent,
+  aiExplanationRequest,
+  aiGradeOf,
+  aiHintRequest,
+  aiSupports,
+  buildAiFacts,
+  checkAiExplanation,
+  checkAiHint,
+  hintRevealsAnswer,
+  readAiTextResult
+} from "./chunk-BIJCO2HM.js";
+import {
+  DEFAULT_PASS_THRESHOLD,
+  alignReadAloud,
+  classifyBand,
+  composeAssessmentScore,
+  computePassThreshold,
+  diffDictationChars,
+  evaluate,
+  gradeFromRubric,
+  gradeReadAloud,
+  gte,
+  hasGrade,
+  inspectWav,
+  outcomeFromGrade,
+  outcomeFromUnscorable,
+  roundGrade,
+  score,
+  validateSpeechAssessment
+} from "./chunk-MMEQKFFQ.js";
 import {
   ActivitySchemaError,
   AiPermissionsSchema,
@@ -81,7 +96,6 @@ import {
   MultipleChoiceOptionMediaSchema,
   MultipleChoiceOptionSchema,
   NativeControlHintSchema,
-  PLACEHOLDER_RE,
   READ_ALOUD_MAX_DIMENSION_WEIGHT,
   READ_ALOUD_MAX_REFERENCE_LENGTH,
   READ_ALOUD_MAX_SECONDS,
@@ -138,405 +152,6 @@ import {
   writtenResponseType
 } from "./chunk-D3GP5MET.js";
 
-// src/ai.ts
-var AI_EXPLANATION_TYPES = [
-  "multiple-choice",
-  "fill-in-the-blanks",
-  "gap-select",
-  "dictation"
-];
-var AI_HINT_TYPES = [
-  "multiple-choice",
-  "fill-in-the-blanks",
-  "gap-select"
-];
-var AI_TEXT_MAX_LENGTH = 2e3;
-function aiSupports(activityType, feature) {
-  const types = feature === "hint" ? AI_HINT_TYPES : AI_EXPLANATION_TYPES;
-  return types.includes(activityType);
-}
-function aiAllowedByContent(data, feature) {
-  const permissions = data.ai;
-  if (typeof permissions !== "object" || permissions === null) {
-    return true;
-  }
-  const key = feature === "hint" ? "hints" : "explanations";
-  return permissions[key] !== false;
-}
-function aiGradeOf(result) {
-  const ratio = result.maxScore > 0 ? result.score / result.maxScore : 0;
-  let category = "partly-correct";
-  if (ratio >= 1 - 1e-9) {
-    category = "correct";
-  } else if (ratio <= 1e-9) {
-    category = "incorrect";
-  }
-  return { score: result.score, maxScore: result.maxScore, passed: result.passed, category };
-}
-function placeholderOrder(passage) {
-  return [...passage.matchAll(PLACEHOLDER_RE)].map((match) => match[1]);
-}
-function numberedPassage(passage) {
-  let position = 0;
-  return passage.replace(PLACEHOLDER_RE, () => {
-    position += 1;
-    return `[${position}]`;
-  });
-}
-function isAnswerOption(detail, chosen) {
-  switch (detail.outcome) {
-    case "correct":
-    case "incorrect-omission":
-      return true;
-    case "incorrect":
-    case "correct-omission":
-      return false;
-    default:
-      return chosen ? detail.correct : !detail.correct;
-  }
-}
-var firstString = (value) => Array.isArray(value) ? value[0] : value;
-var listOf = (value) => value === void 0 ? null : Array.isArray(value) ? [...value] : [value];
-function emptyResponse(type) {
-  switch (type) {
-    case "multiple-choice":
-      return { type: "multiple-choice", selectedOptionIds: [] };
-    case "fill-in-the-blanks":
-      return { type: "fill-in-the-blanks", answers: {} };
-    case "gap-select":
-      return { type: "gap-select", selections: {} };
-    case "dictation":
-      return { type: "dictation", text: "" };
-    default:
-      return null;
-  }
-}
-var base = (data) => ({
-  activityId: data.id,
-  title: data.title,
-  ...typeof data.locale === "string" ? { locale: data.locale } : {}
-});
-function buildAiFacts(data, response, details) {
-  const byId = new Map((details ?? []).map((detail) => [detail.itemId, detail]));
-  const full = data.redacted !== true;
-  switch (data.type) {
-    case "multiple-choice": {
-      const item = data;
-      const chosen = new Set(
-        response?.type === "multiple-choice" ? response.selectedOptionIds : []
-      );
-      return {
-        ...base(data),
-        activityType: "multiple-choice",
-        question: item.question,
-        mode: item.mode,
-        options: item.options.map((option) => {
-          const detail = byId.get(option.id);
-          const wasChosen = chosen.has(option.id);
-          let correct = null;
-          if (full && typeof option.isCorrect === "boolean") {
-            correct = option.isCorrect;
-          } else if (detail !== void 0) {
-            correct = isAnswerOption(detail, wasChosen);
-          }
-          return {
-            id: option.id,
-            text: option.text,
-            chosen: wasChosen,
-            correct,
-            ...typeof option.feedback === "string" ? { feedback: option.feedback } : {}
-          };
-        })
-      };
-    }
-    case "fill-in-the-blanks": {
-      const item = data;
-      const answers = response?.type === "fill-in-the-blanks" ? response.answers : {};
-      const blanks = new Map(item.blanks.map((blank) => [blank.id, blank]));
-      return {
-        ...base(data),
-        activityType: "fill-in-the-blanks",
-        passage: numberedPassage(item.passage),
-        blanks: placeholderOrder(item.passage).map((id, index) => {
-          const blank = blanks.get(id);
-          const detail = byId.get(id);
-          const accepted = full && Array.isArray(blank?.acceptedAnswers) ? [...blank.acceptedAnswers] : listOf(detail?.correctResponse);
-          return {
-            id,
-            position: index + 1,
-            typed: typeof answers[id] === "string" ? answers[id] : "",
-            accepted,
-            correct: detail === void 0 ? null : detail.correct,
-            ...typeof blank?.hint === "string" ? { hint: blank.hint } : {},
-            ...typeof blank?.feedback === "string" ? { feedback: blank.feedback } : {}
-          };
-        })
-      };
-    }
-    case "gap-select": {
-      const item = data;
-      const selections = response?.type === "gap-select" ? response.selections : {};
-      const gaps = new Map(item.gaps.map((gap) => [gap.id, gap]));
-      const banks = new Map((item.banks ?? []).map((bank) => [bank.id, bank]));
-      return {
-        ...base(data),
-        activityType: "gap-select",
-        passage: numberedPassage(item.passage),
-        gaps: placeholderOrder(item.passage).map((id, index) => {
-          const gap = gaps.get(id);
-          const choices = gap?.choices ?? (gap?.bankId === void 0 ? [] : banks.get(gap.bankId)?.choices ?? []);
-          const textOf = (choiceId) => choiceId === void 0 ? null : choices.find((choice) => choice.id === choiceId)?.text ?? null;
-          const detail = byId.get(id);
-          const answerId = full && typeof gap?.correctChoiceId === "string" ? gap.correctChoiceId : firstString(detail?.correctResponse);
-          return {
-            id,
-            position: index + 1,
-            choices: choices.map((choice) => choice.text),
-            chosen: textOf(selections[id]),
-            answer: textOf(answerId),
-            correct: detail === void 0 ? null : detail.correct,
-            ...typeof gap?.feedback === "string" ? { feedback: gap.feedback } : {}
-          };
-        })
-      };
-    }
-    case "dictation": {
-      const item = data;
-      const typed = response?.type === "dictation" ? response.text : "";
-      const hasKey = full && typeof item.transcript === "string";
-      let words = null;
-      if (hasKey) {
-        words = alignDictation(item, typed).words.map((word) => ({
-          expected: word.reference,
-          typed: word.attempt,
-          status: word.status
-        }));
-      } else if (details !== null && details.length > 0) {
-        words = details.map((detail) => {
-          const expected = firstString(detail.correctResponse) ?? "";
-          const attempt = firstString(detail.learnerResponse) ?? "";
-          let status = "incorrect";
-          if (detail.correct) {
-            status = "correct";
-          } else if (attempt === "") {
-            status = "missing";
-          } else if (expected === "") {
-            status = "extra";
-          }
-          return { expected, typed: attempt, status };
-        });
-      }
-      return {
-        ...base(data),
-        activityType: "dictation",
-        transcript: hasKey ? item.transcript : null,
-        typed,
-        words
-      };
-    }
-    default:
-      return null;
-  }
-}
-function gradeLocally(data, response) {
-  if (data.redacted === true) {
-    return null;
-  }
-  try {
-    const result = score(data.type, data, response);
-    return { details: result.details, grade: aiGradeOf(result) };
-  } catch {
-    return null;
-  }
-}
-function aiExplanationRequest(input) {
-  const { data, response, outcome, learnerLocale } = input;
-  if (!aiSupports(data.type, "explanation") || !aiAllowedByContent(data, "explanation")) {
-    return null;
-  }
-  let details = null;
-  let grade = null;
-  if (outcome?.status === "scored") {
-    details = outcome.details;
-    grade = aiGradeOf(outcome);
-  } else if (response !== null) {
-    const local = gradeLocally(data, response);
-    if (local !== null) {
-      details = local.details;
-      grade = local.grade;
-    }
-  }
-  if (grade === null) {
-    return null;
-  }
-  const facts = buildAiFacts(data, response, details);
-  if (facts === null) {
-    return null;
-  }
-  return {
-    feature: "explanation",
-    facts,
-    grade,
-    ...learnerLocale !== void 0 ? { learnerLocale } : {}
-  };
-}
-function aiHintRequest(input) {
-  const { data, previousHints, learnerLocale } = input;
-  if (!aiSupports(data.type, "hint") || !aiAllowedByContent(data, "hint") || data.redacted === true) {
-    return null;
-  }
-  const response = input.response ?? emptyResponse(data.type);
-  const local = response === null ? null : gradeLocally(data, response);
-  const facts = buildAiFacts(data, response, local?.details ?? null);
-  if (facts === null) {
-    return null;
-  }
-  return {
-    feature: "hint",
-    facts,
-    hintNumber: previousHints.length + 1,
-    previousHints: [...previousHints],
-    ...learnerLocale !== void 0 ? { learnerLocale } : {}
-  };
-}
-var VERDICTS = ["correct", "partly-correct", "incorrect"];
-function provenanceOf(raw) {
-  if (typeof raw !== "object" || raw === null) {
-    return void 0;
-  }
-  const kept = {};
-  for (const key of ["model", "promptHash", "generatedAt"]) {
-    const value = raw[key];
-    if (typeof value === "string" && value.length > 0 && value.length <= 200) {
-      kept[key] = value;
-    }
-  }
-  return Object.keys(kept).length > 0 ? kept : void 0;
-}
-function cleanText(text) {
-  return text.replace(/\r\n?/g, "\n").replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F\u2028\u2029]/g, "").replace(/\n{3,}/g, "\n\n").trim();
-}
-function readAiTextResult(raw) {
-  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    return { ok: false, refusal: "malformed" };
-  }
-  const record = raw;
-  if (typeof record.text !== "string") {
-    return { ok: false, refusal: "malformed" };
-  }
-  if (record.verdict !== void 0 && !VERDICTS.includes(record.verdict)) {
-    return { ok: false, refusal: "malformed" };
-  }
-  const text = cleanText(record.text);
-  if (text === "") {
-    return { ok: false, refusal: "empty" };
-  }
-  if ([...text].length > AI_TEXT_MAX_LENGTH) {
-    return { ok: false, refusal: "too-long" };
-  }
-  const provenance = provenanceOf(record.provenance);
-  return {
-    ok: true,
-    result: {
-      text,
-      ...record.verdict !== void 0 ? { verdict: record.verdict } : {},
-      ...provenance !== void 0 ? { provenance } : {}
-    }
-  };
-}
-function checkAiExplanation(raw, request) {
-  const read = readAiTextResult(raw);
-  if (!read.ok) {
-    return read;
-  }
-  if (read.result.verdict !== void 0 && read.result.verdict !== request.grade.category) {
-    return { ok: false, refusal: "contradicts-grade" };
-  }
-  return read;
-}
-function checkAiHint(raw, request) {
-  const read = readAiTextResult(raw);
-  if (!read.ok) {
-    return read;
-  }
-  if (hintRevealsAnswer(request.facts, read.result.text)) {
-    return { ok: false, refusal: "reveals-answer" };
-  }
-  return read;
-}
-function fold(text) {
-  const folded = text.normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
-  return folded === "" ? [] : folded.split(" ");
-}
-function containsWords(haystack, needle) {
-  if (needle.length === 0 || needle.length > haystack.length) {
-    return false;
-  }
-  for (let start = 0; start + needle.length <= haystack.length; start += 1) {
-    let match = true;
-    for (let offset = 0; offset < needle.length; offset += 1) {
-      if (haystack[start + offset] !== needle[offset]) {
-        match = false;
-        break;
-      }
-    }
-    if (match) {
-      return true;
-    }
-  }
-  return false;
-}
-var isShort = (words) => words.length === 1 && [...words[0]].length < 4;
-function neighbours(passage, position) {
-  const marker = `[${position}]`;
-  const at = passage.indexOf(marker);
-  if (at === -1) {
-    return {};
-  }
-  const strip = (text) => text.replace(/\[\d+\]/g, " ");
-  const left = fold(strip(passage.slice(0, at)));
-  const right = fold(strip(passage.slice(at + marker.length)));
-  const before = left[left.length - 1];
-  const after = right[0];
-  return {
-    ...before !== void 0 ? { before } : {},
-    ...after !== void 0 ? { after } : {}
-  };
-}
-function hintRevealsAnswer(facts, hint) {
-  const words = fold(hint);
-  const reveals = (answer, passage, position) => {
-    const needle = fold(answer);
-    if (needle.length === 0) {
-      return false;
-    }
-    if (!isShort(needle) || passage === void 0 || position === void 0) {
-      return containsWords(words, needle);
-    }
-    const { before, after } = neighbours(passage, position);
-    if (before === void 0 && after === void 0) {
-      return containsWords(words, needle);
-    }
-    return before !== void 0 && containsWords(words, [before, ...needle]) || after !== void 0 && containsWords(words, [...needle, after]);
-  };
-  switch (facts.activityType) {
-    case "multiple-choice":
-      return facts.options.some((option) => option.correct === true && reveals(option.text));
-    case "fill-in-the-blanks":
-      return facts.blanks.some(
-        (blank) => (blank.accepted ?? []).some((answer) => reveals(answer, facts.passage, blank.position))
-      );
-    case "gap-select":
-      return facts.gaps.some(
-        (gap) => gap.answer !== null && reveals(gap.answer, facts.passage, gap.position)
-      );
-    case "dictation":
-      return false;
-    default:
-      return false;
-  }
-}
-
 // src/content-hash.ts
 function canonicalJson(value, seen = /* @__PURE__ */ new Set()) {
   if (value === null) {
@@ -1620,11 +1235,11 @@ function normalise(found) {
 }
 
 // src/redact.ts
-function mergePolicy(base2, overrides) {
+function mergePolicy(base, overrides) {
   if (overrides === void 0) {
-    return base2;
+    return base;
   }
-  const merged = { ...base2 };
+  const merged = { ...base };
   for (const [key, override] of Object.entries(overrides)) {
     const current = merged[key];
     merged[key] = typeof override === "object" && typeof current === "object" ? { ...current, ...override } : override;