@intellectif/lk-core 0.12.0 → 0.13.0

package/dist/{chunk-7JMMPE7O.js → chunk-Y36S3X3L.js}

@@ -1,13 +1,16 @@
 import {
+  DictationDataSchema,
   FillInTheBlanksDataSchema,
+  GROUP_CAPTIONS_REVEAL_DICTATION,
   GapSelectDataSchema,
   MediaSchema,
   MultipleChoiceDataSchema,
   RedactedMediaSchema,
   UnknownActivityTypeError,
   WrittenResponseDataSchema,
-  getActivityTypeDescriptor
-} from "./chunk-FVN37GIH.js";
+  getActivityTypeDescriptor,
+  groupCaptionsRevealDictation
+} from "./chunk-XKKKWKRH.js";
 
 // src/schemas/item-group.ts
 import { z } from "zod/v4";
@@ -99,6 +102,15 @@ var RedactedItemGroupSchema = z.strictObject({
   stimulus: RedactedStimulusSchema,
   items: z.array(z.unknown()).min(1),
   shuffle: z.enum(["none", "within-group"]).optional()
+}).check((ctx) => {
+  if (groupCaptionsRevealDictation(ctx.value)) {
+    ctx.issues.push({
+      code: "custom",
+      input: ctx.value.stimulus.media?.captionsUrl,
+      message: GROUP_CAPTIONS_REVEAL_DICTATION,
+      path: ["stimulus", "media", "captionsUrl"]
+    });
+  }
 });
 function toValidationErrors(issues, prefix) {
   return issues.map((issue) => ({
@@ -131,6 +143,13 @@ function validateItemGroup(data) {
     }
     items.push(parsed.data);
   });
+  if (groupCaptionsRevealDictation(container.data)) {
+    errors.push({
+      path: ["stimulus", "media", "captionsUrl"],
+      message: GROUP_CAPTIONS_REVEAL_DICTATION,
+      code: "custom"
+    });
+  }
   if (errors.length > 0) {
     return { success: false, errors };
   }
@@ -144,6 +163,9 @@ var itemGroupJsonSchema = z2.toJSONSchema(ItemGroupSchema, { target: "draft-7" }
 var gapSelectJsonSchema = z2.toJSONSchema(GapSelectDataSchema, {
   target: "draft-7"
 });
+var dictationJsonSchema = z2.toJSONSchema(DictationDataSchema, {
+  target: "draft-7"
+});
 var multipleChoiceJsonSchema = z2.toJSONSchema(MultipleChoiceDataSchema, {
   target: "draft-7"
 });
@@ -190,10 +212,11 @@ export {
   stimulusJsonSchema,
   itemGroupJsonSchema,
   gapSelectJsonSchema,
+  dictationJsonSchema,
   multipleChoiceJsonSchema,
   fillInTheBlanksJsonSchema,
   writtenResponseJsonSchema,
   jsonSchemaFor,
   validateActivity
 };
-//# sourceMappingURL=chunk-7JMMPE7O.js.map
+//# sourceMappingURL=chunk-Y36S3X3L.js.map

package/dist/chunk-Y36S3X3L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/item-group.ts","../src/schemas/json-schema.ts","../src/schemas/index.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport { getActivityTypeDescriptor } from '../registry/index.js';\nimport type { ActivityData, ValidationError, ValidationResult } from '../types/activity.js';\nimport type { ItemGroup, StimulusKind } from '../types/item-group.js';\nimport { GROUP_CAPTIONS_REVEAL_DICTATION, groupCaptionsRevealDictation } from './dictation.js';\nimport { MediaSchema, RedactedMediaSchema } from './media.js';\n\n/**\n * An authored slot key.\n *\n * A `.` is rejected here, not at render time: `flattenSequence` uses the first\n * `.` to separate a group from its item, so a key containing one would produce\n * an ambiguous slot id. `keyOf` already threw on it — this moves the rejection\n * to `validateItemGroup`, where an author finds it, instead of leaving it to\n * surface when a learner opens the paper. Content that would newly fail\n * validation already threw at flatten time, so it can never have been sat.\n */\nconst SlotKeySchema = z\n  .string()\n  .min(1)\n  .refine((key) => !key.includes('.'), {\n    error:\n      'slotKey must not contain \".\" — that character separates a group from its item in a slot id, so a key containing one would make the slot ambiguous.',\n  });\n\nfunction hasBody(stimulus: { body?: string | undefined }): boolean {\n  return typeof stimulus.body === 'string' && stimulus.body.trim().length > 0;\n}\n\n/** Which media types can carry a stimulus of each kind. `text`/`mixed` accept any. */\nfunction mediaFits(kind: StimulusKind, mediaType: string | undefined): boolean {\n  switch (kind) {\n    case 'audio':\n      return mediaType === 'audio';\n    case 'video':\n      return mediaType === 'video' || mediaType === 'embed';\n    case 'image':\n      return mediaType === 'image';\n    default:\n      return true;\n  }\n}\n\n/**\n * Zod schema for a {@link Stimulus}. Loose: unknown keys preserved.\n *\n * The semantic guards exist because a stimulus that does not carry what its\n * `kind` promises is an authoring error that must not reach an exam: an\n * \"audio\" stimulus with no recording renders as a blank panel above six\n * listening questions. Unrepresentable in JSON Schema; dropped from\n * `stimulusJsonSchema` by design.\n */\nexport const StimulusSchema = z\n  .looseObject({\n    id: z.string().min(1),\n    kind: z.enum(['text', 'audio', 'video', 'image', 'mixed']),\n    title: z.string().optional(),\n    body: z.string().optional(),\n    bodyHtml: z.string().optional(),\n    media: MediaSchema.optional(),\n    transcript: z.string().optional(),\n    locale: z.string().optional(),\n    attribution: z.string().optional(),\n  })\n  .refine((stimulus) => stimulus.bodyHtml === undefined || hasBody(stimulus), {\n    error:\n      'bodyHtml requires a plain-text body: it is the accessible fallback rendered when no sanitiser is supplied.',\n    path: ['body'],\n  })\n  .refine(\n    (stimulus) => (stimulus.kind !== 'text' && stimulus.kind !== 'mixed') || hasBody(stimulus),\n    {\n      error: 'A text or mixed stimulus needs a non-empty body.',\n      path: ['body'],\n    },\n  )\n  .refine((stimulus) => stimulus.kind === 'text' || stimulus.media !== undefined, {\n    error: 'An audio, video, image or mixed stimulus needs media.',\n    path: ['media'],\n  })\n  .refine(\n    (stimulus) => stimulus.media === undefined || mediaFits(stimulus.kind, stimulus.media.type),\n    {\n      error:\n        'media.type does not fit the stimulus kind: audio needs audio; video needs video or embed; image needs image.',\n      path: ['media', 'type'],\n    },\n  );\n\n/**\n * The structural minimum of an item as seen by the CONTAINER schema. Each\n * item's own contract is checked against its registered schema by\n * {@link validateItemGroup} — a zod schema cannot dispatch on a registry\n * that consumers extend at runtime.\n */\nconst ItemShapeSchema = z.looseObject({\n  type: z.string().min(1),\n  id: z.string().min(1),\n  slotKey: SlotKeySchema.optional(),\n});\n\n/**\n * Zod schema for an {@link ItemGroup} CONTAINER. Loose: unknown keys\n * preserved. Validates the group's own fields and the stimulus in full, and\n * each item only structurally (`type` and `id`); use {@link validateItemGroup}\n * to validate the items against their registered schemas as well.\n */\nexport const ItemGroupSchema = z\n  .looseObject({\n    schemaVersion: z.literal('1.0'),\n    type: z.literal('item-group'),\n    id: z.string().min(1),\n    title: z.string().optional(),\n    slotKey: SlotKeySchema.optional(),\n    stimulus: StimulusSchema,\n    items: z.array(ItemShapeSchema).min(1),\n    shuffle: z.enum(['none', 'within-group']).optional(),\n  })\n  .refine((group) => group.items.every((item) => item.type !== 'item-group'), {\n    error: 'Item groups do not nest: every item must be an activity.',\n    path: ['items'],\n  })\n  .refine((group) => new Set(group.items.map((item) => item.id)).size === group.items.length, {\n    error: 'Item ids must be unique within a group.',\n    path: ['items'],\n  });\n\n/** The learner-safe shape of a stimulus, derived from the strict schema below. */\nexport type RedactedStimulus = z.infer<typeof RedactedStimulusSchema>;\n\n/** Strict learner-safe stimulus: everything but the author-only `transcript`. */\nexport const RedactedStimulusSchema = z.strictObject({\n  id: z.string().min(1),\n  kind: z.enum(['text', 'audio', 'video', 'image', 'mixed']),\n  title: z.string().optional(),\n  body: z.string().optional(),\n  bodyHtml: z.string().optional(),\n  media: RedactedMediaSchema.optional(),\n  locale: z.string().optional(),\n  attribution: z.string().optional(),\n});\n\n/**\n * Strict learner-safe item group. Items are left opaque here — each is proven\n * learner-safe by `assertRedacted` against its OWN type's redacted schema,\n * which is the only place that knowledge lives. The one exception is the one\n * rule that spans the container and an item: a captioned stimulus recording\n * played to a dictation is not learner-safe, because the captions are the\n * dictation's answer.\n */\nexport const RedactedItemGroupSchema = z\n  .strictObject({\n    redacted: z.literal(true),\n    schemaVersion: z.literal('1.0'),\n    type: z.literal('item-group'),\n    id: z.string().min(1),\n    title: z.string().optional(),\n    slotKey: SlotKeySchema.optional(),\n    stimulus: RedactedStimulusSchema,\n    items: z.array(z.unknown()).min(1),\n    shuffle: z.enum(['none', 'within-group']).optional(),\n  })\n  .check((ctx) => {\n    if (groupCaptionsRevealDictation(ctx.value)) {\n      ctx.issues.push({\n        code: 'custom',\n        input: ctx.value.stimulus.media?.captionsUrl,\n        message: GROUP_CAPTIONS_REVEAL_DICTATION,\n        path: ['stimulus', 'media', 'captionsUrl'],\n      });\n    }\n  });\n\nfunction toValidationErrors(\n  issues: readonly { path: PropertyKey[]; message: string; code: string }[],\n  prefix: string[],\n): ValidationError[] {\n  return issues.map((issue) => ({\n    path: [...prefix, ...issue.path.map(String)],\n    message: issue.message,\n    code: issue.code,\n  }));\n}\n\n/**\n * Validates an item group in full: the container and stimulus against\n * {@link ItemGroupSchema}, then every item against the schema registered for\n * its `type`. Errors from items are reported at `items.<index>.…`.\n *\n * Unlike `validateActivity`, an item whose type is not registered is REPORTED\n * (code `unknown_activity_type`) rather than thrown: a group is validated as\n * a whole, and an author fixing a six-item group wants every problem listed,\n * not the first one that happened to throw.\n */\nexport function validateItemGroup(data: unknown): ValidationResult<ItemGroup> {\n  const container = ItemGroupSchema.safeParse(data);\n  if (!container.success) {\n    return { success: false, errors: toValidationErrors(container.error.issues, []) };\n  }\n\n  const errors: ValidationError[] = [];\n  const items: ActivityData[] = [];\n  container.data.items.forEach((item, index) => {\n    const descriptor = getActivityTypeDescriptor(item.type);\n    if (descriptor === undefined) {\n      errors.push({\n        path: ['items', String(index), 'type'],\n        message: `Activity type \"${item.type}\" is not registered`,\n        code: 'unknown_activity_type',\n      });\n      return;\n    }\n    const parsed = descriptor.schema.safeParse(item);\n    if (!parsed.success) {\n      errors.push(...toValidationErrors(parsed.error.issues, ['items', String(index)]));\n      return;\n    }\n    items.push(parsed.data as ActivityData);\n  });\n  if (groupCaptionsRevealDictation(container.data)) {\n    errors.push({\n      path: ['stimulus', 'media', 'captionsUrl'],\n      message: GROUP_CAPTIONS_REVEAL_DICTATION,\n      code: 'custom',\n    });\n  }\n\n  if (errors.length > 0) {\n    return { success: false, errors };\n  }\n  // zod4 optional outputs are `T | undefined`; the wire type uses exact\n  // optionals. Structurally identical at runtime — the cast is type-level.\n  return { success: true, data: { ...container.data, items } as unknown as ItemGroup };\n}\n","import { z } from 'zod/v4';\nimport { UnknownActivityTypeError } from '../errors.js';\nimport { getActivityTypeDescriptor } from '../registry/index.js';\nimport { DictationDataSchema } from './dictation.js';\nimport { FillInTheBlanksDataSchema } from './fill-in-the-blanks.js';\nimport { GapSelectDataSchema } from './gap-select.js';\nimport { ItemGroupSchema, StimulusSchema } from './item-group.js';\nimport { MultipleChoiceDataSchema } from './multiple-choice.js';\nimport { WrittenResponseDataSchema } from './written-response.js';\n\n/**\n * JSON Schema (Draft 7) for a `Stimulus`. Structural contract only — the\n * kind/media/body consistency guards are Zod-only.\n */\nexport const stimulusJsonSchema = z.toJSONSchema(StimulusSchema, { target: 'draft-7' });\n\n/**\n * JSON Schema (Draft 7) for an `ItemGroup` CONTAINER. Items appear as objects\n * with `type` and `id` only; each item's own contract is `jsonSchemaFor(type)`.\n * For an AI generation pipeline, ask for the group and each item separately\n * rather than a single nested schema — that keeps the per-type schema the\n * registry's, not a copy.\n */\nexport const itemGroupJsonSchema = z.toJSONSchema(ItemGroupSchema, { target: 'draft-7' });\n\n/**\n * JSON Schema (Draft 7) representation of the Multiple Choice activity data\n * contract, generated natively by Zod 4. Draft 7 is mandated by Requirement\n * 2.2 for the widest AI-prompt / OpenAPI tooling compatibility. The semantic\n * `.refine()` guards are not representable in JSON Schema and are\n * intentionally omitted — the export captures the *structural* contract only.\n * Since v0.3 the source schemas are loose, so these no longer emit\n * `additionalProperties: false` — the JSON Schema and `validateActivity` now\n * agree on unknown-key handling.\n */\n/**\n * JSON Schema (Draft 7) representation of the Gap Select activity data\n * contract. Structural contract only: the six semantic guards — the\n * passage/gap bijection, id uniqueness, the one-choice-source rule, and an\n * answer key that names a choice the gap offers — are Zod-only, as they are\n * for the other types.\n */\nexport const gapSelectJsonSchema = z.toJSONSchema(GapSelectDataSchema, {\n  target: 'draft-7',\n});\n\n/**\n * JSON Schema (Draft 7) representation of the Dictation activity data\n * contract. Structural contract, plus the raw length caps JSON Schema can\n * state in code points as zod counts them — `maxLength` 2000 on a transcript\n * and an accepted transcript, 200 on a rule's `from` and `to`. The twelve\n * semantic guards — a transcript that survives normalisation, the caps after\n * equivalences are applied, distinct candidates, audio only, the\n * slow-recording rules, no captions, no transcript in the title — are\n * Zod-only, as they are for the other types.\n */\nexport const dictationJsonSchema = z.toJSONSchema(DictationDataSchema, {\n  target: 'draft-7',\n});\n\nexport const multipleChoiceJsonSchema = z.toJSONSchema(MultipleChoiceDataSchema, {\n  target: 'draft-7',\n});\n\n/**\n * JSON Schema (Draft 7) representation of the Fill-in-the-Blanks activity data\n * contract, generated natively by Zod 4. Structural contract only (semantic\n * `.refine()` guards are Zod-only and not representable in JSON Schema).\n */\nexport const fillInTheBlanksJsonSchema = z.toJSONSchema(FillInTheBlanksDataSchema, {\n  target: 'draft-7',\n});\n\n/**\n * JSON Schema (Draft 7) representation of the Written Response activity data\n * contract. Structural contract only.\n */\nexport const writtenResponseJsonSchema = z.toJSONSchema(WrittenResponseDataSchema, {\n  target: 'draft-7',\n});\n\n/**\n * Derives the JSON Schema (Draft 7) for any REGISTERED activity type — the\n * live, registry-backed replacement for the static per-type exports above,\n * and the building block for AI generation pipelines (R6.1): pass the result\n * as a structured-output schema so a model can only emit valid items.\n *\n * @throws UnknownActivityTypeError when `type` has no registered descriptor.\n */\nexport function jsonSchemaFor(type: string): Record<string, unknown> {\n  const descriptor = getActivityTypeDescriptor(type);\n  if (descriptor === undefined) {\n    throw new UnknownActivityTypeError(type);\n  }\n  return z.toJSONSchema(descriptor.schema as never, { target: 'draft-7' }) as Record<\n    string,\n    unknown\n  >;\n}\n","import { UnknownActivityTypeError } from '../errors.js';\nimport { getActivityTypeDescriptor } from '../registry/index.js';\nimport type { ActivityDataMap, ActivityType, ValidationResult } from '../types/activity.js';\n\nexport {\n  DictationDataSchema,\n  DictationEquivalenceSchema,\n  DictationSlowMediaSchema,\n  DictationToleranceSchema,\n} from './dictation.js';\nexport { FeedbackSchema } from './feedback.js';\nexport {\n  BlankConfigSchema,\n  FillInTheBlanksDataSchema,\n  TextMatchPolicySchema,\n} from './fill-in-the-blanks.js';\nexport {\n  GapSelectBankSchema,\n  GapSelectChoiceSchema,\n  GapSelectDataSchema,\n  GapSelectGapSchema,\n} from './gap-select.js';\nexport type { RedactedStimulus } from './item-group.js';\nexport {\n  ItemGroupSchema,\n  RedactedItemGroupSchema,\n  RedactedStimulusSchema,\n  StimulusSchema,\n  validateItemGroup,\n} from './item-group.js';\nexport {\n  dictationJsonSchema,\n  fillInTheBlanksJsonSchema,\n  gapSelectJsonSchema,\n  itemGroupJsonSchema,\n  jsonSchemaFor,\n  multipleChoiceJsonSchema,\n  stimulusJsonSchema,\n  writtenResponseJsonSchema,\n} from './json-schema.js';\nexport {\n  MediaPlaybackSchema,\n  MediaSchema,\n  MediaUrlSchema,\n  NativeControlHintSchema,\n  RedactedMediaSchema,\n} from './media.js';\nexport {\n  MultipleChoiceDataSchema,\n  MultipleChoiceOptionMediaSchema,\n  MultipleChoiceOptionSchema,\n} from './multiple-choice.js';\nexport type {\n  RedactedActivity,\n  RedactedBlankConfig,\n  RedactedDictationData,\n  RedactedDictationSlowMedia,\n  RedactedFillInTheBlanksData,\n  RedactedGapSelectBank,\n  RedactedGapSelectChoice,\n  RedactedGapSelectData,\n  RedactedGapSelectGap,\n  RedactedMultipleChoiceData,\n  RedactedMultipleChoiceOption,\n  RedactedMultipleChoiceOptionMedia,\n  RedactedWrittenResponseData,\n} from './redacted.js';\nexport {\n  RedactedBlankConfigSchema,\n  RedactedDictationDataSchema,\n  RedactedDictationSlowMediaSchema,\n  RedactedFillInTheBlanksDataSchema,\n  RedactedGapSelectBankSchema,\n  RedactedGapSelectChoiceSchema,\n  RedactedGapSelectDataSchema,\n  RedactedGapSelectGapSchema,\n  RedactedMultipleChoiceDataSchema,\n  RedactedMultipleChoiceOptionMediaSchema,\n  RedactedMultipleChoiceOptionSchema,\n  RedactedWrittenResponseDataSchema,\n} from './redacted.js';\nexport {\n  WrittenResponseDataSchema,\n  WrittenResponseRubricCriterionSchema,\n  WrittenResponseRubricSchema,\n} from './written-response.js';\n\n/**\n * Validates raw activity data against the schema registered for the given\n * activity type (built-in or consumer-registered via `registerActivityType`).\n *\n * Unknown keys are PRESERVED, not stripped: every built-in schema is loose,\n * so consumer sidecar fields and forward-version fields survive validation\n * verbatim in the returned `data`.\n *\n * @returns `{ success: true, data }` with the typed, validated data, or\n *          `{ success: false, errors }` with one entry per failed constraint.\n * @throws UnknownActivityTypeError when `type` has no registered descriptor.\n */\nexport function validateActivity<T extends ActivityType>(\n  type: T,\n  data: unknown,\n): ValidationResult<ActivityDataMap[T]> {\n  const descriptor = getActivityTypeDescriptor(type);\n  if (descriptor === undefined) {\n    throw new UnknownActivityTypeError(String(type));\n  }\n\n  const result = descriptor.schema.safeParse(data);\n\n  if (result.success) {\n    return { success: true, data: result.data as ActivityDataMap[T] };\n  }\n\n  return {\n    success: false,\n    errors: result.error.issues.map((issue) => ({\n      path: issue.path.map(String),\n      message: issue.message,\n      code: issue.code,\n    })),\n  };\n}\n"],"mappings":"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","names":["z","z"]}

package/dist/{index-B_scInLM.d.cts → index-Bz9wUigA.d.cts}

@@ -1,4 +1,4 @@
-import { A as ActivityData, c as ActivityMedia, z as ValidationResult, e as ActivityType, a as ActivityDataMap } from './activity-B2QxK15j.cjs';
+import { A as ActivityData, c as ActivityMedia, P as ValidationResult, e as ActivityType, a as ActivityDataMap } from './activity-DfAmJ1sl.cjs';
 import { z } from 'zod/v4';
 
 /** What a stimulus primarily is. Drives validation and layout, never scoring. */
@@ -134,6 +134,94 @@ interface SequenceSlot<TItem = ActivityData> {
     group?: SequenceSlotGroup;
 }
 
+/**
+ * Zod schema for the slower second recording of a dictation. Loose like every
+ * content schema (a sidecar survives), audio only, and — deliberately — with no
+ * `captionsUrl` and no `playback` of its own; the activity-level guards below
+ * refuse both if an author writes them anyway.
+ */
+declare const DictationSlowMediaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"audio">;
+    url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+    alt: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/**
+ * Zod schema for one whole-word rewrite rule. Both halves are bounded: `to`
+ * because a rule expands text, `from` because it is compiled into the pattern
+ * every attempt is searched with.
+ */
+declare const DictationEquivalenceSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, z.core.$loose>;
+/** Zod schema for a dictation's grading tolerances. At most `DICTATION_MAX_EQUIVALENCES` rules. */
+declare const DictationToleranceSchema: z.ZodObject<{
+    equivalences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+declare const DictationDataSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    type: z.ZodLiteral<"dictation">;
+    id: z.ZodString;
+    title: z.ZodString;
+    transcript: z.ZodString;
+    acceptedTranscripts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    media: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<{
+            image: "image";
+            audio: "audio";
+            video: "video";
+            embed: "embed";
+        }>;
+        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+        alt: z.ZodOptional<z.ZodString>;
+        captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
+        playback: z.ZodOptional<z.ZodObject<{
+            controls: z.ZodOptional<z.ZodEnum<{
+                native: "native";
+                minimal: "minimal";
+            }>>;
+            maxPlays: z.ZodOptional<z.ZodNumber>;
+            seek: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                allow: "allow";
+            }>>;
+            rate: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                fixed: "fixed";
+            }>>;
+            nativeControlHints: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                "hide-download": "hide-download";
+                "hide-rate": "hide-rate";
+            }>>>;
+        }, z.core.$strict>>;
+    }, z.core.$loose>>;
+    slowMedia: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"audio">;
+        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+        alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    hints: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodLiteral<"progressive-words">;
+    }, z.core.$loose>>;
+    tolerance: z.ZodOptional<z.ZodObject<{
+        equivalences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+    feedback: z.ZodOptional<z.ZodObject<{
+        correct: z.ZodOptional<z.ZodString>;
+        incorrect: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    passThreshold: z.ZodOptional<z.ZodNumber>;
+    locale: z.ZodOptional<z.ZodString>;
+    learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
+}, z.core.$loose>;
+
 /**
  * Optional authored "overall feedback" shown after submission, selected by
  * whether the learner passed (h5p-style overall feedback). Both fields are
@@ -566,7 +654,10 @@ declare const RedactedStimulusSchema: z.ZodObject<{
 /**
  * Strict learner-safe item group. Items are left opaque here — each is proven
  * learner-safe by `assertRedacted` against its OWN type's redacted schema,
- * which is the only place that knowledge lives.
+ * which is the only place that knowledge lives. The one exception is the one
+ * rule that spans the container and an item: a captioned stimulus recording
+ * played to a dictation is not learner-safe, because the captions are the
+ * dictation's answer.
  */
 declare const RedactedItemGroupSchema: z.ZodObject<{
     redacted: z.ZodLiteral<true>;
@@ -669,6 +760,17 @@ declare const itemGroupJsonSchema: z.core.JSONSchema.JSONSchema;
  * for the other types.
  */
 declare const gapSelectJsonSchema: z.core.JSONSchema.JSONSchema;
+/**
+ * JSON Schema (Draft 7) representation of the Dictation activity data
+ * contract. Structural contract, plus the raw length caps JSON Schema can
+ * state in code points as zod counts them — `maxLength` 2000 on a transcript
+ * and an accepted transcript, 200 on a rule's `from` and `to`. The twelve
+ * semantic guards — a transcript that survives normalisation, the caps after
+ * equivalences are applied, distinct candidates, audio only, the
+ * slow-recording rules, no captions, no transcript in the title — are
+ * Zod-only, as they are for the other types.
+ */
+declare const dictationJsonSchema: z.core.JSONSchema.JSONSchema;
 declare const multipleChoiceJsonSchema: z.core.JSONSchema.JSONSchema;
 /**
  * JSON Schema (Draft 7) representation of the Fill-in-the-Blanks activity data
@@ -1335,6 +1437,77 @@ declare const RedactedWrittenResponseDataSchema: z.ZodObject<{
     learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
     difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
 }, z.core.$strict>;
+/** A redacted slow recording: unchanged — it is public, and it never carried captions or a policy. */
+declare const RedactedDictationSlowMediaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"audio">;
+    url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+    alt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Redacted Dictation data: the recording(s) and the hint mode survive; the
+ * transcript, the accepted alternatives and the tolerance — the whole answer
+ * key — do not. A `progressive-words` hint mode reveals nothing by itself: the
+ * words it would reveal are the transcript, and that is gone.
+ *
+ * Three rules of the content schema are repeated here, because a projection
+ * built by hand never passed through it: captions on the recording ARE the
+ * answer, so a payload carrying them is not learner-safe; a slow recording
+ * beside a play budget is an unbudgeted copy of the budgeted content; and so is
+ * a slow recording with no recording beside it, which in a group sits beside a
+ * stimulus recording that may be budgeted.
+ */
+declare const RedactedDictationDataSchema: z.ZodObject<{
+    type: z.ZodLiteral<"dictation">;
+    slowMedia: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"audio">;
+        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+        alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    hints: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodLiteral<"progressive-words">;
+    }, z.core.$strict>>;
+    /** Marker distinguishing a redacted projection from full activity data. */
+    redacted: z.ZodLiteral<true>;
+    /** Slot identity, carried through redaction so the client and the plan agree. */
+    slotKey: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<"1.0">;
+    id: z.ZodString;
+    title: z.ZodString;
+    media: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<{
+            image: "image";
+            audio: "audio";
+            video: "video";
+            embed: "embed";
+        }>;
+        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+        alt: z.ZodOptional<z.ZodString>;
+        captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
+        playback: z.ZodOptional<z.ZodObject<{
+            controls: z.ZodOptional<z.ZodEnum<{
+                native: "native";
+                minimal: "minimal";
+            }>>;
+            maxPlays: z.ZodOptional<z.ZodNumber>;
+            seek: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                allow: "allow";
+            }>>;
+            rate: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                fixed: "fixed";
+            }>>;
+            nativeControlHints: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                "hide-download": "hide-download";
+                "hide-rate": "hide-rate";
+            }>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    passThreshold: z.ZodOptional<z.ZodNumber>;
+    locale: z.ZodOptional<z.ZodString>;
+    learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
+}, z.core.$strict>;
 /**
  * The learner-safe SHAPE of each built-in type, derived from the strict schema
  * above rather than hand-written beside it.
@@ -1369,6 +1542,10 @@ type RedactedGapSelectBank = z.infer<typeof RedactedGapSelectBankSchema>;
 type RedactedGapSelectGap = z.infer<typeof RedactedGapSelectGapSchema>;
 /** A Gap Select item the learner can still answer: choices intact, answer key gone. */
 type RedactedGapSelectData = z.infer<typeof RedactedGapSelectDataSchema>;
