@intellectif/lk-core 0.21.0 → 1.0.0

package/dist/index.d.cts

@@ -1,10 +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-xhGV-Aeh.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-xhGV-Aeh.cjs';
+import { x as AiSupportedActivityType, g as AiActivityInput, l as AiFeature, a4 as LearnerResponse, a3 as ItemOutcome, k as AiExplanationRequest, p as AiGrade, q as AiHintRequest, ak as ScoringDetail, r as AiItemFacts, y as AiTextResult, v as AiRefusal, F as AiWritingFeedbackRequest, E as AiWritingFeedback, a as ActivityData, ap as ValidationError, f as ActivityType, b as ActivityDataMap, I as CriterionScore, X as GradeRecord, ac as NativeControlHint, d as ActivityMedia, am as ScoringResult, K as DeferredScoringPartial, L as DictationData, N as DictationLearnerResponse, Q as FillInTheBlanksData, R as FillInTheBlanksLearnerResponse, U as GapSelectData, W as GapSelectLearnerResponse, a8 as MultipleChoiceData, a9 as MultipleChoiceLearnerResponse, ad as ReadAloudData, ag as ReadAloudLearnerResponse, ar as WrittenResponseData, as as WrittenResponseLearnerResponse } from './activity-DgpBJeBc.cjs';
+export { A as ActivityAiPermissions, c as ActivityFeedback, e as ActivityResult, h as AiBlankFact, i as AiCriterionJudgement, j as AiDictationFacts, m as AiFillInTheBlanksFacts, n as AiGapFact, o as AiGapSelectFacts, s as AiMultipleChoiceFacts, t as AiOptionFact, u as AiProvenance, w as AiRubricCriterionFact, z as AiVerdict, B as AiWordFact, C as AiWritingCorrection, D as AiWritingFacts, G as AiWritingFeedbackResult, H as BlankConfig, J as DeferredReason, M as DictationEquivalence, O as DictationSlowMedia, P as DictationTolerance, S as GapSelectBank, T as GapSelectChoice, V as GapSelectGap, Y as Grader, Z as GraderKind, _ as GraderUsage, $ as GradingState, a0 as InlineCorrection, a1 as InteractionEvent, a2 as InteractionKind, a5 as LearnerResponseMap, a6 as MediaPlaybackPolicy, a7 as MediaTrack, aa as MultipleChoiceOption, ab as MultipleChoiceOptionMedia, ae as ReadAloudDimension, af as ReadAloudDimensionWeight, ah as ReadAloudSlowMedia, ai as RecordingBounds, aj as RecordingRef, al as ScoringOutcome, an as TextMatchPolicy, ao as TextMatchResult, aq as ValidationResult, at as WrittenResponseRubric, au as WrittenResponseRubricCriterion, av as XAPIActor, aw as XAPIConfig, ax as XAPIContext, ay as XAPIContextActivities, az as XAPIError, aA as XAPIObject, aB as XAPIResult, aC as XAPIScore, aD as XAPIStatement, aE as XAPIVerbObject, aF as levenshteinDistance, aG as matchText } from './activity-DgpBJeBc.cjs';
 import { ResolvedItemScoringPolicy, ItemScoringPolicy, ScoredItem, RoundingPolicy, CompositionPolicy, AssessmentScore } from './scoring.cjs';
 export { AssessmentSectionInput, Band, 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, DictationAlignment, DictationCharOp, DictationReference, DictationWordAlignment, EvaluateOptions, GradeReadAloudOptions, ITEM_SCORING_MAX_RETRIES, ItemScoringCount, ItemScoringPolicyIssue, ItemTriesOutcome, ItemTriesScore, ItemTry, ItemTryScore, 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, evaluateTries, gradeReadAloud, gte, inspectWav, outcomeFromUnscorable, resolveItemScoringPolicy, roundGrade, score, scoreTries, validateItemScoringPolicy, validateSpeechAssessment } from './scoring.cjs';
