@intellectif/lk-core 1.2.0 → 1.4.0

package/dist/index-2nigSf4N.d.cts

@@ -0,0 +1,339 @@
+import { St as ActivityMedia, Xt as MultipleChoiceOptionMedia, bt as ActivityDataMap, ln as ValidationResult, tt as ItemGroup, wt as ActivityType } from "./ai-CnmLPMzd.cjs";
+//#region src/types/redacted.d.ts
+/**
+ * The learner-safe SHAPE of each built-in type.
+ *
+ * `redact()` returns `RedactedActivityData`, which proves a payload is
+ * learner-safe but is index-signature typed — it deliberately says nothing
+ * about what the payload still CONTAINS. That is right for the assertion and
+ * useless for anything that has to render or transport the result, so every
+ * integrator would end up re-declaring these interfaces by hand, and they would
+ * drift the moment a schema changed.
+ *
+ * Use them for the payload a server sends an exam client, and for the props of
+ * a renderer that must never see an answer key.
+ *
+ * Each is pinned to the strict schema `assertRedacted` checks against by a
+ * compile-time equality test, so the type and the validator cannot disagree.
+ * They are written out rather than inferred from those schemas so that the
+ * published types name no validation library.
+ */
+/** A caption or subtitle track, unchanged by redaction. */
+interface Track {
+  kind: 'captions' | 'subtitles';
+  src: string;
+  srclang: string;
+  label: string;
+  default?: boolean | undefined;
+}
+/** A recording's playback policy, unchanged by redaction. */
+interface Playback {
+  controls?: 'native' | 'minimal' | undefined;
+  maxPlays?: number | undefined;
+  seek?: 'allow' | 'none' | undefined;
+  rate?: 'allow' | 'fixed' | undefined;
+  nativeControlHints?: ('hide-download' | 'hide-rate')[] | undefined;
+}
+/** An item's or a stimulus's media, unchanged by redaction. */
+interface Media {
+  type: 'image' | 'audio' | 'video' | 'embed';
+  url: string;
+  alt?: string | undefined;
+  captionsUrl?: string | undefined;
+  tracks?: Track[] | undefined;
+  poster?: string | undefined;
+  playback?: Playback | undefined;
+}
+/** The author's switches for AI help, unchanged by redaction. */
+interface AiSwitches {
+  explanations?: boolean | undefined;
+  hints?: boolean | undefined;
+}
+/** What every redacted item carries, whatever its type. */
+interface RedactedItem {
+  redacted: true;
+  schemaVersion: '1.0';
+  id: string;
+  title: string;
+  slotKey?: string | undefined;
+  media?: Media | undefined;
+  passThreshold?: number | undefined;
+  learningObjectives?: string[] | undefined;
+  difficultyLevel?: 1 | 2 | 3 | 4 | 5 | undefined;
+  ai?: AiSwitches | undefined;
+}
+/** An option's picture or recording, unchanged by redaction — it is what the learner picks. */
+interface RedactedMultipleChoiceOptionMedia {
+  type: 'image' | 'audio';
+  url: string;
+  alt?: string | undefined;
+  captionsUrl?: string | undefined;
+}
+/** An option with `isCorrect` and its feedback removed. */
+interface RedactedMultipleChoiceOption {
+  id: string;
+  text: string;
+  media?: RedactedMultipleChoiceOptionMedia | undefined;
+}
+/** A Multiple Choice item with the answer key, feedback and strategy removed. */
+interface RedactedMultipleChoiceData extends RedactedItem {
+  type: 'multiple-choice';
+  question: string;
+  questionHtml?: string | undefined;
+  mode: 'single' | 'multi';
+  options: RedactedMultipleChoiceOption[];
+  shuffle?: boolean | undefined;
+  locale?: string | undefined;
+}
+/** A blank with its accepted answers and matching rules removed; the hint survives. */
+interface RedactedBlankConfig {
+  id: string;
+  hint?: string | undefined;
+}
+/** A Fill-in-the-Blanks item with every accepted answer removed. */
+interface RedactedFillInTheBlanksData extends RedactedItem {
+  type: 'fill-in-the-blanks';
+  passage: string;
+  passageHtml?: string | undefined;
+  blanks: RedactedBlankConfig[];
+  locale?: string | undefined;
+}
+/** A Written Response item; the rubric survives, because it tells the learner what is assessed. */
+interface RedactedWrittenResponseData extends RedactedItem {
+  type: 'written-response';
+  prompt: string;
+  promptHtml?: string | undefined;
+  minWords: number;
+  maxWords: number;
+  rubric?: {
+    criteria: {
+      name: string;
+      weight: number;
+      description?: string | undefined;
+    }[];
+    label?: string | undefined;
+  } | undefined;
+  languageTarget?: string | undefined;
+  locale?: string | undefined;
+}
+/** A selectable choice, unchanged by redaction. */
+interface RedactedGapSelectChoice {
+  id: string;
+  text: string;
+}
+/** A word bank, unchanged by redaction — the learner picks from it. */
+interface RedactedGapSelectBank {
+  id: string;
+  choices: RedactedGapSelectChoice[];
+}
+/** A gap with its `correctChoiceId` removed; every choice it offers survives. */
+interface RedactedGapSelectGap {
+  id: string;
+  choices?: RedactedGapSelectChoice[] | undefined;
+  bankId?: string | undefined;
+}
+/** A Gap Select item the learner can still answer: choices intact, answer key gone. */
+interface RedactedGapSelectData extends RedactedItem {
+  type: 'gap-select';
+  passage: string;
+  passageHtml?: string | undefined;
+  gaps: RedactedGapSelectGap[];
+  banks?: RedactedGapSelectBank[] | undefined;
+  presentation?: 'dropdown' | undefined;
+  shuffleChoices?: boolean | undefined;
+  locale?: string | undefined;
+}
+/** The slower recording of a dictation, unchanged by redaction. */
+interface RedactedDictationSlowMedia {
+  type: 'audio';
+  url: string;
+  alt?: string | undefined;
+}
+/** A Dictation item with its transcript, accepted alternatives and tolerances removed. */
+interface RedactedDictationData extends RedactedItem {
+  type: 'dictation';
+  slowMedia?: RedactedDictationSlowMedia | undefined;
+  hints?: {
+    mode: 'progressive-words';
+  } | undefined;
+  locale?: string | undefined;
+}
+/**
+ * A Read Aloud item, which keeps everything but the authored feedback: the text
+ * to read is what the learner is asked to read. The slow recording needs no
+ * redacted counterpart of its own — the content schema for it is already strict.
+ */
+interface RedactedReadAloudData extends RedactedItem {
+  type: 'read-aloud';
+  instructions?: string | undefined;
+  referenceText: string;
+  locale: string;
+  slowMedia?: RedactedDictationSlowMedia | undefined;
+  recording: {
+    maxSeconds: number;
+    minSeconds?: number | undefined;
+    maxTakes?: number | undefined;
+  };
+  scoring: {
+    dimensions: {
+      name: 'accuracy' | 'fluency' | 'completeness' | 'prosody';
+      weight: number;
+    }[];
+  };
+}
+/** A stimulus as a learner receives it: everything but the author-only `transcript`. */
+interface RedactedStimulus {
+  id: string;
+  kind: 'text' | 'image' | 'audio' | 'video' | 'mixed';
+  title?: string | undefined;
+  body?: string | undefined;
+  bodyHtml?: string | undefined;
+  media?: Media | undefined;
+  locale?: string | undefined;
+  attribution?: string | undefined;
+}
+/**
+ * Discriminated union of every built-in redacted activity. Narrow it on
+ * `type`, exactly as you would `ActivityData`:
+ *
+ * ```ts
+ * function render(item: RedactedActivity) {
+ *   if (item.type === 'multiple-choice') {
+ *     return item.options.map((option) => option.text); // no `isCorrect` to leak
+ *   }
+ * }
+ * ```
+ */
+type RedactedActivity = RedactedMultipleChoiceData | RedactedFillInTheBlanksData | RedactedWrittenResponseData | RedactedGapSelectData | RedactedDictationData | RedactedReadAloudData;
+//#endregion
+//#region src/schemas/item-group.d.ts
+/**
+ * Validates an item group in full: the container and stimulus against
+ * {@link ItemGroupSchema}, then every item against the schema registered for
+ * its `type`. Errors from items are reported at `items.<index>.…`.
+ *
+ * Unlike `validateActivity`, an item whose type is not registered is REPORTED
+ * (code `unknown_activity_type`) rather than thrown: a group is validated as
+ * a whole, and an author fixing a six-item group wants every problem listed,
+ * not the first one that happened to throw.
+ */
+declare function validateItemGroup(data: unknown): ValidationResult<ItemGroup>;
+//#endregion
+//#region src/schemas/json-schema.d.ts
+/**
+ * JSON Schema (Draft 7) for a `Stimulus`. Structural contract only — the
+ * kind/media/body consistency guards are Zod-only.
+ */
+declare const stimulusJsonSchema: Record<string, unknown>;
+/**
+ * JSON Schema (Draft 7) for an `ItemGroup` CONTAINER. Items appear as objects
+ * with `type` and `id` only; each item's own contract is `jsonSchemaFor(type)`.
+ * For an AI generation pipeline, ask for the group and each item separately
+ * rather than a single nested schema — that keeps the per-type schema the
+ * registry's, not a copy.
+ */
+declare const itemGroupJsonSchema: Record<string, unknown>;
+/**
+ * JSON Schema (Draft 7) representation of the Multiple Choice activity data
+ * contract, generated natively by Zod 4. Draft 7 is mandated by Requirement
+ * 2.2 for the widest AI-prompt / OpenAPI tooling compatibility. The semantic
+ * `.refine()` guards are not representable in JSON Schema and are
+ * intentionally omitted — the export captures the *structural* contract only.
+ * Since v0.3 the source schemas are loose, so these no longer emit
+ * `additionalProperties: false` — the JSON Schema and `validateActivity` now
+ * agree on unknown-key handling.
+ */
+/**
+ * JSON Schema (Draft 7) representation of the Gap Select activity data
+ * contract. Structural contract only: the six semantic guards — the
+ * passage/gap bijection, id uniqueness, the one-choice-source rule, and an
+ * answer key that names a choice the gap offers — are Zod-only, as they are
+ * for the other types.
+ */
+declare const gapSelectJsonSchema: Record<string, unknown>;
+/**
+ * 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: Record<string, unknown>;
+/**
+ * JSON Schema (Draft 7) representation of the Read Aloud activity data
+ * contract. Structural contract, plus the raw cap JSON Schema can state in code
+ * points as zod counts them — `maxLength` 2000 on the reference text — and the
+ * canonical locale pattern. The ten semantic guards — the cap after
+ * normalisation, a text that survives it, the spaced-script rule, the
+ * model-recording rules, unique dimensions, a weight above 0, and the take
+ * bounds — are Zod-only, as they are for the other types.
+ */
+declare const readAloudJsonSchema: Record<string, unknown>;
+declare const multipleChoiceJsonSchema: Record<string, unknown>;
+/**
+ * JSON Schema (Draft 7) representation of the Fill-in-the-Blanks activity data
+ * contract, generated natively by Zod 4. Structural contract only (semantic
+ * `.refine()` guards are Zod-only and not representable in JSON Schema).
+ */
+declare const fillInTheBlanksJsonSchema: Record<string, unknown>;
+/**
+ * JSON Schema (Draft 7) representation of the Written Response activity data
+ * contract. Structural contract only.
+ */
+declare const writtenResponseJsonSchema: Record<string, unknown>;
+/**
+ * Derives the JSON Schema (Draft 7) for any REGISTERED activity type — the
+ * live, registry-backed replacement for the static per-type exports above,
+ * and the building block for AI generation pipelines (R6.1): pass the result
+ * as a structured-output schema so a model can only emit valid items.
+ *
+ * For a type you registered, it is the descriptor's `jsonSchema` when you gave
+ * one, or else what the schema produces through the Standard JSON Schema
+ * converter (`'~standard'.jsonSchema`) — a zod 4.6 schema has one. A fresh copy
+ * every call.
+ *
+ * @throws UnknownActivityTypeError when `type` has no registered descriptor.
+ * @throws Error when a registered type has neither a `jsonSchema` nor a schema
+ *   that can produce one.
+ */
+declare function jsonSchemaFor(type: string): Record<string, unknown>;
+//#endregion
+//#region src/schemas/index.d.ts
+/**
+ * Checks a piece of activity media — an item's `media`, a stimulus's, a
+ * dictation's `slowMedia` — on its own, the way `validateActivity` checks it
+ * inside an item: its kind, an address in the allowed schemes, a playback
+ * policy only on audio, captions and tracks only where they can play. For an
+ * editor's media picker, which holds the media before the item is whole.
+ *
+ * @returns `{ success: true, data }`, or `{ success: false, errors }` with the
+ *   same codes, paths and messages `validateActivity` reports.
+ */
+declare function validateMedia(value: unknown): ValidationResult<ActivityMedia>;
+/**
+ * Checks a multiple-choice option's `media` on its own: a picture or a
+ * recording, at an address in the allowed schemes, with no playback policy.
+ *
+ * @returns `{ success: true, data }`, or `{ success: false, errors }` with the
+ *   same codes, paths and messages `validateActivity` reports.
+ */
+declare function validateOptionMedia(value: unknown): ValidationResult<MultipleChoiceOptionMedia>;
+/**
+ * Validates raw activity data against the schema registered for the given
+ * activity type (built-in or consumer-registered via `registerActivityType`).
+ *
+ * Unknown keys are PRESERVED, not stripped: every built-in schema is loose,
+ * so consumer sidecar fields and forward-version fields survive validation
+ * verbatim in the returned `data`.
+ *
+ * @returns `{ success: true, data }` with the typed, validated data, or
+ *          `{ success: false, errors }` with one entry per failed constraint.
+ * @throws UnknownActivityTypeError when `type` has no registered descriptor.
+ */
+declare function validateActivity<T extends ActivityType>(type: T, data: unknown): ValidationResult<ActivityDataMap[T]>;
+//#endregion
+export { RedactedMultipleChoiceData as C, RedactedStimulus as D, RedactedReadAloudData as E, RedactedWrittenResponseData as O, RedactedGapSelectGap as S, RedactedMultipleChoiceOptionMedia as T, RedactedDictationSlowMedia as _, fillInTheBlanksJsonSchema as a, RedactedGapSelectChoice as b, jsonSchemaFor as c, stimulusJsonSchema as d, writtenResponseJsonSchema as f, RedactedDictationData as g, RedactedBlankConfig as h, dictationJsonSchema as i, multipleChoiceJsonSchema as l, RedactedActivity as m, validateMedia as n, gapSelectJsonSchema as o, validateItemGroup as p, validateOptionMedia as r, itemGroupJsonSchema as s, validateActivity as t, readAloudJsonSchema as u, RedactedFillInTheBlanksData as v, RedactedMultipleChoiceOption as w, RedactedGapSelectData as x, RedactedGapSelectBank as y };
+//# sourceMappingURL=index-2nigSf4N.d.cts.map