+/** The slower recording of a dictation, unchanged by redaction. */
+type RedactedDictationSlowMedia = z.infer<typeof RedactedDictationSlowMediaSchema>;
+/** A Dictation item with its transcript, accepted alternatives and tolerances removed. */
+type RedactedDictationData = z.infer<typeof RedactedDictationDataSchema>;
 /**
  * Discriminated union of every built-in redacted activity. Narrow it on
  * `type`, exactly as you would {@link ActivityData}:
@@ -1381,7 +1558,7 @@ type RedactedGapSelectData = z.infer<typeof RedactedGapSelectDataSchema>;
  * }
  * ```
  */
-type RedactedActivity = RedactedMultipleChoiceData | RedactedFillInTheBlanksData | RedactedWrittenResponseData | RedactedGapSelectData;
+type RedactedActivity = RedactedMultipleChoiceData | RedactedFillInTheBlanksData | RedactedWrittenResponseData | RedactedGapSelectData | RedactedDictationData;
 
 /** Zod schema for a single rubric criterion. Loose: unknown keys preserved. */
 declare const WrittenResponseRubricCriterionSchema: z.ZodObject<{
@@ -1478,4 +1655,4 @@ declare const WrittenResponseDataSchema: z.ZodObject<{
  */
 declare function validateActivity<T extends ActivityType>(type: T, data: unknown): ValidationResult<ActivityDataMap[T]>;
 
-export { itemGroupJsonSchema as $, type RedactedMultipleChoiceOption as A, BlankConfigSchema as B, type RedactedMultipleChoiceOptionMedia as C, RedactedMultipleChoiceOptionMediaSchema as D, RedactedMultipleChoiceOptionSchema as E, FeedbackSchema as F, GapSelectBankSchema as G, type RedactedStimulus as H, type ItemGroup as I, RedactedStimulusSchema as J, type RedactedWrittenResponseData as K, RedactedWrittenResponseDataSchema as L, MediaPlaybackSchema as M, NativeControlHintSchema as N, type SequenceSlot as O, type SequenceSlotGroup as P, type Stimulus as Q, type RedactedActivity as R, type SequenceEntry as S, type StimulusKind as T, StimulusSchema as U, TextMatchPolicySchema as V, WrittenResponseDataSchema as W, WrittenResponseRubricCriterionSchema as X, WrittenResponseRubricSchema as Y, fillInTheBlanksJsonSchema as Z, gapSelectJsonSchema as _, FillInTheBlanksDataSchema as a, jsonSchemaFor as a0, multipleChoiceJsonSchema as a1, stimulusJsonSchema as a2, validateActivity as a3, validateItemGroup as a4, writtenResponseJsonSchema as a5, GapSelectChoiceSchema as b, GapSelectDataSchema as c, GapSelectGapSchema as d, ItemGroupSchema as e, MediaSchema as f, MediaUrlSchema as g, MultipleChoiceDataSchema as h, MultipleChoiceOptionMediaSchema as i, MultipleChoiceOptionSchema as j, type RedactedBlankConfig as k, RedactedBlankConfigSchema as l, type RedactedFillInTheBlanksData as m, RedactedFillInTheBlanksDataSchema as n, type RedactedGapSelectBank as o, RedactedGapSelectBankSchema as p, type RedactedGapSelectChoice as q, RedactedGapSelectChoiceSchema as r, type RedactedGapSelectData as s, RedactedGapSelectDataSchema as t, type RedactedGapSelectGap as u, RedactedGapSelectGapSchema as v, RedactedItemGroupSchema as w, RedactedMediaSchema as x, type RedactedMultipleChoiceData as y, RedactedMultipleChoiceDataSchema as z };
+export { type StimulusKind as $, RedactedGapSelectDataSchema as A, BlankConfigSchema as B, type RedactedGapSelectGap as C, DictationDataSchema as D, RedactedGapSelectGapSchema as E, FeedbackSchema as F, GapSelectBankSchema as G, RedactedItemGroupSchema as H, type ItemGroup as I, RedactedMediaSchema as J, type RedactedMultipleChoiceData as K, RedactedMultipleChoiceDataSchema as L, MediaPlaybackSchema as M, NativeControlHintSchema as N, type RedactedMultipleChoiceOption as O, type RedactedMultipleChoiceOptionMedia as P, RedactedMultipleChoiceOptionMediaSchema as Q, type RedactedActivity as R, RedactedMultipleChoiceOptionSchema as S, type RedactedStimulus as T, RedactedStimulusSchema as U, type RedactedWrittenResponseData as V, RedactedWrittenResponseDataSchema as W, type SequenceEntry as X, type SequenceSlot as Y, type SequenceSlotGroup as Z, type Stimulus as _, DictationEquivalenceSchema as a, StimulusSchema as a0, TextMatchPolicySchema as a1, WrittenResponseDataSchema as a2, WrittenResponseRubricCriterionSchema as a3, WrittenResponseRubricSchema as a4, dictationJsonSchema as a5, fillInTheBlanksJsonSchema as a6, gapSelectJsonSchema as a7, itemGroupJsonSchema as a8, jsonSchemaFor as a9, multipleChoiceJsonSchema as aa, stimulusJsonSchema as ab, validateActivity as ac, validateItemGroup as ad, writtenResponseJsonSchema as ae, DictationSlowMediaSchema as b, DictationToleranceSchema as c, FillInTheBlanksDataSchema as d, GapSelectChoiceSchema as e, GapSelectDataSchema as f, GapSelectGapSchema as g, ItemGroupSchema as h, MediaSchema as i, MediaUrlSchema as j, MultipleChoiceDataSchema as k, MultipleChoiceOptionMediaSchema as l, MultipleChoiceOptionSchema as m, type RedactedBlankConfig as n, RedactedBlankConfigSchema as o, type RedactedDictationData as p, RedactedDictationDataSchema as q, type RedactedDictationSlowMedia as r, RedactedDictationSlowMediaSchema as s, type RedactedFillInTheBlanksData as t, RedactedFillInTheBlanksDataSchema as u, type RedactedGapSelectBank as v, RedactedGapSelectBankSchema as w, type RedactedGapSelectChoice as x, RedactedGapSelectChoiceSchema as y, type RedactedGapSelectData as z };

package/dist/{index-CRKtWP5G.d.ts → index-CJbbVE9o.d.ts}

@@ -1,4 +1,4 @@
-import { A as ActivityData, c as ActivityMedia, z as ValidationResult, e as ActivityType, a as ActivityDataMap } from './activity-B2QxK15j.js';
+import { A as ActivityData, c as ActivityMedia, P as ValidationResult, e as ActivityType, a as ActivityDataMap } from './activity-DfAmJ1sl.js';
 import { z } from 'zod/v4';
 
 /** What a stimulus primarily is. Drives validation and layout, never scoring. */
@@ -134,6 +134,94 @@ interface SequenceSlot<TItem = ActivityData> {
     group?: SequenceSlotGroup;
 }
 
+/**
+ * Zod schema for the slower second recording of a dictation. Loose like every
+ * content schema (a sidecar survives), audio only, and — deliberately — with no
+ * `captionsUrl` and no `playback` of its own; the activity-level guards below
+ * refuse both if an author writes them anyway.
+ */
+declare const DictationSlowMediaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"audio">;
+    url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+    alt: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/**
+ * Zod schema for one whole-word rewrite rule. Both halves are bounded: `to`
+ * because a rule expands text, `from` because it is compiled into the pattern
+ * every attempt is searched with.
+ */
+declare const DictationEquivalenceSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, z.core.$loose>;
+/** Zod schema for a dictation's grading tolerances. At most `DICTATION_MAX_EQUIVALENCES` rules. */
+declare const DictationToleranceSchema: z.ZodObject<{
+    equivalences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+declare const DictationDataSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    type: z.ZodLiteral<"dictation">;
+    id: z.ZodString;
+    title: z.ZodString;
+    transcript: z.ZodString;
+    acceptedTranscripts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    media: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<{
+            image: "image";
+            audio: "audio";
+            video: "video";
+            embed: "embed";
+        }>;
+        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+        alt: z.ZodOptional<z.ZodString>;
+        captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
+        playback: z.ZodOptional<z.ZodObject<{
+            controls: z.ZodOptional<z.ZodEnum<{
+                native: "native";
+                minimal: "minimal";
+            }>>;
+            maxPlays: z.ZodOptional<z.ZodNumber>;
+            seek: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                allow: "allow";
+            }>>;
+            rate: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                fixed: "fixed";
+            }>>;
+            nativeControlHints: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                "hide-download": "hide-download";
+                "hide-rate": "hide-rate";
+            }>>>;
+        }, z.core.$strict>>;
+    }, z.core.$loose>>;
+    slowMedia: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"audio">;
+        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+        alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    hints: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodLiteral<"progressive-words">;
+    }, z.core.$loose>>;
+    tolerance: z.ZodOptional<z.ZodObject<{
+        equivalences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+    feedback: z.ZodOptional<z.ZodObject<{
+        correct: z.ZodOptional<z.ZodString>;
+        incorrect: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    passThreshold: z.ZodOptional<z.ZodNumber>;
+    locale: z.ZodOptional<z.ZodString>;
+    learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
+}, z.core.$loose>;
+
 /**
  * Optional authored "overall feedback" shown after submission, selected by
  * whether the learner passed (h5p-style overall feedback). Both fields are
@@ -566,7 +654,10 @@ declare const RedactedStimulusSchema: z.ZodObject<{
 /**
  * Strict learner-safe item group. Items are left opaque here — each is proven
  * learner-safe by `assertRedacted` against its OWN type's redacted schema,
- * which is the only place that knowledge lives.
+ * which is the only place that knowledge lives. The one exception is the one
+ * rule that spans the container and an item: a captioned stimulus recording
+ * played to a dictation is not learner-safe, because the captions are the
+ * dictation's answer.
  */
 declare const RedactedItemGroupSchema: z.ZodObject<{
     redacted: z.ZodLiteral<true>;
@@ -669,6 +760,17 @@ declare const itemGroupJsonSchema: z.core.JSONSchema.JSONSchema;
  * for the other types.
  */
 declare const gapSelectJsonSchema: z.core.JSONSchema.JSONSchema;
+/**
+ * JSON Schema (Draft 7) representation of the Dictation activity data
+ * contract. Structural contract, plus the raw length caps JSON Schema can
+ * state in code points as zod counts them — `maxLength` 2000 on a transcript
+ * and an accepted transcript, 200 on a rule's `from` and `to`. The twelve
+ * semantic guards — a transcript that survives normalisation, the caps after
+ * equivalences are applied, distinct candidates, audio only, the
+ * slow-recording rules, no captions, no transcript in the title — are
+ * Zod-only, as they are for the other types.
+ */
+declare const dictationJsonSchema: z.core.JSONSchema.JSONSchema;
 declare const multipleChoiceJsonSchema: z.core.JSONSchema.JSONSchema;
 /**
  * JSON Schema (Draft 7) representation of the Fill-in-the-Blanks activity data
@@ -1335,6 +1437,77 @@ declare const RedactedWrittenResponseDataSchema: z.ZodObject<{
     learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
     difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
 }, z.core.$strict>;
+/** A redacted slow recording: unchanged — it is public, and it never carried captions or a policy. */
+declare const RedactedDictationSlowMediaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"audio">;
+    url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+    alt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Redacted Dictation data: the recording(s) and the hint mode survive; the
+ * transcript, the accepted alternatives and the tolerance — the whole answer
+ * key — do not. A `progressive-words` hint mode reveals nothing by itself: the
+ * words it would reveal are the transcript, and that is gone.
+ *
+ * Three rules of the content schema are repeated here, because a projection
+ * built by hand never passed through it: captions on the recording ARE the
+ * answer, so a payload carrying them is not learner-safe; a slow recording
+ * beside a play budget is an unbudgeted copy of the budgeted content; and so is
+ * a slow recording with no recording beside it, which in a group sits beside a
+ * stimulus recording that may be budgeted.
+ */
+declare const RedactedDictationDataSchema: z.ZodObject<{
+    type: z.ZodLiteral<"dictation">;
+    slowMedia: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"audio">;
+        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+        alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    hints: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodLiteral<"progressive-words">;
+    }, z.core.$strict>>;
+    /** Marker distinguishing a redacted projection from full activity data. */
+    redacted: z.ZodLiteral<true>;
+    /** Slot identity, carried through redaction so the client and the plan agree. */
+    slotKey: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<"1.0">;
+    id: z.ZodString;
+    title: z.ZodString;
+    media: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<{
+            image: "image";
+            audio: "audio";
+            video: "video";
+            embed: "embed";
+        }>;
+        url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
+        alt: z.ZodOptional<z.ZodString>;
+        captionsUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
+        playback: z.ZodOptional<z.ZodObject<{
+            controls: z.ZodOptional<z.ZodEnum<{
+                native: "native";
+                minimal: "minimal";
+            }>>;
+            maxPlays: z.ZodOptional<z.ZodNumber>;
+            seek: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                allow: "allow";
+            }>>;
+            rate: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                fixed: "fixed";
+            }>>;
+            nativeControlHints: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                "hide-download": "hide-download";
+                "hide-rate": "hide-rate";
+            }>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    passThreshold: z.ZodOptional<z.ZodNumber>;
+    locale: z.ZodOptional<z.ZodString>;
+    learningObjectives: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    difficultyLevel: z.ZodOptional<z.ZodLiteral<2 | 1 | 3 | 4 | 5>>;
+}, z.core.$strict>;
 /**
  * The learner-safe SHAPE of each built-in type, derived from the strict schema
  * above rather than hand-written beside it.
@@ -1369,6 +1542,10 @@ type RedactedGapSelectBank = z.infer<typeof RedactedGapSelectBankSchema>;
 type RedactedGapSelectGap = z.infer<typeof RedactedGapSelectGapSchema>;
 /** A Gap Select item the learner can still answer: choices intact, answer key gone. */
 type RedactedGapSelectData = z.infer<typeof RedactedGapSelectDataSchema>;