-import { a5 as SequenceSlot, a4 as SequenceEntry, I as ItemGroup, i as MediaProgress } from './index-BuD8Hc8o.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-BuD8Hc8o.cjs';
-import { z } from 'zod/v4';
+import { p as SequenceSlot, S as SequenceEntry, I as ItemGroup, M as MediaProgress } from './index-BlOLlwOi.cjs';
+export { a as MediaTimeline, R as RedactedActivity, b as RedactedBlankConfig, c as RedactedDictationData, d as RedactedDictationSlowMedia, e as RedactedFillInTheBlanksData, f as RedactedGapSelectBank, g as RedactedGapSelectChoice, h as RedactedGapSelectData, i as RedactedGapSelectGap, j as RedactedMultipleChoiceData, k as RedactedMultipleChoiceOption, l as RedactedMultipleChoiceOptionMedia, m as RedactedReadAloudData, n as RedactedStimulus, o as RedactedWrittenResponseData, q as SequenceSlotGroup, r as Stimulus, s as StimulusKind, T as TimelineChapter, t as TimelineCue, u as dictationJsonSchema, v as fillInTheBlanksJsonSchema, w as gapSelectJsonSchema, x as itemGroupJsonSchema, y as jsonSchemaFor, z as multipleChoiceJsonSchema, A as readAloudJsonSchema, B as stimulusJsonSchema, C as validateActivity, D as validateItemGroup, E as validateMedia, F as validateOptionMedia, G as writtenResponseJsonSchema } from './index-BlOLlwOi.cjs';
 export { AnsweredStatementParams, CompletedStatementParams, SubmittedStatementParams, XAPIObjectParams, XAPIStatementParams, XAPIVerb, XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor } from './xapi.cjs';
 
 /**
@@ -17,14 +16,18 @@ declare const AI_HINT_TYPES: readonly AiSupportedActivityType[];
 /** The longest AI text shown, in code points. Longer is refused, not cut. */
 declare const AI_TEXT_MAX_LENGTH = 2000;
 /**
- * Whether the SDK supports `feature` for this activity type. A type it builds
- * no facts for — a written response, a read-aloud, a consumer's own — has
- * neither.
+ * Whether the SDK supports `feature` for this activity type: explanations and
+ * hints for the types it builds facts for, and writing feedback for a written
+ * response. A read-aloud, or a consumer's own type, has none.
  */
 declare function aiSupports(activityType: string, feature: AiFeature): boolean;
 /**
  * Whether the item's author allows `feature`. Only an explicit `false`
  * switches it off: an author can refuse a feature, never force one on.
+ *
+ * Writing feedback reads `explanations`: both are a model's words about the
+ * learner's own answer, and an author who switched one off has switched off
+ * the other.
  */
 declare function aiAllowedByContent(data: AiActivityInput, feature: AiFeature): boolean;
 /** A grade as an explanation must speak to it: all marks, some, or none. */