package/dist/index-2nigSf4N.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-2nigSf4N.d.cts","names":[],"sources":["../src/types/redacted.ts","../src/schemas/item-group.ts","../src/schemas/json-schema.ts","../src/schemas/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;UAoBU;EACR;EACA;EACA;EACA;EACA;;;UAIQ;EACR;EACA;EACA;EACA;EACA;;;UAIQ;EACR;EACA;EACA;EACA;EACA,SAAS;EACT;EACA,WAAW;;;UAIH;EACR;EACA;;;UAIQ;EACR;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;EACA,KAAK;;;UAIU;EACf;EACA;EACA;EACA;;;UAIe;EACf;EACA;EACA,QAAQ;;;UAIO,mCAAmC;EAClD;EACA;EACA;EACA;EACA,SAAS;EACT;EACA;;;UAIe;EACf;EACA;;;UAIe,oCAAoC;EACnD;EACA;EACA;EACA,QAAQ;EACR;;;UAIe,oCAAoC;EACnD;EACA;EACA;EACA;EACA;EACA;IAEM;MAAY;MAAc;MAAgB;;IAC1C;;EAGN;EACA;;;UAIe;EACf;EACA;;;UAIe;EACf;EACA,SAAS;;;UAIM;EACf;EACA,UAAU;EACV;;;UAIe,8BAA8B;EAC7C;EACA;EACA;EACA,MAAM;EACN,QAAQ;EACR;EACA;EACA;;;UAIe;EACf;EACA;EACA;;;UAIe,8BAA8B;EAC7C;EACA,YAAY;EACZ;IAAU;;EACV;;;;;;;UAQe,8BAA8B;EAC7C;EACA;EACA;EACA;EACA,YAAY;EACZ;IACE;IACA;IACA;;EAEF;IACE;MACE;MACA;;;;;UAMW;EACf;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR;EACA;;;;;;;;;;;;;;KAeU,mBACR,6BACA,8BACA,8BACA,wBACA,wBACA;;;;;;;;;;;;;iBCgNY,kBAAkB,gBAAgB,iBAAiB;;;;;;;cClatD,oBAAoB;;;;;;;;cAWpB,qBAAqB;;;;;;;;;;;;;;;;;;cAqBrB,qBAAqB;;;;;;;;;;;cAcrB,qBAAqB;;;;;;;;;;cAarB,qBAAqB;cAIrB,0BAA0B;;;;;;cAY1B,2BAA2B;;;;;cAW3B,2BAA2B;;;;;;;;;;;;;;;;iBAsBxB,cAAc,eAAe;;;;;;;;;;;;;iBCvE7B,cAAc,iBAAiB,iBAAiB;;;;;;;;iBAWhD,oBAAoB,iBAAiB,iBAAiB;;;;;;;;;;;;;iBA8BtD,iBAAiB,UAAU,cACzC,MAAM,GACN,gBACC,iBAAiB,gBAAgB"}

package/dist/index-B54baFUA.d.ts

@@ -0,0 +1,339 @@
+import { St as ActivityMedia, Xt as MultipleChoiceOptionMedia, bt as ActivityDataMap, ln as ValidationResult, tt as ItemGroup, wt as ActivityType } from "./ai-CnmLPMzd.js";
+//#region src/types/redacted.d.ts
+/**
+ * The learner-safe SHAPE of each built-in type.
+ *
+ * `redact()` returns `RedactedActivityData`, which proves a payload is
+ * learner-safe but is index-signature typed — it deliberately says nothing
+ * about what the payload still CONTAINS. That is right for the assertion and
+ * useless for anything that has to render or transport the result, so every
+ * integrator would end up re-declaring these interfaces by hand, and they would
+ * drift the moment a schema changed.
+ *
+ * Use them for the payload a server sends an exam client, and for the props of
+ * a renderer that must never see an answer key.
+ *
+ * Each is pinned to the strict schema `assertRedacted` checks against by a
+ * compile-time equality test, so the type and the validator cannot disagree.
+ * They are written out rather than inferred from those schemas so that the
+ * published types name no validation library.
+ */
+/** A caption or subtitle track, unchanged by redaction. */
+interface Track {
+  kind: 'captions' | 'subtitles';
+  src: string;
+  srclang: string;
+  label: string;
+  default?: boolean | undefined;
+}
+/** A recording's playback policy, unchanged by redaction. */
+interface Playback {
+  controls?: 'native' | 'minimal' | undefined;
+  maxPlays?: number | undefined;
+  seek?: 'allow' | 'none' | undefined;
+  rate?: 'allow' | 'fixed' | undefined;
+  nativeControlHints?: ('hide-download' | 'hide-rate')[] | undefined;
+}
+/** An item's or a stimulus's media, unchanged by redaction. */
+interface Media {
+  type: 'image' | 'audio' | 'video' | 'embed';
+  url: string;
+  alt?: string | undefined;
+  captionsUrl?: string | undefined;
+  tracks?: Track[] | undefined;
+  poster?: string | undefined;
+  playback?: Playback | undefined;
+}
+/** The author's switches for AI help, unchanged by redaction. */
+interface AiSwitches {
+  explanations?: boolean | undefined;
+  hints?: boolean | undefined;
+}
+/** What every redacted item carries, whatever its type. */
+interface RedactedItem {
+  redacted: true;
+  schemaVersion: '1.0';
+  id: string;
+  title: string;
+  slotKey?: string | undefined;
+  media?: Media | undefined;
+  passThreshold?: number | undefined;
+  learningObjectives?: string[] | undefined;
+  difficultyLevel?: 1 | 2 | 3 | 4 | 5 | undefined;
+  ai?: AiSwitches | undefined;
+}
+/** An option's picture or recording, unchanged by redaction — it is what the learner picks. */
+interface RedactedMultipleChoiceOptionMedia {
+  type: 'image' | 'audio';
+  url: string;
+  alt?: string | undefined;
+  captionsUrl?: string | undefined;
+}
+/** An option with `isCorrect` and its feedback removed. */
+interface RedactedMultipleChoiceOption {
+  id: string;
+  text: string;
+  media?: RedactedMultipleChoiceOptionMedia | undefined;
+}
+/** A Multiple Choice item with the answer key, feedback and strategy removed. */
+interface RedactedMultipleChoiceData extends RedactedItem {
+  type: 'multiple-choice';
+  question: string;
+  questionHtml?: string | undefined;
+  mode: 'single' | 'multi';
+  options: RedactedMultipleChoiceOption[];
+  shuffle?: boolean | undefined;
+  locale?: string | undefined;
+}
+/** A blank with its accepted answers and matching rules removed; the hint survives. */
+interface RedactedBlankConfig {
+  id: string;
+  hint?: string | undefined;
+}
+/** A Fill-in-the-Blanks item with every accepted answer removed. */
+interface RedactedFillInTheBlanksData extends RedactedItem {
+  type: 'fill-in-the-blanks';
+  passage: string;
+  passageHtml?: string | undefined;
+  blanks: RedactedBlankConfig[];
+  locale?: string | undefined;
+}
+/** A Written Response item; the rubric survives, because it tells the learner what is assessed. */
+interface RedactedWrittenResponseData extends RedactedItem {
+  type: 'written-response';
+  prompt: string;
+  promptHtml?: string | undefined;
+  minWords: number;
+  maxWords: number;
+  rubric?: {
+    criteria: {
+      name: string;
+      weight: number;
+      description?: string | undefined;
+    }[];
+    label?: string | undefined;
+  } | undefined;
+  languageTarget?: string | undefined;
+  locale?: string | undefined;
+}
+/** A selectable choice, unchanged by redaction. */
+interface RedactedGapSelectChoice {
+  id: string;
+  text: string;
+}
+/** A word bank, unchanged by redaction — the learner picks from it. */
+interface RedactedGapSelectBank {
+  id: string;
+  choices: RedactedGapSelectChoice[];
+}
+/** A gap with its `correctChoiceId` removed; every choice it offers survives. */
+interface RedactedGapSelectGap {
+  id: string;
+  choices?: RedactedGapSelectChoice[] | undefined;
+  bankId?: string | undefined;
+}
+/** A Gap Select item the learner can still answer: choices intact, answer key gone. */
+interface RedactedGapSelectData extends RedactedItem {
+  type: 'gap-select';
+  passage: string;
+  passageHtml?: string | undefined;
+  gaps: RedactedGapSelectGap[];
+  banks?: RedactedGapSelectBank[] | undefined;
+  presentation?: 'dropdown' | undefined;
+  shuffleChoices?: boolean | undefined;
+  locale?: string | undefined;
+}
+/** The slower recording of a dictation, unchanged by redaction. */
+interface RedactedDictationSlowMedia {
+  type: 'audio';
+  url: string;
+  alt?: string | undefined;
+}
+/** A Dictation item with its transcript, accepted alternatives and tolerances removed. */
+interface RedactedDictationData extends RedactedItem {
+  type: 'dictation';
+  slowMedia?: RedactedDictationSlowMedia | undefined;
+  hints?: {
+    mode: 'progressive-words';
+  } | undefined;
+  locale?: string | undefined;
+}
+/**
+ * A Read Aloud item, which keeps everything but the authored feedback: the text
+ * to read is what the learner is asked to read. The slow recording needs no
+ * redacted counterpart of its own — the content schema for it is already strict.
+ */
+interface RedactedReadAloudData extends RedactedItem {
+  type: 'read-aloud';
+  instructions?: string | undefined;
+  referenceText: string;
+  locale: string;
+  slowMedia?: RedactedDictationSlowMedia | undefined;
+  recording: {
+    maxSeconds: number;
+    minSeconds?: number | undefined;
+    maxTakes?: number | undefined;
+  };
+  scoring: {
+    dimensions: {
+      name: 'accuracy' | 'fluency' | 'completeness' | 'prosody';
+      weight: number;
+    }[];
+  };
+}
+/** A stimulus as a learner receives it: everything but the author-only `transcript`. */
+interface RedactedStimulus {
+  id: string;
+  kind: 'text' | 'image' | 'audio' | 'video' | 'mixed';
+  title?: string | undefined;
+  body?: string | undefined;
+  bodyHtml?: string | undefined;
+  media?: Media | undefined;
+  locale?: string | undefined;
+  attribution?: string | undefined;
+}
+/**
+ * Discriminated union of every built-in redacted activity. Narrow it on
+ * `type`, exactly as you would `ActivityData`:
+ *
+ * ```ts
+ * function render(item: RedactedActivity) {
+ *   if (item.type === 'multiple-choice') {
+ *     return item.options.map((option) => option.text); // no `isCorrect` to leak
+ *   }
+ * }
+ * ```
+ */
+type RedactedActivity = RedactedMultipleChoiceData | RedactedFillInTheBlanksData | RedactedWrittenResponseData | RedactedGapSelectData | RedactedDictationData | RedactedReadAloudData;
+//#endregion
+//#region src/schemas/item-group.d.ts
+/**
+ * Validates an item group in full: the container and stimulus against
+ * {@link ItemGroupSchema}, then every item against the schema registered for
+ * its `type`. Errors from items are reported at `items.<index>.…`.
+ *
+ * Unlike `validateActivity`, an item whose type is not registered is REPORTED
+ * (code `unknown_activity_type`) rather than thrown: a group is validated as
+ * a whole, and an author fixing a six-item group wants every problem listed,
+ * not the first one that happened to throw.
+ */
+declare function validateItemGroup(data: unknown): ValidationResult<ItemGroup>;
+//#endregion
+//#region src/schemas/json-schema.d.ts
+/**
+ * JSON Schema (Draft 7) for a `Stimulus`. Structural contract only — the
+ * kind/media/body consistency guards are Zod-only.
+ */
+declare const stimulusJsonSchema: Record<string, unknown>;
+/**
+ * JSON Schema (Draft 7) for an `ItemGroup` CONTAINER. Items appear as objects
+ * with `type` and `id` only; each item's own contract is `jsonSchemaFor(type)`.
+ * For an AI generation pipeline, ask for the group and each item separately
+ * rather than a single nested schema — that keeps the per-type schema the
+ * registry's, not a copy.
+ */
+declare const itemGroupJsonSchema: Record<string, unknown>;
+/**
+ * JSON Schema (Draft 7) representation of the Multiple Choice activity data
+ * contract, generated natively by Zod 4. Draft 7 is mandated by Requirement
+ * 2.2 for the widest AI-prompt / OpenAPI tooling compatibility. The semantic
+ * `.refine()` guards are not representable in JSON Schema and are
+ * intentionally omitted — the export captures the *structural* contract only.
+ * Since v0.3 the source schemas are loose, so these no longer emit
+ * `additionalProperties: false` — the JSON Schema and `validateActivity` now
+ * agree on unknown-key handling.
+ */
+/**
+ * JSON Schema (Draft 7) representation of the Gap Select activity data
+ * contract. Structural contract only: the six semantic guards — the
+ * passage/gap bijection, id uniqueness, the one-choice-source rule, and an
+ * answer key that names a choice the gap offers — are Zod-only, as they are
+ * for the other types.
+ */
+declare const gapSelectJsonSchema: Record<string, unknown>;
+/**
+ * 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: Record<string, unknown>;
+/**
+ * JSON Schema (Draft 7) representation of the Read Aloud activity data
+ * contract. Structural contract, plus the raw cap JSON Schema can state in code
+ * points as zod counts them — `maxLength` 2000 on the reference text — and the
+ * canonical locale pattern. The ten semantic guards — the cap after
+ * normalisation, a text that survives it, the spaced-script rule, the
+ * model-recording rules, unique dimensions, a weight above 0, and the take
+ * bounds — are Zod-only, as they are for the other types.
+ */
+declare const readAloudJsonSchema: Record<string, unknown>;
+declare const multipleChoiceJsonSchema: Record<string, unknown>;
+/**
+ * JSON Schema (Draft 7) representation of the Fill-in-the-Blanks activity data
+ * contract, generated natively by Zod 4. Structural contract only (semantic
+ * `.refine()` guards are Zod-only and not representable in JSON Schema).
+ */
+declare const fillInTheBlanksJsonSchema: Record<string, unknown>;
+/**
+ * JSON Schema (Draft 7) representation of the Written Response activity data
+ * contract. Structural contract only.
+ */
+declare const writtenResponseJsonSchema: Record<string, unknown>;
+/**
+ * Derives the JSON Schema (Draft 7) for any REGISTERED activity type — the
+ * live, registry-backed replacement for the static per-type exports above,
+ * and the building block for AI generation pipelines (R6.1): pass the result
+ * as a structured-output schema so a model can only emit valid items.
+ *
+ * For a type you registered, it is the descriptor's `jsonSchema` when you gave
+ * one, or else what the schema produces through the Standard JSON Schema
+ * converter (`'~standard'.jsonSchema`) — a zod 4.6 schema has one. A fresh copy
+ * every call.
+ *
+ * @throws UnknownActivityTypeError when `type` has no registered descriptor.
+ * @throws Error when a registered type has neither a `jsonSchema` nor a schema
+ *   that can produce one.
+ */
+declare function jsonSchemaFor(type: string): Record<string, unknown>;
+//#endregion
+//#region src/schemas/index.d.ts
+/**
+ * Checks a piece of activity media — an item's `media`, a stimulus's, a
+ * dictation's `slowMedia` — on its own, the way `validateActivity` checks it
+ * inside an item: its kind, an address in the allowed schemes, a playback
+ * policy only on audio, captions and tracks only where they can play. For an
+ * editor's media picker, which holds the media before the item is whole.
+ *
+ * @returns `{ success: true, data }`, or `{ success: false, errors }` with the
+ *   same codes, paths and messages `validateActivity` reports.
+ */
+declare function validateMedia(value: unknown): ValidationResult<ActivityMedia>;
+/**
+ * Checks a multiple-choice option's `media` on its own: a picture or a
+ * recording, at an address in the allowed schemes, with no playback policy.
+ *
+ * @returns `{ success: true, data }`, or `{ success: false, errors }` with the
+ *   same codes, paths and messages `validateActivity` reports.
+ */
+declare function validateOptionMedia(value: unknown): ValidationResult<MultipleChoiceOptionMedia>;
+/**
+ * Validates raw activity data against the schema registered for the given
+ * activity type (built-in or consumer-registered via `registerActivityType`).
+ *
+ * Unknown keys are PRESERVED, not stripped: every built-in schema is loose,
+ * so consumer sidecar fields and forward-version fields survive validation
+ * verbatim in the returned `data`.
+ *
+ * @returns `{ success: true, data }` with the typed, validated data, or
+ *          `{ success: false, errors }` with one entry per failed constraint.
+ * @throws UnknownActivityTypeError when `type` has no registered descriptor.
+ */
+declare function validateActivity<T extends ActivityType>(type: T, data: unknown): ValidationResult<ActivityDataMap[T]>;
+//#endregion
+export { RedactedMultipleChoiceData as C, RedactedStimulus as D, RedactedReadAloudData as E, RedactedWrittenResponseData as O, RedactedGapSelectGap as S, RedactedMultipleChoiceOptionMedia as T, RedactedDictationSlowMedia as _, fillInTheBlanksJsonSchema as a, RedactedGapSelectChoice as b, jsonSchemaFor as c, stimulusJsonSchema as d, writtenResponseJsonSchema as f, RedactedDictationData as g, RedactedBlankConfig as h, dictationJsonSchema as i, multipleChoiceJsonSchema as l, RedactedActivity as m, validateMedia as n, gapSelectJsonSchema as o, validateItemGroup as p, validateOptionMedia as r, itemGroupJsonSchema as s, validateActivity as t, readAloudJsonSchema as u, RedactedFillInTheBlanksData as v, RedactedMultipleChoiceOption as w, RedactedGapSelectData as x, RedactedGapSelectBank as y };
+//# sourceMappingURL=index-B54baFUA.d.ts.map

package/dist/index-B54baFUA.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-B54baFUA.d.ts","names":[],"sources":["../src/types/redacted.ts","../src/schemas/item-group.ts","../src/schemas/json-schema.ts","../src/schemas/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;UAoBU;EACR;EACA;EACA;EACA;EACA;;;UAIQ;EACR;EACA;EACA;EACA;EACA;;;UAIQ;EACR;EACA;EACA;EACA;EACA,SAAS;EACT;EACA,WAAW;;;UAIH;EACR;EACA;;;UAIQ;EACR;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;EACA,KAAK;;;UAIU;EACf;EACA;EACA;EACA;;;UAIe;EACf;EACA;EACA,QAAQ;;;UAIO,mCAAmC;EAClD;EACA;EACA;EACA;EACA,SAAS;EACT;EACA;;;UAIe;EACf;EACA;;;UAIe,oCAAoC;EACnD;EACA;EACA;EACA,QAAQ;EACR;;;UAIe,oCAAoC;EACnD;EACA;EACA;EACA;EACA;EACA;IAEM;MAAY;MAAc;MAAgB;;IAC1C;;EAGN;EACA;;;UAIe;EACf;EACA;;;UAIe;EACf;EACA,SAAS;;;UAIM;EACf;EACA,UAAU;EACV;;;UAIe,8BAA8B;EAC7C;EACA;EACA;EACA,MAAM;EACN,QAAQ;EACR;EACA;EACA;;;UAIe;EACf;EACA;EACA;;;UAIe,8BAA8B;EAC7C;EACA,YAAY;EACZ;IAAU;;EACV;;;;;;;UAQe,8BAA8B;EAC7C;EACA;EACA;EACA;EACA,YAAY;EACZ;IACE;IACA;IACA;;EAEF;IACE;MACE;MACA;;;;;UAMW;EACf;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR;EACA;;;;;;;;;;;;;;KAeU,mBACR,6BACA,8BACA,8BACA,wBACA,wBACA;;;;;;;;;;;;;iBCgNY,kBAAkB,gBAAgB,iBAAiB;;;;;;;cClatD,oBAAoB;;;;;;;;cAWpB,qBAAqB;;;;;;;;;;;;;;;;;;cAqBrB,qBAAqB;;;;;;;;;;;cAcrB,qBAAqB;;;;;;;;;;cAarB,qBAAqB;cAIrB,0BAA0B;;;;;;cAY1B,2BAA2B;;;;;cAW3B,2BAA2B;;;;;;;;;;;;;;;;iBAsBxB,cAAc,eAAe;;;;;;;;;;;;;iBCvE7B,cAAc,iBAAiB,iBAAiB;;;;;;;;iBAWhD,oBAAoB,iBAAiB,iBAAiB;;;;;;;;;;;;;iBA8BtD,iBAAiB,UAAU,cACzC,MAAM,GACN,gBACC,iBAAiB,gBAAgB"}