+/** The slower recording of a dictation, unchanged by redaction. */
+type RedactedDictationSlowMedia = z.infer<typeof RedactedDictationSlowMediaSchema>;
+/** A Dictation item with its transcript, accepted alternatives and tolerances removed. */
+type RedactedDictationData = z.infer<typeof RedactedDictationDataSchema>;
 /**
  * Discriminated union of every built-in redacted activity. Narrow it on
  * `type`, exactly as you would {@link ActivityData}:
@@ -1381,7 +1558,7 @@ type RedactedGapSelectData = z.infer<typeof RedactedGapSelectDataSchema>;
  * }
  * ```
  */
-type RedactedActivity = RedactedMultipleChoiceData | RedactedFillInTheBlanksData | RedactedWrittenResponseData | RedactedGapSelectData;
+type RedactedActivity = RedactedMultipleChoiceData | RedactedFillInTheBlanksData | RedactedWrittenResponseData | RedactedGapSelectData | RedactedDictationData;
 
 /** Zod schema for a single rubric criterion. Loose: unknown keys preserved. */
 declare const WrittenResponseRubricCriterionSchema: z.ZodObject<{
@@ -1478,4 +1655,4 @@ declare const WrittenResponseDataSchema: z.ZodObject<{
  */
 declare function validateActivity<T extends ActivityType>(type: T, data: unknown): ValidationResult<ActivityDataMap[T]>;
 
-export { itemGroupJsonSchema as $, type RedactedMultipleChoiceOption as A, BlankConfigSchema as B, type RedactedMultipleChoiceOptionMedia as C, RedactedMultipleChoiceOptionMediaSchema as D, RedactedMultipleChoiceOptionSchema as E, FeedbackSchema as F, GapSelectBankSchema as G, type RedactedStimulus as H, type ItemGroup as I, RedactedStimulusSchema as J, type RedactedWrittenResponseData as K, RedactedWrittenResponseDataSchema as L, MediaPlaybackSchema as M, NativeControlHintSchema as N, type SequenceSlot as O, type SequenceSlotGroup as P, type Stimulus as Q, type RedactedActivity as R, type SequenceEntry as S, type StimulusKind as T, StimulusSchema as U, TextMatchPolicySchema as V, WrittenResponseDataSchema as W, WrittenResponseRubricCriterionSchema as X, WrittenResponseRubricSchema as Y, fillInTheBlanksJsonSchema as Z, gapSelectJsonSchema as _, FillInTheBlanksDataSchema as a, jsonSchemaFor as a0, multipleChoiceJsonSchema as a1, stimulusJsonSchema as a2, validateActivity as a3, validateItemGroup as a4, writtenResponseJsonSchema as a5, GapSelectChoiceSchema as b, GapSelectDataSchema as c, GapSelectGapSchema as d, ItemGroupSchema as e, MediaSchema as f, MediaUrlSchema as g, MultipleChoiceDataSchema as h, MultipleChoiceOptionMediaSchema as i, MultipleChoiceOptionSchema as j, type RedactedBlankConfig as k, RedactedBlankConfigSchema as l, type RedactedFillInTheBlanksData as m, RedactedFillInTheBlanksDataSchema as n, type RedactedGapSelectBank as o, RedactedGapSelectBankSchema as p, type RedactedGapSelectChoice as q, RedactedGapSelectChoiceSchema as r, type RedactedGapSelectData as s, RedactedGapSelectDataSchema as t, type RedactedGapSelectGap as u, RedactedGapSelectGapSchema as v, RedactedItemGroupSchema as w, RedactedMediaSchema as x, type RedactedMultipleChoiceData as y, RedactedMultipleChoiceDataSchema as z };
+export { type StimulusKind as $, RedactedGapSelectDataSchema as A, BlankConfigSchema as B, type RedactedGapSelectGap as C, DictationDataSchema as D, RedactedGapSelectGapSchema as E, FeedbackSchema as F, GapSelectBankSchema as G, RedactedItemGroupSchema as H, type ItemGroup as I, RedactedMediaSchema as J, type RedactedMultipleChoiceData as K, RedactedMultipleChoiceDataSchema as L, MediaPlaybackSchema as M, NativeControlHintSchema as N, type RedactedMultipleChoiceOption as O, type RedactedMultipleChoiceOptionMedia as P, RedactedMultipleChoiceOptionMediaSchema as Q, type RedactedActivity as R, RedactedMultipleChoiceOptionSchema as S, type RedactedStimulus as T, RedactedStimulusSchema as U, type RedactedWrittenResponseData as V, RedactedWrittenResponseDataSchema as W, type SequenceEntry as X, type SequenceSlot as Y, type SequenceSlotGroup as Z, type Stimulus as _, DictationEquivalenceSchema as a, StimulusSchema as a0, TextMatchPolicySchema as a1, WrittenResponseDataSchema as a2, WrittenResponseRubricCriterionSchema as a3, WrittenResponseRubricSchema as a4, dictationJsonSchema as a5, fillInTheBlanksJsonSchema as a6, gapSelectJsonSchema as a7, itemGroupJsonSchema as a8, jsonSchemaFor as a9, multipleChoiceJsonSchema as aa, stimulusJsonSchema as ab, validateActivity as ac, validateItemGroup as ad, writtenResponseJsonSchema as ae, DictationSlowMediaSchema as b, DictationToleranceSchema as c, FillInTheBlanksDataSchema as d, GapSelectChoiceSchema as e, GapSelectDataSchema as f, GapSelectGapSchema as g, ItemGroupSchema as h, MediaSchema as i, MediaUrlSchema as j, MultipleChoiceDataSchema as k, MultipleChoiceOptionMediaSchema as l, MultipleChoiceOptionSchema as m, type RedactedBlankConfig as n, RedactedBlankConfigSchema as o, type RedactedDictationData as p, RedactedDictationDataSchema as q, type RedactedDictationSlowMedia as r, RedactedDictationSlowMediaSchema as s, type RedactedFillInTheBlanksData as t, RedactedFillInTheBlanksDataSchema as u, type RedactedGapSelectBank as v, RedactedGapSelectBankSchema as w, type RedactedGapSelectChoice as x, RedactedGapSelectChoiceSchema as y, type RedactedGapSelectData as z };