@@ -128,6 +131,59 @@ declare function checkAiHint(raw: unknown, request: AiHintRequest): {
  */
 declare function hintRevealsAnswer(facts: AiItemFacts, hint: string): boolean;
 
+/** The most corrections one piece of writing feedback may carry. More is refused, not cut. */
+declare const AI_WRITING_MAX_CORRECTIONS = 20;
+/** The longest quote, correction, explanation or criterion comment, in code points. */
+declare const AI_WRITING_MAX_FIELD_LENGTH = 500;
+/**
+ * The request for feedback on a draft, or `null` when there is none to give:
+ * not a written response, an author who switched explanations off (writing
+ * feedback reads `ai.explanations`), a redacted item — feedback is for
+ * practice, where the item is whole — or a draft with nothing in it.
+ *
+ * The facts are the task as the learner saw it, the draft verbatim with its
+ * word count recomputed as the grader will count it, and the rubric the answer
+ * will be graded on. `previousFeedback` is the text of the feedback already
+ * shown on earlier drafts, so a model can speak to what changed.
+ */
+declare function aiWritingFeedbackRequest(input: {
+    data: AiActivityInput;
+    response: LearnerResponse | null;
+    previousFeedback?: readonly string[];
+    learnerLocale?: string;
+}): AiWritingFeedbackRequest | null;
+/**
+ * Checks writing feedback a port returned for `request`, and turns it into what
+ * a learner is shown. The SDK shows a model's feedback whole or not at all: it
+ * never drops the part it doubts and shows the rest.
+ *
+ * - **The text** is read as every AI text is (`readAiTextResult`): plain text,
+ *   not empty, at most {@link AI_TEXT_MAX_LENGTH} code points.
+ * - **Every correction must quote the draft** — the check only this SDK can run.
+ *   The SDK finds each quote in the draft itself, typographic quotes and runs of
+ *   whitespace aside, and anchors it there; a range the model claims must hold
+ *   the quote. A correction of words the learner did not write refuses the
+ *   whole reply as `misquotes-answer`, as a hint that gives the answer away
+ *   refuses the hint. The `original` shown is the draft's own text at the range.
+ *   At most {@link AI_WRITING_MAX_CORRECTIONS}; a correction that changes
+ *   nothing is `malformed`.
+ * - **Criteria are judgements; the arithmetic is the SDK's.** Each names a
+ *   criterion of the item's rubric, once; its score, when it has one, is a
+ *   score out of its `maxScore`. The rubric's weights are attached, whatever
+ *   the model sent. Anything else is `malformed`, as is any criterion on an
+ *   item with no rubric.
+ * - **`indicativeScore`** is the rubric's weighted total, computed as
+ *   `gradeFromRubric` computes a grade, when every criterion of the rubric was
+ *   judged; `null` otherwise. An indication, never a grade.
+ */
+declare function checkAiWritingFeedback(raw: unknown, request: AiWritingFeedbackRequest): {
+    ok: true;
+    feedback: AiWritingFeedback;
+} | {
+    ok: false;
+    refusal: AiRefusal;
+};
+
 /**
  * How a paper is delivered: what a learner is shown around the questions, as
  * the school running it decides — separately from the content, so that one
@@ -1160,6 +1216,80 @@ declare function serializeMediaPlayLedger(plan: AttemptPlan, entries: Readonly<R
  */
 declare function restoreMediaPlayLedger(plan: AttemptPlan, stored: MediaPlayLedger): MediaPlayLedger;
 
+/**
+ * Standard Schema v1 (https://standardschema.dev): the interface zod, valibot,
+ * ArkType and other validators implement, so a library can accept a schema from
+ * any of them without depending on one. Copied here, as the specification asks
+ * a library to do, so lk-core depends on no validator's types.
+ *
+ * A registered activity type's `schema` and `redactedSchema` are Standard
+ * Schemas. A zod 4 schema is one as written: `schema: z.object({ … })` needs no
+ * adapter.
+ */
+/** A schema that validates unknown input and produces `Output`. */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+    /** The Standard Schema properties. */
+    readonly '~standard': StandardSchemaV1.Props<Input, Output>;
+}
+declare namespace StandardSchemaV1 {
+    /** The Standard Schema properties interface. */
+    interface Props<Input = unknown, Output = Input> {
+        /** The version number of the standard. */
+        readonly version: 1;
+        /** The vendor name of the schema library. */
+        readonly vendor: string;
+        /**
+         * Validates unknown input values. lk-core validates synchronously, so a
+         * schema whose validation returns a Promise is refused when it is read.
+         */
+        readonly validate: (value: unknown, options?: StandardSchemaV1.Options | undefined) => Result<Output> | Promise<Result<Output>>;
+        /** Inferred types associated with the schema. */
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    /** The result interface of the validate function. */
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    /** The result interface if validation succeeds. */
+    interface SuccessResult<Output> {
+        /** The typed output value. */
+        readonly value: Output;
+        /** The absence of issues indicates success. */
+        readonly issues?: undefined;
+    }
+    /** Options for the validate function. */
+    interface Options {
+        /** Implicit support for additional vendor-specific parameters, if needed. */
+        readonly libraryOptions?: Record<string, unknown> | undefined;
+    }
+    /** The result interface if validation fails. */
+    interface FailureResult {
+        /** The issues of failed validation. */
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    /** The issue interface of the failure output. */
+    interface Issue {
+        /** The error message of the issue. */
+        readonly message: string;
+        /** The path of the issue, if any. */
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    /** The path segment interface of the issue. */
+    interface PathSegment {
+        /** The key representing a path segment. */
+        readonly key: PropertyKey;
+    }
+    /** The Standard Schema types interface. */
+    interface Types<Input = unknown, Output = Input> {
+        /** The input type of the schema. */
+        readonly input: Input;
+        /** The output type of the schema. */
+        readonly output: Output;
+    }
+    /** Infers the input type of a Standard Schema. */
+    type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
+    /** Infers the output type of a Standard Schema. */
+    type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
+}
+
 /** ScoringResult without `passed` — the public `score()` / `evaluate()` fill that in. */
 type PartialScoringResult = Omit<ScoringResult, 'passed'>;
 /**
@@ -1237,8 +1367,9 @@ interface ActivityTypeAuthoring<TData> {
      * length included, so report a rule about a whole list at the list's own path.
      * A failure at the root of the draft is accounted for only by an issue at the
      * root. A `null` the schema refuses, where nothing here reports it, comes back
-     * as `null_not_allowed` — except inside a plain `z.union`, which reports a
-     * failure once, at the union's own path, under its own code.
+     * as `null_not_allowed`. A zod 4 schema tells a refused `null` from a rule of
+     * yours that merely points at one, which keeps its own code; a schema from
+     * another library cannot, so report such a rule here, at its path.
      *
      * A code documented in `docs/authoring.md` is reported with its documented
      * severity. For a code of your own, a severity other than `'incomplete'` is
@@ -1252,14 +1383,38 @@ interface ActivityTypeAuthoring<TData> {
  * descriptor makes `validateActivity`, `validateDraft`, `score`, `evaluate`,
  * `redact`, and `jsonSchemaFor` work for the type — an activity type is a value,
  * not a hardcoded union member (R1).
+ *
+ * Its schemas are Standard Schemas ({@link StandardSchemaV1}), so they can be
+ * written with any library that implements the standard — a zod 4 schema is
+ * one as it stands:
+ *
+ * ```ts
+ * const pollType = defineActivityType<PollData, PollResponse>({
+ *   type: 'poll',
+ *   schema: z.looseObject({ type: z.literal('poll'), id: z.string(), … }),
+ *   scoring: { kind: 'sync', score: scorePoll },
+ * });
+ * registerActivityType(pollType);
+ * ```
  */
 interface ActivityTypeDescriptor<TData extends {
     type: string;
 }, TResponse> {
     /** The `type` discriminator string (kebab-case by convention). */
     readonly type: TData['type'];
-    /** Zod schema validating the activity's data contract. */
-    readonly schema: z.ZodType<TData>;
+    /**
+     * The activity's data contract, as a Standard Schema whose output is the
+     * data. Its validation must be synchronous: every entry point that reads it
+     * is.
+     */
+    readonly schema: StandardSchemaV1<unknown, TData>;
+    /**
+     * The contract as JSON Schema, for `jsonSchemaFor`. Leave it out when
+     * `schema` can produce one itself through the Standard JSON Schema converter
+     * (`'~standard'.jsonSchema`), as a zod 4.6 schema can; give it to override
+     * that, or for a library that cannot.
+     */
+    readonly jsonSchema?: Readonly<Record<string, unknown>>;
     /** How responses are graded. */
     readonly scoring: ActivityTypeScoring<TData, TResponse>;
     /** Whether a response counts as an answer (vs. blank/untouched). */
@@ -1268,10 +1423,11 @@ interface ActivityTypeDescriptor<TData extends {
     readonly fieldPolicy?: FieldPolicy;
     /**
      * Schema the output of `redact(data)` (with default `reveal: 'none'`) must
-     * satisfy. Strict by design: it proves the ABSENCE of answer-key fields,
-     * so `assertRedacted` can guarantee a payload is safe to send to a learner.
+     * satisfy, as a Standard Schema. Strict by design: it proves the ABSENCE of
+     * answer-key fields, so `assertRedacted` can guarantee a payload is safe to
+     * send to a learner.
      */
-    readonly redactedSchema?: z.ZodType<unknown>;
+    readonly redactedSchema?: StandardSchemaV1;
     /** Interop facts for xAPI (and later QTI) statement building. */
     readonly interop?: ActivityTypeInterop<TData>;
     /** The interaction-event kinds components for this type emit. */
@@ -1285,7 +1441,8 @@ interface ActivityTypeDescriptor<TData extends {
  */
 interface RegisteredActivityTypeDescriptor {
     readonly type: string;
-    readonly schema: z.ZodType<unknown>;
+    readonly schema: StandardSchemaV1;
+    readonly jsonSchema?: Readonly<Record<string, unknown>>;
     readonly scoring: {
         readonly kind: 'sync';
         readonly score: (data: unknown, response: unknown) => PartialScoringResult;
@@ -1296,7 +1453,7 @@ interface RegisteredActivityTypeDescriptor {
     };
     readonly isAnswered?: (response: unknown) => boolean;
     readonly fieldPolicy?: FieldPolicy;
-    readonly redactedSchema?: z.ZodType<unknown>;
+    readonly redactedSchema?: StandardSchemaV1;
     readonly interop?: ActivityTypeInterop<unknown>;
     readonly interactions?: readonly string[];
     readonly authoring?: ActivityTypeAuthoring<unknown>;
@@ -1638,4 +1795,4 @@ interface ThemeTokens {
     '--lk-transition-base': string;
 }
 
-export { AI_EXPLANATION_TYPES, AI_HINT_TYPES, AI_TEXT_MAX_LENGTH, ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, AiActivityInput, AiExplanationRequest, AiFeature, AiGrade, AiHintRequest, AiItemFacts, AiRefusal, AiSupportedActivityType, AiTextResult, AssessmentScore, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CompositionPolicy, CriterionScore, DeferredScoringError, DeferredScoringPartial, type DeliveryPolicy, type DeliveryPolicyIssue, 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, INTERACTIVE_VIDEO_ITEM_TYPES, type InteractiveVideoItemType, ItemGroup, ItemOutcome, ItemScoringPolicy, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, MediaProgress, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, OPEN_DELIVERY_POLICY, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, ReadAloudData, ReadAloudLearnerResponse, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedDeliveryPolicy, ResolvedItemScoringPolicy, type ResolvedPlaybackPolicy, type ResponseDiffEntry, RoundingPolicy, ScoredItem, ScoringDetail, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, TIMELINE_MAX_CHAPTERS, TIMELINE_MAX_ITEMS, TIMELINE_MAX_QUIZZES, TIMELINE_MAX_TITLE_LENGTH, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, aiAllowedByContent, aiExplanationRequest, aiGradeOf, aiHintRequest, aiSupports, assertRedacted, assertRedactedItemGroup, buildAiFacts, canonicalJson, checkAiExplanation, checkAiHint, combineDeliveryPolicies, composeTimelineScore, contentHash, countWords, createDraft, createInteractiveVideoDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, hintRevealsAnswer, isInteractiveVideoItemType, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, readAiTextResult, readAloudType, readMediaProgress, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolveDeliveryPolicy, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDeliveryPolicy, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };
+export { AI_EXPLANATION_TYPES, AI_HINT_TYPES, AI_TEXT_MAX_LENGTH, AI_WRITING_MAX_CORRECTIONS, AI_WRITING_MAX_FIELD_LENGTH, ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, AiActivityInput, AiExplanationRequest, AiFeature, AiGrade, AiHintRequest, AiItemFacts, AiRefusal, AiSupportedActivityType, AiTextResult, AiWritingFeedback, AiWritingFeedbackRequest, AssessmentScore, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CompositionPolicy, CriterionScore, DeferredScoringError, DeferredScoringPartial, type DeliveryPolicy, type DeliveryPolicyIssue, 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, INTERACTIVE_VIDEO_ITEM_TYPES, type InteractiveVideoItemType, ItemGroup, ItemOutcome, ItemScoringPolicy, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, MediaProgress, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, OPEN_DELIVERY_POLICY, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, ReadAloudData, ReadAloudLearnerResponse, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedDeliveryPolicy, ResolvedItemScoringPolicy, type ResolvedPlaybackPolicy, type ResponseDiffEntry, RoundingPolicy, ScoredItem, ScoringDetail, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, StandardSchemaV1, TIMELINE_MAX_CHAPTERS, TIMELINE_MAX_ITEMS, TIMELINE_MAX_QUIZZES, TIMELINE_MAX_TITLE_LENGTH, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, aiAllowedByContent, aiExplanationRequest, aiGradeOf, aiHintRequest, aiSupports, aiWritingFeedbackRequest, assertRedacted, assertRedactedItemGroup, buildAiFacts, canonicalJson, checkAiExplanation, checkAiHint, checkAiWritingFeedback, combineDeliveryPolicies, composeTimelineScore, contentHash, countWords, createDraft, createInteractiveVideoDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, hintRevealsAnswer, isInteractiveVideoItemType, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, readAiTextResult, readAloudType, readMediaProgress, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolveDeliveryPolicy, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDeliveryPolicy, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };

package/dist/index.d.ts

@@ -1,10 +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-xhGV-Aeh.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-xhGV-Aeh.js';
+import { x as AiSupportedActivityType, g as AiActivityInput, l as AiFeature, a4 as LearnerResponse, a3 as ItemOutcome, k as AiExplanationRequest, p as AiGrade, q as AiHintRequest, ak as ScoringDetail, r as AiItemFacts, y as AiTextResult, v as AiRefusal, F as AiWritingFeedbackRequest, E as AiWritingFeedback, a as ActivityData, ap as ValidationError, f as ActivityType, b as ActivityDataMap, I as CriterionScore, X as GradeRecord, ac as NativeControlHint, d as ActivityMedia, am as ScoringResult, K as DeferredScoringPartial, L as DictationData, N as DictationLearnerResponse, Q as FillInTheBlanksData, R as FillInTheBlanksLearnerResponse, U as GapSelectData, W as GapSelectLearnerResponse, a8 as MultipleChoiceData, a9 as MultipleChoiceLearnerResponse, ad as ReadAloudData, ag as ReadAloudLearnerResponse, ar as WrittenResponseData, as as WrittenResponseLearnerResponse } from './activity-DgpBJeBc.js';
+export { A as ActivityAiPermissions, c as ActivityFeedback, e as ActivityResult, h as AiBlankFact, i as AiCriterionJudgement, j as AiDictationFacts, m as AiFillInTheBlanksFacts, n as AiGapFact, o as AiGapSelectFacts, s as AiMultipleChoiceFacts, t as AiOptionFact, u as AiProvenance, w as AiRubricCriterionFact, z as AiVerdict, B as AiWordFact, C as AiWritingCorrection, D as AiWritingFacts, G as AiWritingFeedbackResult, H as BlankConfig, J as DeferredReason, M as DictationEquivalence, O as DictationSlowMedia, P as DictationTolerance, S as GapSelectBank, T as GapSelectChoice, V as GapSelectGap, Y as Grader, Z as GraderKind, _ as GraderUsage, $ as GradingState, a0 as InlineCorrection, a1 as InteractionEvent, a2 as InteractionKind, a5 as LearnerResponseMap, a6 as MediaPlaybackPolicy, a7 as MediaTrack, aa as MultipleChoiceOption, ab as MultipleChoiceOptionMedia, ae as ReadAloudDimension, af as ReadAloudDimensionWeight, ah as ReadAloudSlowMedia, ai as RecordingBounds, aj as RecordingRef, al as ScoringOutcome, an as TextMatchPolicy, ao as TextMatchResult, aq as ValidationResult, at as WrittenResponseRubric, au as WrittenResponseRubricCriterion, av as XAPIActor, aw as XAPIConfig, ax as XAPIContext, ay as XAPIContextActivities, az as XAPIError, aA as XAPIObject, aB as XAPIResult, aC as XAPIScore, aD as XAPIStatement, aE as XAPIVerbObject, aF as levenshteinDistance, aG as matchText } from './activity-DgpBJeBc.js';
 import { ResolvedItemScoringPolicy, ItemScoringPolicy, ScoredItem, RoundingPolicy, CompositionPolicy, AssessmentScore } from './scoring.js';
 export { AssessmentSectionInput, Band, 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, DictationAlignment, DictationCharOp, DictationReference, DictationWordAlignment, EvaluateOptions, GradeReadAloudOptions, ITEM_SCORING_MAX_RETRIES, ItemScoringCount, ItemScoringPolicyIssue, ItemTriesOutcome, ItemTriesScore, ItemTry, ItemTryScore, 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, evaluateTries, gradeReadAloud, gte, inspectWav, outcomeFromUnscorable, resolveItemScoringPolicy, roundGrade, score, scoreTries, validateItemScoringPolicy, validateSpeechAssessment } from './scoring.js';
-import { a5 as SequenceSlot, a4 as SequenceEntry, I as ItemGroup, i as MediaProgress } from './index-DnJ_PI4d.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-DnJ_PI4d.js';
-import { z } from 'zod/v4';
+import { p as SequenceSlot, S as SequenceEntry, I as ItemGroup, M as MediaProgress } from './index-BVNeSCWC.js';
+export { a as MediaTimeline, R as RedactedActivity, b as RedactedBlankConfig, c as RedactedDictationData, d as RedactedDictationSlowMedia, e as RedactedFillInTheBlanksData, f as RedactedGapSelectBank, g as RedactedGapSelectChoice, h as RedactedGapSelectData, i as RedactedGapSelectGap, j as RedactedMultipleChoiceData, k as RedactedMultipleChoiceOption, l as RedactedMultipleChoiceOptionMedia, m as RedactedReadAloudData, n as RedactedStimulus, o as RedactedWrittenResponseData, q as SequenceSlotGroup, r as Stimulus, s as StimulusKind, T as TimelineChapter, t as TimelineCue, u as dictationJsonSchema, v as fillInTheBlanksJsonSchema, w as gapSelectJsonSchema, x as itemGroupJsonSchema, y as jsonSchemaFor, z as multipleChoiceJsonSchema, A as readAloudJsonSchema, B as stimulusJsonSchema, C as validateActivity, D as validateItemGroup, E as validateMedia, F as validateOptionMedia, G as writtenResponseJsonSchema } from './index-BVNeSCWC.js';
 export { AnsweredStatementParams, CompletedStatementParams, SubmittedStatementParams, XAPIObjectParams, XAPIStatementParams, XAPIVerb, XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor } from './xapi.js';
 
 /**
@@ -17,14 +16,18 @@ declare const AI_HINT_TYPES: readonly AiSupportedActivityType[];
 /** The longest AI text shown, in code points. Longer is refused, not cut. */
 declare const AI_TEXT_MAX_LENGTH = 2000;
 /**
- * Whether the SDK supports `feature` for this activity type. A type it builds
- * no facts for — a written response, a read-aloud, a consumer's own — has
- * neither.
+ * Whether the SDK supports `feature` for this activity type: explanations and
+ * hints for the types it builds facts for, and writing feedback for a written
+ * response. A read-aloud, or a consumer's own type, has none.
  */
 declare function aiSupports(activityType: string, feature: AiFeature): boolean;
 /**
  * Whether the item's author allows `feature`. Only an explicit `false`
  * switches it off: an author can refuse a feature, never force one on.
+ *
+ * Writing feedback reads `explanations`: both are a model's words about the
+ * learner's own answer, and an author who switched one off has switched off
+ * the other.
  */
 declare function aiAllowedByContent(data: AiActivityInput, feature: AiFeature): boolean;
 /** A grade as an explanation must speak to it: all marks, some, or none. */
@@ -128,6 +131,59 @@ declare function checkAiHint(raw: unknown, request: AiHintRequest): {
  */
 declare function hintRevealsAnswer(facts: AiItemFacts, hint: string): boolean;
 
+/** The most corrections one piece of writing feedback may carry. More is refused, not cut. */
+declare const AI_WRITING_MAX_CORRECTIONS = 20;
+/** The longest quote, correction, explanation or criterion comment, in code points. */
+declare const AI_WRITING_MAX_FIELD_LENGTH = 500;
+/**
+ * The request for feedback on a draft, or `null` when there is none to give:
+ * not a written response, an author who switched explanations off (writing
+ * feedback reads `ai.explanations`), a redacted item — feedback is for
+ * practice, where the item is whole — or a draft with nothing in it.
+ *
+ * The facts are the task as the learner saw it, the draft verbatim with its
+ * word count recomputed as the grader will count it, and the rubric the answer
+ * will be graded on. `previousFeedback` is the text of the feedback already
+ * shown on earlier drafts, so a model can speak to what changed.
+ */
+declare function aiWritingFeedbackRequest(input: {
+    data: AiActivityInput;
+    response: LearnerResponse | null;
+    previousFeedback?: readonly string[];
+    learnerLocale?: string;
+}): AiWritingFeedbackRequest | null;
+/**
+ * Checks writing feedback a port returned for `request`, and turns it into what
+ * a learner is shown. The SDK shows a model's feedback whole or not at all: it
+ * never drops the part it doubts and shows the rest.
+ *
+ * - **The text** is read as every AI text is (`readAiTextResult`): plain text,
+ *   not empty, at most {@link AI_TEXT_MAX_LENGTH} code points.
+ * - **Every correction must quote the draft** — the check only this SDK can run.
+ *   The SDK finds each quote in the draft itself, typographic quotes and runs of
+ *   whitespace aside, and anchors it there; a range the model claims must hold
+ *   the quote. A correction of words the learner did not write refuses the
+ *   whole reply as `misquotes-answer`, as a hint that gives the answer away
+ *   refuses the hint. The `original` shown is the draft's own text at the range.
+ *   At most {@link AI_WRITING_MAX_CORRECTIONS}; a correction that changes
+ *   nothing is `malformed`.
+ * - **Criteria are judgements; the arithmetic is the SDK's.** Each names a
+ *   criterion of the item's rubric, once; its score, when it has one, is a
+ *   score out of its `maxScore`. The rubric's weights are attached, whatever
+ *   the model sent. Anything else is `malformed`, as is any criterion on an
+ *   item with no rubric.
+ * - **`indicativeScore`** is the rubric's weighted total, computed as
+ *   `gradeFromRubric` computes a grade, when every criterion of the rubric was
+ *   judged; `null` otherwise. An indication, never a grade.
+ */
+declare function checkAiWritingFeedback(raw: unknown, request: AiWritingFeedbackRequest): {
+    ok: true;
+    feedback: AiWritingFeedback;
+} | {
+    ok: false;
+    refusal: AiRefusal;
+};
+
 /**
  * How a paper is delivered: what a learner is shown around the questions, as
  * the school running it decides — separately from the content, so that one
@@ -1160,6 +1216,80 @@ declare function serializeMediaPlayLedger(plan: AttemptPlan, entries: Readonly<R
  */
 declare function restoreMediaPlayLedger(plan: AttemptPlan, stored: MediaPlayLedger): MediaPlayLedger;
 
+/**
+ * Standard Schema v1 (https://standardschema.dev): the interface zod, valibot,
+ * ArkType and other validators implement, so a library can accept a schema from
+ * any of them without depending on one. Copied here, as the specification asks
+ * a library to do, so lk-core depends on no validator's types.
+ *
+ * A registered activity type's `schema` and `redactedSchema` are Standard
+ * Schemas. A zod 4 schema is one as written: `schema: z.object({ … })` needs no
+ * adapter.
+ */
+/** A schema that validates unknown input and produces `Output`. */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+    /** The Standard Schema properties. */
+    readonly '~standard': StandardSchemaV1.Props<Input, Output>;
+}
+declare namespace StandardSchemaV1 {
+    /** The Standard Schema properties interface. */
+    interface Props<Input = unknown, Output = Input> {
+        /** The version number of the standard. */
+        readonly version: 1;
+        /** The vendor name of the schema library. */
+        readonly vendor: string;
+        /**
+         * Validates unknown input values. lk-core validates synchronously, so a
+         * schema whose validation returns a Promise is refused when it is read.
+         */
+        readonly validate: (value: unknown, options?: StandardSchemaV1.Options | undefined) => Result<Output> | Promise<Result<Output>>;
+        /** Inferred types associated with the schema. */
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    /** The result interface of the validate function. */
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    /** The result interface if validation succeeds. */
+    interface SuccessResult<Output> {
+        /** The typed output value. */
+        readonly value: Output;
+        /** The absence of issues indicates success. */
+        readonly issues?: undefined;
+    }
+    /** Options for the validate function. */
+    interface Options {
+        /** Implicit support for additional vendor-specific parameters, if needed. */
+        readonly libraryOptions?: Record<string, unknown> | undefined;
+    }
+    /** The result interface if validation fails. */
+    interface FailureResult {
+        /** The issues of failed validation. */
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    /** The issue interface of the failure output. */
+    interface Issue {
+        /** The error message of the issue. */
+        readonly message: string;
+        /** The path of the issue, if any. */
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    /** The path segment interface of the issue. */
+    interface PathSegment {
+        /** The key representing a path segment. */
+        readonly key: PropertyKey;
+    }
+    /** The Standard Schema types interface. */
+    interface Types<Input = unknown, Output = Input> {
+        /** The input type of the schema. */
+        readonly input: Input;
+        /** The output type of the schema. */
+        readonly output: Output;
+    }
+    /** Infers the input type of a Standard Schema. */
+    type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
+    /** Infers the output type of a Standard Schema. */
+    type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
+}
+
 /** ScoringResult without `passed` — the public `score()` / `evaluate()` fill that in. */
 type PartialScoringResult = Omit<ScoringResult, 'passed'>;
 /**
@@ -1237,8 +1367,9 @@ interface ActivityTypeAuthoring<TData> {
      * length included, so report a rule about a whole list at the list's own path.
      * A failure at the root of the draft is accounted for only by an issue at the
      * root. A `null` the schema refuses, where nothing here reports it, comes back
-     * as `null_not_allowed` — except inside a plain `z.union`, which reports a
-     * failure once, at the union's own path, under its own code.
+     * as `null_not_allowed`. A zod 4 schema tells a refused `null` from a rule of
+     * yours that merely points at one, which keeps its own code; a schema from
+     * another library cannot, so report such a rule here, at its path.
      *
      * A code documented in `docs/authoring.md` is reported with its documented
      * severity. For a code of your own, a severity other than `'incomplete'` is
@@ -1252,14 +1383,38 @@ interface ActivityTypeAuthoring<TData> {
  * descriptor makes `validateActivity`, `validateDraft`, `score`, `evaluate`,
  * `redact`, and `jsonSchemaFor` work for the type — an activity type is a value,
  * not a hardcoded union member (R1).
+ *
+ * Its schemas are Standard Schemas ({@link StandardSchemaV1}), so they can be
+ * written with any library that implements the standard — a zod 4 schema is
+ * one as it stands:
+ *
+ * ```ts
+ * const pollType = defineActivityType<PollData, PollResponse>({
+ *   type: 'poll',
+ *   schema: z.looseObject({ type: z.literal('poll'), id: z.string(), … }),
+ *   scoring: { kind: 'sync', score: scorePoll },
+ * });
+ * registerActivityType(pollType);
+ * ```
  */
 interface ActivityTypeDescriptor<TData extends {
     type: string;
 }, TResponse> {
     /** The `type` discriminator string (kebab-case by convention). */
     readonly type: TData['type'];
-    /** Zod schema validating the activity's data contract. */
-    readonly schema: z.ZodType<TData>;
+    /**
+     * The activity's data contract, as a Standard Schema whose output is the
+     * data. Its validation must be synchronous: every entry point that reads it
+     * is.
+     */
+    readonly schema: StandardSchemaV1<unknown, TData>;
+    /**
+     * The contract as JSON Schema, for `jsonSchemaFor`. Leave it out when
+     * `schema` can produce one itself through the Standard JSON Schema converter
+     * (`'~standard'.jsonSchema`), as a zod 4.6 schema can; give it to override
+     * that, or for a library that cannot.
+     */
+    readonly jsonSchema?: Readonly<Record<string, unknown>>;
     /** How responses are graded. */
     readonly scoring: ActivityTypeScoring<TData, TResponse>;
     /** Whether a response counts as an answer (vs. blank/untouched). */
@@ -1268,10 +1423,11 @@ interface ActivityTypeDescriptor<TData extends {
     readonly fieldPolicy?: FieldPolicy;
     /**
      * Schema the output of `redact(data)` (with default `reveal: 'none'`) must
-     * satisfy. Strict by design: it proves the ABSENCE of answer-key fields,
-     * so `assertRedacted` can guarantee a payload is safe to send to a learner.
+     * satisfy, as a Standard Schema. Strict by design: it proves the ABSENCE of
+     * answer-key fields, so `assertRedacted` can guarantee a payload is safe to
+     * send to a learner.
      */
-    readonly redactedSchema?: z.ZodType<unknown>;
+    readonly redactedSchema?: StandardSchemaV1;
     /** Interop facts for xAPI (and later QTI) statement building. */
     readonly interop?: ActivityTypeInterop<TData>;
     /** The interaction-event kinds components for this type emit. */
@@ -1285,7 +1441,8 @@ interface ActivityTypeDescriptor<TData extends {
  */
 interface RegisteredActivityTypeDescriptor {
     readonly type: string;
-    readonly schema: z.ZodType<unknown>;
+    readonly schema: StandardSchemaV1;
+    readonly jsonSchema?: Readonly<Record<string, unknown>>;
     readonly scoring: {
         readonly kind: 'sync';
         readonly score: (data: unknown, response: unknown) => PartialScoringResult;
@@ -1296,7 +1453,7 @@ interface RegisteredActivityTypeDescriptor {
     };
     readonly isAnswered?: (response: unknown) => boolean;
     readonly fieldPolicy?: FieldPolicy;
-    readonly redactedSchema?: z.ZodType<unknown>;
+    readonly redactedSchema?: StandardSchemaV1;
     readonly interop?: ActivityTypeInterop<unknown>;
     readonly interactions?: readonly string[];
     readonly authoring?: ActivityTypeAuthoring<unknown>;
@@ -1638,4 +1795,4 @@ interface ThemeTokens {
     '--lk-transition-base': string;
 }
 
-export { AI_EXPLANATION_TYPES, AI_HINT_TYPES, AI_TEXT_MAX_LENGTH, ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, AiActivityInput, AiExplanationRequest, AiFeature, AiGrade, AiHintRequest, AiItemFacts, AiRefusal, AiSupportedActivityType, AiTextResult, AssessmentScore, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CompositionPolicy, CriterionScore, DeferredScoringError, DeferredScoringPartial, type DeliveryPolicy, type DeliveryPolicyIssue, 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, INTERACTIVE_VIDEO_ITEM_TYPES, type InteractiveVideoItemType, ItemGroup, ItemOutcome, ItemScoringPolicy, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, MediaProgress, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, OPEN_DELIVERY_POLICY, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, ReadAloudData, ReadAloudLearnerResponse, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedDeliveryPolicy, ResolvedItemScoringPolicy, type ResolvedPlaybackPolicy, type ResponseDiffEntry, RoundingPolicy, ScoredItem, ScoringDetail, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, TIMELINE_MAX_CHAPTERS, TIMELINE_MAX_ITEMS, TIMELINE_MAX_QUIZZES, TIMELINE_MAX_TITLE_LENGTH, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, aiAllowedByContent, aiExplanationRequest, aiGradeOf, aiHintRequest, aiSupports, assertRedacted, assertRedactedItemGroup, buildAiFacts, canonicalJson, checkAiExplanation, checkAiHint, combineDeliveryPolicies, composeTimelineScore, contentHash, countWords, createDraft, createInteractiveVideoDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, hintRevealsAnswer, isInteractiveVideoItemType, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, readAiTextResult, readAloudType, readMediaProgress, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolveDeliveryPolicy, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDeliveryPolicy, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };
+export { AI_EXPLANATION_TYPES, AI_HINT_TYPES, AI_TEXT_MAX_LENGTH, AI_WRITING_MAX_CORRECTIONS, AI_WRITING_MAX_FIELD_LENGTH, ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, AiActivityInput, AiExplanationRequest, AiFeature, AiGrade, AiHintRequest, AiItemFacts, AiRefusal, AiSupportedActivityType, AiTextResult, AiWritingFeedback, AiWritingFeedbackRequest, AssessmentScore, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CompositionPolicy, CriterionScore, DeferredScoringError, DeferredScoringPartial, type DeliveryPolicy, type DeliveryPolicyIssue, 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, INTERACTIVE_VIDEO_ITEM_TYPES, type InteractiveVideoItemType, ItemGroup, ItemOutcome, ItemScoringPolicy, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, MediaProgress, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, OPEN_DELIVERY_POLICY, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, ReadAloudData, ReadAloudLearnerResponse, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedDeliveryPolicy, ResolvedItemScoringPolicy, type ResolvedPlaybackPolicy, type ResponseDiffEntry, RoundingPolicy, ScoredItem, ScoringDetail, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, StandardSchemaV1, TIMELINE_MAX_CHAPTERS, TIMELINE_MAX_ITEMS, TIMELINE_MAX_QUIZZES, TIMELINE_MAX_TITLE_LENGTH, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, aiAllowedByContent, aiExplanationRequest, aiGradeOf, aiHintRequest, aiSupports, aiWritingFeedbackRequest, assertRedacted, assertRedactedItemGroup, buildAiFacts, canonicalJson, checkAiExplanation, checkAiHint, checkAiWritingFeedback, combineDeliveryPolicies, composeTimelineScore, contentHash, countWords, createDraft, createInteractiveVideoDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, hintRevealsAnswer, isInteractiveVideoItemType, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, readAiTextResult, readAloudType, readMediaProgress, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolveDeliveryPolicy, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDeliveryPolicy, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };