@intellectif/lk-core 1.5.0 → 1.7.0

package/dist/{schemas-DksueYsu.cjs → schemas-BWeskONy.cjs}

@@ -1,8 +1,8 @@
-const require_registry = require("./registry-Ce00A_OW.cjs");
-const require_item_group = require("./item-group-DEB7nLID.cjs");
+const require_registry = require("./registry-hzrkTeIT.cjs");
+const require_item_group = require("./item-group-8P3WFuUK.cjs");
 let zod_v4 = require("zod/v4");
 zod_v4 = require_registry.__toESM(zod_v4, 1);
-//#region src/schemas/json-schema.ts
+// src/schemas/json-schema.ts
 /**
 * JSON Schema (Draft 7) for a `Stimulus`. Structural contract only — the
 * kind/media/body consistency guards are Zod-only.
@@ -67,32 +67,88 @@ const fillInTheBlanksJsonSchema = zod_v4.toJSONSchema(require_registry.FillInThe
 * contract. Structural contract only.
 */
 const writtenResponseJsonSchema = zod_v4.toJSONSchema(require_registry.WrittenResponseDataSchema, { target: "draft-7" });
+/** What the Standard JSON Schema converter calls each draft. */
+const STANDARD_TARGET = {
+	"draft-7": "draft-07",
+	"draft-2020-12": "draft-2020-12"
+};
 /**
-* 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.
+* Derives the JSON Schema 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.
+* Draft 7 unless `target` says `'draft-2020-12'`. For a type you registered,
+* it is the descriptor's `jsonSchema` when you gave one, in whatever draft you
+* wrote it, or else what the schema produces through the Standard JSON Schema
+* converter (`'~standard'.jsonSchema`) in the draft asked for — 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.
 */
-function jsonSchemaFor(type) {
+function jsonSchemaFor(type, options = {}) {
+	const target = options.target ?? "draft-7";
 	const descriptor = require_registry.getActivityTypeDescriptor(type);
 	if (descriptor === void 0) throw new require_registry.UnknownActivityTypeError(type);
-	if (require_registry.isOwnSchema(descriptor.schema)) return zod_v4.toJSONSchema(descriptor.schema, { target: "draft-7" });
+	if (require_registry.isOwnSchema(descriptor.schema)) return zod_v4.toJSONSchema(descriptor.schema, { target });
 	if (descriptor.jsonSchema !== void 0) return structuredClone(descriptor.jsonSchema);
-	const generated = require_registry.standardJsonSchemaOf(descriptor.schema);
+	const generated = require_registry.standardJsonSchemaOf(descriptor.schema, STANDARD_TARGET[target]);
 	if (generated === void 0) throw new Error(`Activity type "${descriptor.type}" has no JSON Schema: its schema implements no Standard JSON Schema converter ('~standard'.jsonSchema). Give its descriptor a \`jsonSchema\`.`);
 	return generated;
 }
-//#endregion
-//#region src/schemas/index.ts
+/** A schema without its `$schema`, to sit inside another document. */
+function body(schema) {
+	const { $schema: _draft, ...rest } = schema;
+	return rest;
+}
+/**
+* One JSON Schema document for content an outside tool writes: the root is a
+* `SequenceEntry` — an activity of any registered type, or an item group whose
+* items are typed too. Each type, the stimulus and the item group sit under
+* `$defs` (`definitions` in draft 7), so a tool can also point at one of them.
+* Draft 2020-12 unless `target` says `'draft-7'`.
+*
+* Structural, as every exported schema is: rules that span fields (one key in
+* a single-answer question, a blank for each marker, a slow recording that is
+* another file) cannot be written in JSON Schema. On import, `validateDraft`
+* and `validateItemGroupDraft` decide. It includes the author-only fields
+* (`transcript`, `script`), so a tool can write them.
+*
+* ```ts
+* writeFileSync('schema.json', JSON.stringify(contentJsonSchema(), null, 2));
+* ```
+*/
+function contentJsonSchema(options = {}) {
+	const target = options.target ?? "draft-2020-12";
+	const definitions = target === "draft-7" ? "definitions" : "$defs";
+	const ref = (name) => ({ $ref: `#/${definitions}/${name}` });
+	const types = require_registry.registeredActivityTypes();
+	const anyActivity = { oneOf: types.map(ref) };
+	const group = body(zod_v4.toJSONSchema(require_item_group.ItemGroupSchema, { target }));
+	const properties = group.properties;
+	group.properties = {
+		...properties,
+		stimulus: ref("stimulus"),
+		items: {
+			...properties.items,
+			items: { allOf: [properties.items?.items, anyActivity] }
+		}
+	};
+	return {
+		$schema: target === "draft-7" ? "http://json-schema.org/draft-07/schema#" : "https://json-schema.org/draft/2020-12/schema",
+		title: "SequenceEntry",
+		description: "One entry of a question set or an exam section: an activity, or an item group. Structural only: validateDraft and validateItemGroupDraft decide.",
+		oneOf: [...types.map(ref), ref("item-group")],
+		[definitions]: {
+			...Object.fromEntries(types.map((type) => [type, body(jsonSchemaFor(type, { target }))])),
+			stimulus: body(zod_v4.toJSONSchema(require_item_group.StimulusSchema, { target })),
+			"item-group": group
+		}
+	};
+}
+// src/schemas/index.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
@@ -147,7 +203,12 @@ function validateActivity(type, data) {
 	if (descriptor === void 0) throw new require_registry.UnknownActivityTypeError(String(type));
 	return asValidation(require_registry.readSchema(descriptor.schema, data, `Activity type "${descriptor.type}"`));
 }
-//#endregion
+Object.defineProperty(exports, "contentJsonSchema", {
+	enumerable: true,
+	get: function() {
+		return contentJsonSchema;
+	}
+});
 Object.defineProperty(exports, "dictationJsonSchema", {
 	enumerable: true,
 	get: function() {
@@ -221,4 +282,4 @@ Object.defineProperty(exports, "writtenResponseJsonSchema", {
 	}
 });
 
-//# sourceMappingURL=schemas-DksueYsu.cjs.map
+//# sourceMappingURL=schemas-BWeskONy.cjs.map

package/dist/schemas-BWeskONy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas-BWeskONy.cjs","names":["z","StimulusSchema","ItemGroupSchema","GapSelectDataSchema","DictationDataSchema","ReadAloudDataSchema","MultipleChoiceDataSchema","FillInTheBlanksDataSchema","WrittenResponseDataSchema","getActivityTypeDescriptor","UnknownActivityTypeError","isOwnSchema","standardJsonSchemaOf","registeredActivityTypes","readSchema","MediaSchema","MultipleChoiceOptionMediaSchema","getActivityTypeDescriptor","UnknownActivityTypeError"],"sources":["../src/schemas/json-schema.ts","../src/schemas/index.ts"],"sourcesContent":["import * as z from 'zod/v4';\nimport { UnknownActivityTypeError } from '../errors.js';\nimport { getActivityTypeDescriptor, registeredActivityTypes } 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 { ReadAloudDataSchema } from './read-aloud.js';\nimport { isOwnSchema, standardJsonSchemaOf } from './read-schema.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: Record<string, unknown> = z.toJSONSchema(StimulusSchema, {\n  target: 'draft-7',\n});\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: Record<string, unknown> = z.toJSONSchema(ItemGroupSchema, {\n  target: 'draft-7',\n});\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: Record<string, unknown> = 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: Record<string, unknown> = z.toJSONSchema(DictationDataSchema, {\n  target: 'draft-7',\n});\n\n/**\n * JSON Schema (Draft 7) representation of the Read Aloud activity data\n * contract. Structural contract, plus the raw cap JSON Schema can state in code\n * points as zod counts them — `maxLength` 2000 on the reference text — and the\n * canonical locale pattern. The ten semantic guards — the cap after\n * normalisation, a text that survives it, the spaced-script rule, the\n * model-recording rules, unique dimensions, a weight above 0, and the take\n * bounds — are Zod-only, as they are for the other types.\n */\nexport const readAloudJsonSchema: Record<string, unknown> = z.toJSONSchema(ReadAloudDataSchema, {\n  target: 'draft-7',\n});\n\nexport const multipleChoiceJsonSchema: Record<string, unknown> = z.toJSONSchema(\n  MultipleChoiceDataSchema,\n  {\n    target: 'draft-7',\n  },\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: Record<string, unknown> = z.toJSONSchema(\n  FillInTheBlanksDataSchema,\n  {\n    target: 'draft-7',\n  },\n);\n\n/**\n * JSON Schema (Draft 7) representation of the Written Response activity data\n * contract. Structural contract only.\n */\nexport const writtenResponseJsonSchema: Record<string, unknown> = z.toJSONSchema(\n  WrittenResponseDataSchema,\n  {\n    target: 'draft-7',\n  },\n);\n\n/** The JSON Schema drafts the SDK writes. */\nexport type JsonSchemaTarget = 'draft-2020-12' | 'draft-7';\n\n/** What the Standard JSON Schema converter calls each draft. */\nconst STANDARD_TARGET = { 'draft-7': 'draft-07', 'draft-2020-12': 'draft-2020-12' } as const;\n\n/**\n * Derives the JSON Schema for any REGISTERED activity type — the live,\n * registry-backed replacement for the static per-type exports above, and the\n * building block for AI generation pipelines (R6.1): pass the result as a\n * structured-output schema so a model can only emit valid items.\n *\n * Draft 7 unless `target` says `'draft-2020-12'`. For a type you registered,\n * it is the descriptor's `jsonSchema` when you gave one, in whatever draft you\n * wrote it, or else what the schema produces through the Standard JSON Schema\n * converter (`'~standard'.jsonSchema`) in the draft asked for — a zod 4.6\n * schema has one. A fresh copy every call.\n *\n * @throws UnknownActivityTypeError when `type` has no registered descriptor.\n * @throws Error when a registered type has neither a `jsonSchema` nor a schema\n *   that can produce one.\n */\nexport function jsonSchemaFor(\n  type: string,\n  options: { target?: JsonSchemaTarget } = {},\n): Record<string, unknown> {\n  const target = options.target ?? 'draft-7';\n  const descriptor = getActivityTypeDescriptor(type);\n  if (descriptor === undefined) {\n    throw new UnknownActivityTypeError(type);\n  }\n  if (isOwnSchema(descriptor.schema)) {\n    return z.toJSONSchema(descriptor.schema as never, { target }) as Record<string, unknown>;\n  }\n  if (descriptor.jsonSchema !== undefined) {\n    return structuredClone(descriptor.jsonSchema) as Record<string, unknown>;\n  }\n  const generated = standardJsonSchemaOf(descriptor.schema, STANDARD_TARGET[target]);\n  if (generated === undefined) {\n    throw new Error(\n      `Activity type \"${descriptor.type}\" has no JSON Schema: its schema implements no Standard JSON Schema converter ('~standard'.jsonSchema). Give its descriptor a \\`jsonSchema\\`.`,\n    );\n  }\n  return generated;\n}\n\n/** A schema without its `$schema`, to sit inside another document. */\nfunction body(schema: Record<string, unknown>): Record<string, unknown> {\n  const { $schema: _draft, ...rest } = schema;\n  return rest;\n}\n\n/**\n * One JSON Schema document for content an outside tool writes: the root is a\n * `SequenceEntry` — an activity of any registered type, or an item group whose\n * items are typed too. Each type, the stimulus and the item group sit under\n * `$defs` (`definitions` in draft 7), so a tool can also point at one of them.\n * Draft 2020-12 unless `target` says `'draft-7'`.\n *\n * Structural, as every exported schema is: rules that span fields (one key in\n * a single-answer question, a blank for each marker, a slow recording that is\n * another file) cannot be written in JSON Schema. On import, `validateDraft`\n * and `validateItemGroupDraft` decide. It includes the author-only fields\n * (`transcript`, `script`), so a tool can write them.\n *\n * ```ts\n * writeFileSync('schema.json', JSON.stringify(contentJsonSchema(), null, 2));\n * ```\n */\nexport function contentJsonSchema(\n  options: { target?: JsonSchemaTarget } = {},\n): Record<string, unknown> {\n  const target = options.target ?? 'draft-2020-12';\n  const definitions = target === 'draft-7' ? 'definitions' : '$defs';\n  const ref = (name: string) => ({ $ref: `#/${definitions}/${name}` });\n  const types = registeredActivityTypes();\n  const anyActivity = { oneOf: types.map(ref) };\n\n  const group = body(z.toJSONSchema(ItemGroupSchema, { target }) as Record<string, unknown>);\n  const properties = group.properties as Record<string, Record<string, unknown>>;\n  group.properties = {\n    ...properties,\n    stimulus: ref('stimulus'),\n    // The container's own rule for an item (a `type`, an `id`, a `slotKey`),\n    // and the item's type's whole contract.\n    items: { ...properties.items, items: { allOf: [properties.items?.items, anyActivity] } },\n  };\n\n  return {\n    $schema:\n      target === 'draft-7'\n        ? 'http://json-schema.org/draft-07/schema#'\n        : 'https://json-schema.org/draft/2020-12/schema',\n    title: 'SequenceEntry',\n    description:\n      'One entry of a question set or an exam section: an activity, or an item group. Structural only: validateDraft and validateItemGroupDraft decide.',\n    oneOf: [...types.map(ref), ref('item-group')],\n    [definitions]: {\n      ...Object.fromEntries(types.map((type) => [type, body(jsonSchemaFor(type, { target }))])),\n      stimulus: body(z.toJSONSchema(StimulusSchema, { target }) as Record<string, unknown>),\n      'item-group': group,\n    },\n  };\n}\n","import { UnknownActivityTypeError } from '../errors.js';\nimport { getActivityTypeDescriptor } from '../registry/index.js';\nimport type {\n  ActivityDataMap,\n  ActivityMedia,\n  ActivityType,\n  MultipleChoiceOptionMedia,\n  ValidationResult,\n} from '../types/activity.js';\nimport { MediaSchema } from './media.js';\nimport { MultipleChoiceOptionMediaSchema } from './multiple-choice.js';\nimport { readSchema, type SchemaReading } from './read-schema.js';\n\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  RedactedReadAloudData,\n  RedactedStimulus,\n  RedactedWrittenResponseData,\n} from '../types/redacted.js';\nexport { validateItemGroup } from './item-group.js';\nexport {\n  contentJsonSchema,\n  dictationJsonSchema,\n  fillInTheBlanksJsonSchema,\n  gapSelectJsonSchema,\n  itemGroupJsonSchema,\n  type JsonSchemaTarget,\n  jsonSchemaFor,\n  multipleChoiceJsonSchema,\n  readAloudJsonSchema,\n  stimulusJsonSchema,\n  writtenResponseJsonSchema,\n} from './json-schema.js';\nexport { SCRIPT_MAX_TURNS } from './media.js';\n\n/**\n * Checks a piece of activity media — an item's `media`, a stimulus's, a\n * dictation's `slowMedia` — on its own, the way `validateActivity` checks it\n * inside an item: its kind, an address in the allowed schemes, a playback\n * policy only on audio, captions and tracks only where they can play. For an\n * editor's media picker, which holds the media before the item is whole.\n *\n * @returns `{ success: true, data }`, or `{ success: false, errors }` with the\n *   same codes, paths and messages `validateActivity` reports.\n */\nexport function validateMedia(value: unknown): ValidationResult<ActivityMedia> {\n  return asValidation(readSchema(MediaSchema as never, value, 'Media'));\n}\n\n/**\n * Checks a multiple-choice option's `media` on its own: a picture or a\n * recording, at an address in the allowed schemes, with no playback policy.\n *\n * @returns `{ success: true, data }`, or `{ success: false, errors }` with the\n *   same codes, paths and messages `validateActivity` reports.\n */\nexport function validateOptionMedia(value: unknown): ValidationResult<MultipleChoiceOptionMedia> {\n  return asValidation(readSchema(MultipleChoiceOptionMediaSchema as never, value, 'Option media'));\n}\n\nfunction asValidation<T>(reading: SchemaReading<unknown>): ValidationResult<T> {\n  if (reading.success) {\n    return { success: true, data: reading.data as T };\n  }\n  return {\n    success: false,\n    errors: reading.issues.map((issue) => ({\n      path: issue.path.map(String),\n      message: issue.message,\n      code: issue.code,\n    })),\n  };\n}\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  return asValidation(readSchema(descriptor.schema, data, `Activity type \"${descriptor.type}\"`));\n}\n"],"mappings":"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"}

package/dist/{schemas-BioKFf3F.js → schemas-C7TViWCg.js}

@@ -1,7 +1,7 @@
-import { D as MultipleChoiceOptionMediaSchema, E as MultipleChoiceDataSchema, J as DictationDataSchema, St as MediaSchema, _ as GapSelectDataSchema, a as readSchema, et as UnknownActivityTypeError, g as WrittenResponseDataSchema, i as isOwnSchema, o as standardJsonSchemaOf, t as getActivityTypeDescriptor, v as ReadAloudDataSchema, xt as FillInTheBlanksDataSchema } from "./registry-DaZRpqjW.js";
-import { r as StimulusSchema, t as ItemGroupSchema } from "./item-group-DdSUCUjM.js";
+import { Ct as MediaSchema, D as MultipleChoiceOptionMediaSchema, E as MultipleChoiceDataSchema, St as FillInTheBlanksDataSchema, Y as DictationDataSchema, _ as GapSelectDataSchema, a as readSchema, g as WrittenResponseDataSchema, i as isOwnSchema, o as standardJsonSchemaOf, r as registeredActivityTypes, t as getActivityTypeDescriptor, tt as UnknownActivityTypeError, v as ReadAloudDataSchema } from "./registry-D92hz9iA.js";
+import { r as StimulusSchema, t as ItemGroupSchema } from "./item-group-CeDk7mfM.js";
 import * as z from "zod/v4";
-//#region src/schemas/json-schema.ts
+// src/schemas/json-schema.ts
 /**
 * JSON Schema (Draft 7) for a `Stimulus`. Structural contract only — the
 * kind/media/body consistency guards are Zod-only.
@@ -66,32 +66,88 @@ const fillInTheBlanksJsonSchema = z.toJSONSchema(FillInTheBlanksDataSchema, { ta
 * contract. Structural contract only.
 */
 const writtenResponseJsonSchema = z.toJSONSchema(WrittenResponseDataSchema, { target: "draft-7" });
+/** What the Standard JSON Schema converter calls each draft. */
+const STANDARD_TARGET = {
+	"draft-7": "draft-07",
+	"draft-2020-12": "draft-2020-12"
+};
 /**
-* 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.
+* Derives the JSON Schema 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.
+* Draft 7 unless `target` says `'draft-2020-12'`. For a type you registered,
+* it is the descriptor's `jsonSchema` when you gave one, in whatever draft you
+* wrote it, or else what the schema produces through the Standard JSON Schema
+* converter (`'~standard'.jsonSchema`) in the draft asked for — 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.
 */
-function jsonSchemaFor(type) {
+function jsonSchemaFor(type, options = {}) {
+	const target = options.target ?? "draft-7";
 	const descriptor = getActivityTypeDescriptor(type);
 	if (descriptor === void 0) throw new UnknownActivityTypeError(type);
-	if (isOwnSchema(descriptor.schema)) return z.toJSONSchema(descriptor.schema, { target: "draft-7" });
+	if (isOwnSchema(descriptor.schema)) return z.toJSONSchema(descriptor.schema, { target });
 	if (descriptor.jsonSchema !== void 0) return structuredClone(descriptor.jsonSchema);
-	const generated = standardJsonSchemaOf(descriptor.schema);
+	const generated = standardJsonSchemaOf(descriptor.schema, STANDARD_TARGET[target]);
 	if (generated === void 0) throw new Error(`Activity type "${descriptor.type}" has no JSON Schema: its schema implements no Standard JSON Schema converter ('~standard'.jsonSchema). Give its descriptor a \`jsonSchema\`.`);
 	return generated;
 }
-//#endregion
-//#region src/schemas/index.ts
+/** A schema without its `$schema`, to sit inside another document. */
+function body(schema) {
+	const { $schema: _draft, ...rest } = schema;
+	return rest;
+}
+/**
+* One JSON Schema document for content an outside tool writes: the root is a
+* `SequenceEntry` — an activity of any registered type, or an item group whose
+* items are typed too. Each type, the stimulus and the item group sit under
+* `$defs` (`definitions` in draft 7), so a tool can also point at one of them.
+* Draft 2020-12 unless `target` says `'draft-7'`.
+*
+* Structural, as every exported schema is: rules that span fields (one key in
+* a single-answer question, a blank for each marker, a slow recording that is
+* another file) cannot be written in JSON Schema. On import, `validateDraft`
+* and `validateItemGroupDraft` decide. It includes the author-only fields
+* (`transcript`, `script`), so a tool can write them.
+*
+* ```ts
+* writeFileSync('schema.json', JSON.stringify(contentJsonSchema(), null, 2));
+* ```
+*/
+function contentJsonSchema(options = {}) {
+	const target = options.target ?? "draft-2020-12";
+	const definitions = target === "draft-7" ? "definitions" : "$defs";
+	const ref = (name) => ({ $ref: `#/${definitions}/${name}` });
+	const types = registeredActivityTypes();
+	const anyActivity = { oneOf: types.map(ref) };
+	const group = body(z.toJSONSchema(ItemGroupSchema, { target }));
+	const properties = group.properties;
+	group.properties = {
+		...properties,
+		stimulus: ref("stimulus"),
+		items: {
+			...properties.items,
+			items: { allOf: [properties.items?.items, anyActivity] }
+		}
+	};
+	return {
+		$schema: target === "draft-7" ? "http://json-schema.org/draft-07/schema#" : "https://json-schema.org/draft/2020-12/schema",
+		title: "SequenceEntry",
+		description: "One entry of a question set or an exam section: an activity, or an item group. Structural only: validateDraft and validateItemGroupDraft decide.",
+		oneOf: [...types.map(ref), ref("item-group")],
+		[definitions]: {
+			...Object.fromEntries(types.map((type) => [type, body(jsonSchemaFor(type, { target }))])),
+			stimulus: body(z.toJSONSchema(StimulusSchema, { target })),
+			"item-group": group
+		}
+	};
+}
+// src/schemas/index.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
@@ -146,7 +202,6 @@ function validateActivity(type, data) {
 	if (descriptor === void 0) throw new UnknownActivityTypeError(String(type));
 	return asValidation(readSchema(descriptor.schema, data, `Activity type "${descriptor.type}"`));
 }
-//#endregion
-export { fillInTheBlanksJsonSchema as a, jsonSchemaFor as c, stimulusJsonSchema as d, writtenResponseJsonSchema as f, dictationJsonSchema as i, multipleChoiceJsonSchema as l, validateMedia as n, gapSelectJsonSchema as o, validateOptionMedia as r, itemGroupJsonSchema as s, validateActivity as t, readAloudJsonSchema as u };
+export { dictationJsonSchema as a, itemGroupJsonSchema as c, readAloudJsonSchema as d, stimulusJsonSchema as f, contentJsonSchema as i, jsonSchemaFor as l, validateMedia as n, fillInTheBlanksJsonSchema as o, writtenResponseJsonSchema as p, validateOptionMedia as r, gapSelectJsonSchema as s, validateActivity as t, multipleChoiceJsonSchema as u };
 
-//# sourceMappingURL=schemas-BioKFf3F.js.map
+//# sourceMappingURL=schemas-C7TViWCg.js.map

package/dist/schemas-C7TViWCg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas-C7TViWCg.js","names":[],"sources":["../src/schemas/json-schema.ts","../src/schemas/index.ts"],"sourcesContent":["import * as z from 'zod/v4';\nimport { UnknownActivityTypeError } from '../errors.js';\nimport { getActivityTypeDescriptor, registeredActivityTypes } 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 { ReadAloudDataSchema } from './read-aloud.js';\nimport { isOwnSchema, standardJsonSchemaOf } from './read-schema.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: Record<string, unknown> = z.toJSONSchema(StimulusSchema, {\n  target: 'draft-7',\n});\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: Record<string, unknown> = z.toJSONSchema(ItemGroupSchema, {\n  target: 'draft-7',\n});\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: Record<string, unknown> = 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: Record<string, unknown> = z.toJSONSchema(DictationDataSchema, {\n  target: 'draft-7',\n});\n\n/**\n * JSON Schema (Draft 7) representation of the Read Aloud activity data\n * contract. Structural contract, plus the raw cap JSON Schema can state in code\n * points as zod counts them — `maxLength` 2000 on the reference text — and the\n * canonical locale pattern. The ten semantic guards — the cap after\n * normalisation, a text that survives it, the spaced-script rule, the\n * model-recording rules, unique dimensions, a weight above 0, and the take\n * bounds — are Zod-only, as they are for the other types.\n */\nexport const readAloudJsonSchema: Record<string, unknown> = z.toJSONSchema(ReadAloudDataSchema, {\n  target: 'draft-7',\n});\n\nexport const multipleChoiceJsonSchema: Record<string, unknown> = z.toJSONSchema(\n  MultipleChoiceDataSchema,\n  {\n    target: 'draft-7',\n  },\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: Record<string, unknown> = z.toJSONSchema(\n  FillInTheBlanksDataSchema,\n  {\n    target: 'draft-7',\n  },\n);\n\n/**\n * JSON Schema (Draft 7) representation of the Written Response activity data\n * contract. Structural contract only.\n */\nexport const writtenResponseJsonSchema: Record<string, unknown> = z.toJSONSchema(\n  WrittenResponseDataSchema,\n  {\n    target: 'draft-7',\n  },\n);\n\n/** The JSON Schema drafts the SDK writes. */\nexport type JsonSchemaTarget = 'draft-2020-12' | 'draft-7';\n\n/** What the Standard JSON Schema converter calls each draft. */\nconst STANDARD_TARGET = { 'draft-7': 'draft-07', 'draft-2020-12': 'draft-2020-12' } as const;\n\n/**\n * Derives the JSON Schema for any REGISTERED activity type — the live,\n * registry-backed replacement for the static per-type exports above, and the\n * building block for AI generation pipelines (R6.1): pass the result as a\n * structured-output schema so a model can only emit valid items.\n *\n * Draft 7 unless `target` says `'draft-2020-12'`. For a type you registered,\n * it is the descriptor's `jsonSchema` when you gave one, in whatever draft you\n * wrote it, or else what the schema produces through the Standard JSON Schema\n * converter (`'~standard'.jsonSchema`) in the draft asked for — a zod 4.6\n * schema has one. A fresh copy every call.\n *\n * @throws UnknownActivityTypeError when `type` has no registered descriptor.\n * @throws Error when a registered type has neither a `jsonSchema` nor a schema\n *   that can produce one.\n */\nexport function jsonSchemaFor(\n  type: string,\n  options: { target?: JsonSchemaTarget } = {},\n): Record<string, unknown> {\n  const target = options.target ?? 'draft-7';\n  const descriptor = getActivityTypeDescriptor(type);\n  if (descriptor === undefined) {\n    throw new UnknownActivityTypeError(type);\n  }\n  if (isOwnSchema(descriptor.schema)) {\n    return z.toJSONSchema(descriptor.schema as never, { target }) as Record<string, unknown>;\n  }\n  if (descriptor.jsonSchema !== undefined) {\n    return structuredClone(descriptor.jsonSchema) as Record<string, unknown>;\n  }\n  const generated = standardJsonSchemaOf(descriptor.schema, STANDARD_TARGET[target]);\n  if (generated === undefined) {\n    throw new Error(\n      `Activity type \"${descriptor.type}\" has no JSON Schema: its schema implements no Standard JSON Schema converter ('~standard'.jsonSchema). Give its descriptor a \\`jsonSchema\\`.`,\n    );\n  }\n  return generated;\n}\n\n/** A schema without its `$schema`, to sit inside another document. */\nfunction body(schema: Record<string, unknown>): Record<string, unknown> {\n  const { $schema: _draft, ...rest } = schema;\n  return rest;\n}\n\n/**\n * One JSON Schema document for content an outside tool writes: the root is a\n * `SequenceEntry` — an activity of any registered type, or an item group whose\n * items are typed too. Each type, the stimulus and the item group sit under\n * `$defs` (`definitions` in draft 7), so a tool can also point at one of them.\n * Draft 2020-12 unless `target` says `'draft-7'`.\n *\n * Structural, as every exported schema is: rules that span fields (one key in\n * a single-answer question, a blank for each marker, a slow recording that is\n * another file) cannot be written in JSON Schema. On import, `validateDraft`\n * and `validateItemGroupDraft` decide. It includes the author-only fields\n * (`transcript`, `script`), so a tool can write them.\n *\n * ```ts\n * writeFileSync('schema.json', JSON.stringify(contentJsonSchema(), null, 2));\n * ```\n */\nexport function contentJsonSchema(\n  options: { target?: JsonSchemaTarget } = {},\n): Record<string, unknown> {\n  const target = options.target ?? 'draft-2020-12';\n  const definitions = target === 'draft-7' ? 'definitions' : '$defs';\n  const ref = (name: string) => ({ $ref: `#/${definitions}/${name}` });\n  const types = registeredActivityTypes();\n  const anyActivity = { oneOf: types.map(ref) };\n\n  const group = body(z.toJSONSchema(ItemGroupSchema, { target }) as Record<string, unknown>);\n  const properties = group.properties as Record<string, Record<string, unknown>>;\n  group.properties = {\n    ...properties,\n    stimulus: ref('stimulus'),\n    // The container's own rule for an item (a `type`, an `id`, a `slotKey`),\n    // and the item's type's whole contract.\n    items: { ...properties.items, items: { allOf: [properties.items?.items, anyActivity] } },\n  };\n\n  return {\n    $schema:\n      target === 'draft-7'\n        ? 'http://json-schema.org/draft-07/schema#'\n        : 'https://json-schema.org/draft/2020-12/schema',\n    title: 'SequenceEntry',\n    description:\n      'One entry of a question set or an exam section: an activity, or an item group. Structural only: validateDraft and validateItemGroupDraft decide.',\n    oneOf: [...types.map(ref), ref('item-group')],\n    [definitions]: {\n      ...Object.fromEntries(types.map((type) => [type, body(jsonSchemaFor(type, { target }))])),\n      stimulus: body(z.toJSONSchema(StimulusSchema, { target }) as Record<string, unknown>),\n      'item-group': group,\n    },\n  };\n}\n","import { UnknownActivityTypeError } from '../errors.js';\nimport { getActivityTypeDescriptor } from '../registry/index.js';\nimport type {\n  ActivityDataMap,\n  ActivityMedia,\n  ActivityType,\n  MultipleChoiceOptionMedia,\n  ValidationResult,\n} from '../types/activity.js';\nimport { MediaSchema } from './media.js';\nimport { MultipleChoiceOptionMediaSchema } from './multiple-choice.js';\nimport { readSchema, type SchemaReading } from './read-schema.js';\n\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  RedactedReadAloudData,\n  RedactedStimulus,\n  RedactedWrittenResponseData,\n} from '../types/redacted.js';\nexport { validateItemGroup } from './item-group.js';\nexport {\n  contentJsonSchema,\n  dictationJsonSchema,\n  fillInTheBlanksJsonSchema,\n  gapSelectJsonSchema,\n  itemGroupJsonSchema,\n  type JsonSchemaTarget,\n  jsonSchemaFor,\n  multipleChoiceJsonSchema,\n  readAloudJsonSchema,\n  stimulusJsonSchema,\n  writtenResponseJsonSchema,\n} from './json-schema.js';\nexport { SCRIPT_MAX_TURNS } from './media.js';\n\n/**\n * Checks a piece of activity media — an item's `media`, a stimulus's, a\n * dictation's `slowMedia` — on its own, the way `validateActivity` checks it\n * inside an item: its kind, an address in the allowed schemes, a playback\n * policy only on audio, captions and tracks only where they can play. For an\n * editor's media picker, which holds the media before the item is whole.\n *\n * @returns `{ success: true, data }`, or `{ success: false, errors }` with the\n *   same codes, paths and messages `validateActivity` reports.\n */\nexport function validateMedia(value: unknown): ValidationResult<ActivityMedia> {\n  return asValidation(readSchema(MediaSchema as never, value, 'Media'));\n}\n\n/**\n * Checks a multiple-choice option's `media` on its own: a picture or a\n * recording, at an address in the allowed schemes, with no playback policy.\n *\n * @returns `{ success: true, data }`, or `{ success: false, errors }` with the\n *   same codes, paths and messages `validateActivity` reports.\n */\nexport function validateOptionMedia(value: unknown): ValidationResult<MultipleChoiceOptionMedia> {\n  return asValidation(readSchema(MultipleChoiceOptionMediaSchema as never, value, 'Option media'));\n}\n\nfunction asValidation<T>(reading: SchemaReading<unknown>): ValidationResult<T> {\n  if (reading.success) {\n    return { success: true, data: reading.data as T };\n  }\n  return {\n    success: false,\n    errors: reading.issues.map((issue) => ({\n      path: issue.path.map(String),\n      message: issue.message,\n      code: issue.code,\n    })),\n  };\n}\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  return asValidation(readSchema(descriptor.schema, data, `Activity type \"${descriptor.type}\"`));\n}\n"],"mappings":"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"}

package/dist/schemas.cjs

@@ -1,6 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_item_group = require("./item-group-DEB7nLID.cjs");
-const require_schemas = require("./schemas-DksueYsu.cjs");
+const require_registry = require("./registry-hzrkTeIT.cjs");
+const require_item_group = require("./item-group-8P3WFuUK.cjs");
+const require_schemas = require("./schemas-BWeskONy.cjs");
+exports.SCRIPT_MAX_TURNS = require_registry.SCRIPT_MAX_TURNS;
+exports.contentJsonSchema = require_schemas.contentJsonSchema;
 exports.dictationJsonSchema = require_schemas.dictationJsonSchema;
 exports.fillInTheBlanksJsonSchema = require_schemas.fillInTheBlanksJsonSchema;
 exports.gapSelectJsonSchema = require_schemas.gapSelectJsonSchema;

package/dist/schemas.d.cts

@@ -1,2 +1,2 @@
-import { C as RedactedMultipleChoiceData, D as RedactedStimulus, E as RedactedReadAloudData, O as RedactedWrittenResponseData, S as RedactedGapSelectGap, T as RedactedMultipleChoiceOptionMedia, _ as RedactedDictationSlowMedia, a as fillInTheBlanksJsonSchema, b as RedactedGapSelectChoice, c as jsonSchemaFor, d as stimulusJsonSchema, f as writtenResponseJsonSchema, g as RedactedDictationData, h as RedactedBlankConfig, i as dictationJsonSchema, l as multipleChoiceJsonSchema, m as RedactedActivity, n as validateMedia, o as gapSelectJsonSchema, p as validateItemGroup, r as validateOptionMedia, s as itemGroupJsonSchema, t as validateActivity, u as readAloudJsonSchema, v as RedactedFillInTheBlanksData, w as RedactedMultipleChoiceOption, x as RedactedGapSelectData, y as RedactedGapSelectBank } from "./index-qMbxed1B.cjs";
-export { type RedactedActivity, type RedactedBlankConfig, type RedactedDictationData, type RedactedDictationSlowMedia, type RedactedFillInTheBlanksData, type RedactedGapSelectBank, type RedactedGapSelectChoice, type RedactedGapSelectData, type RedactedGapSelectGap, type RedactedMultipleChoiceData, type RedactedMultipleChoiceOption, type RedactedMultipleChoiceOptionMedia, type RedactedReadAloudData, type RedactedStimulus, type RedactedWrittenResponseData, dictationJsonSchema, fillInTheBlanksJsonSchema, gapSelectJsonSchema, itemGroupJsonSchema, jsonSchemaFor, multipleChoiceJsonSchema, readAloudJsonSchema, stimulusJsonSchema, validateActivity, validateItemGroup, validateMedia, validateOptionMedia, writtenResponseJsonSchema };
+import { A as RedactedStimulus, C as RedactedGapSelectChoice, D as RedactedMultipleChoiceOption, E as RedactedMultipleChoiceData, O as RedactedMultipleChoiceOptionMedia, S as RedactedGapSelectBank, T as RedactedGapSelectGap, _ as RedactedActivity, a as JsonSchemaTarget, b as RedactedDictationSlowMedia, c as fillInTheBlanksJsonSchema, d as jsonSchemaFor, f as multipleChoiceJsonSchema, g as validateItemGroup, h as writtenResponseJsonSchema, i as SCRIPT_MAX_TURNS, j as RedactedWrittenResponseData, k as RedactedReadAloudData, l as gapSelectJsonSchema, m as stimulusJsonSchema, n as validateMedia, o as contentJsonSchema, p as readAloudJsonSchema, r as validateOptionMedia, s as dictationJsonSchema, t as validateActivity, u as itemGroupJsonSchema, v as RedactedBlankConfig, w as RedactedGapSelectData, x as RedactedFillInTheBlanksData, y as RedactedDictationData } from "./index-DP9rvyOz.cjs";
+export { type JsonSchemaTarget, type RedactedActivity, type RedactedBlankConfig, type RedactedDictationData, type RedactedDictationSlowMedia, type RedactedFillInTheBlanksData, type RedactedGapSelectBank, type RedactedGapSelectChoice, type RedactedGapSelectData, type RedactedGapSelectGap, type RedactedMultipleChoiceData, type RedactedMultipleChoiceOption, type RedactedMultipleChoiceOptionMedia, type RedactedReadAloudData, type RedactedStimulus, type RedactedWrittenResponseData, SCRIPT_MAX_TURNS, contentJsonSchema, dictationJsonSchema, fillInTheBlanksJsonSchema, gapSelectJsonSchema, itemGroupJsonSchema, jsonSchemaFor, multipleChoiceJsonSchema, readAloudJsonSchema, stimulusJsonSchema, validateActivity, validateItemGroup, validateMedia, validateOptionMedia, writtenResponseJsonSchema };

package/dist/schemas.d.ts

@@ -1,2 +1,2 @@
-import { C as RedactedMultipleChoiceData, D as RedactedStimulus, E as RedactedReadAloudData, O as RedactedWrittenResponseData, S as RedactedGapSelectGap, T as RedactedMultipleChoiceOptionMedia, _ as RedactedDictationSlowMedia, a as fillInTheBlanksJsonSchema, b as RedactedGapSelectChoice, c as jsonSchemaFor, d as stimulusJsonSchema, f as writtenResponseJsonSchema, g as RedactedDictationData, h as RedactedBlankConfig, i as dictationJsonSchema, l as multipleChoiceJsonSchema, m as RedactedActivity, n as validateMedia, o as gapSelectJsonSchema, p as validateItemGroup, r as validateOptionMedia, s as itemGroupJsonSchema, t as validateActivity, u as readAloudJsonSchema, v as RedactedFillInTheBlanksData, w as RedactedMultipleChoiceOption, x as RedactedGapSelectData, y as RedactedGapSelectBank } from "./index-CxpiWedW.js";
-export { type RedactedActivity, type RedactedBlankConfig, type RedactedDictationData, type RedactedDictationSlowMedia, type RedactedFillInTheBlanksData, type RedactedGapSelectBank, type RedactedGapSelectChoice, type RedactedGapSelectData, type RedactedGapSelectGap, type RedactedMultipleChoiceData, type RedactedMultipleChoiceOption, type RedactedMultipleChoiceOptionMedia, type RedactedReadAloudData, type RedactedStimulus, type RedactedWrittenResponseData, dictationJsonSchema, fillInTheBlanksJsonSchema, gapSelectJsonSchema, itemGroupJsonSchema, jsonSchemaFor, multipleChoiceJsonSchema, readAloudJsonSchema, stimulusJsonSchema, validateActivity, validateItemGroup, validateMedia, validateOptionMedia, writtenResponseJsonSchema };
+import { A as RedactedStimulus, C as RedactedGapSelectChoice, D as RedactedMultipleChoiceOption, E as RedactedMultipleChoiceData, O as RedactedMultipleChoiceOptionMedia, S as RedactedGapSelectBank, T as RedactedGapSelectGap, _ as RedactedActivity, a as JsonSchemaTarget, b as RedactedDictationSlowMedia, c as fillInTheBlanksJsonSchema, d as jsonSchemaFor, f as multipleChoiceJsonSchema, g as validateItemGroup, h as writtenResponseJsonSchema, i as SCRIPT_MAX_TURNS, j as RedactedWrittenResponseData, k as RedactedReadAloudData, l as gapSelectJsonSchema, m as stimulusJsonSchema, n as validateMedia, o as contentJsonSchema, p as readAloudJsonSchema, r as validateOptionMedia, s as dictationJsonSchema, t as validateActivity, u as itemGroupJsonSchema, v as RedactedBlankConfig, w as RedactedGapSelectData, x as RedactedFillInTheBlanksData, y as RedactedDictationData } from "./index-BdXs4-en.js";
+export { type JsonSchemaTarget, type RedactedActivity, type RedactedBlankConfig, type RedactedDictationData, type RedactedDictationSlowMedia, type RedactedFillInTheBlanksData, type RedactedGapSelectBank, type RedactedGapSelectChoice, type RedactedGapSelectData, type RedactedGapSelectGap, type RedactedMultipleChoiceData, type RedactedMultipleChoiceOption, type RedactedMultipleChoiceOptionMedia, type RedactedReadAloudData, type RedactedStimulus, type RedactedWrittenResponseData, SCRIPT_MAX_TURNS, contentJsonSchema, dictationJsonSchema, fillInTheBlanksJsonSchema, gapSelectJsonSchema, itemGroupJsonSchema, jsonSchemaFor, multipleChoiceJsonSchema, readAloudJsonSchema, stimulusJsonSchema, validateActivity, validateItemGroup, validateMedia, validateOptionMedia, writtenResponseJsonSchema };

package/dist/schemas.js

@@ -1,3 +1,4 @@
-import { i as validateItemGroup } from "./item-group-DdSUCUjM.js";
-import { a as fillInTheBlanksJsonSchema, c as jsonSchemaFor, d as stimulusJsonSchema, f as writtenResponseJsonSchema, i as dictationJsonSchema, l as multipleChoiceJsonSchema, n as validateMedia, o as gapSelectJsonSchema, r as validateOptionMedia, s as itemGroupJsonSchema, t as validateActivity, u as readAloudJsonSchema } from "./schemas-BioKFf3F.js";
-export { dictationJsonSchema, fillInTheBlanksJsonSchema, gapSelectJsonSchema, itemGroupJsonSchema, jsonSchemaFor, multipleChoiceJsonSchema, readAloudJsonSchema, stimulusJsonSchema, validateActivity, validateItemGroup, validateMedia, validateOptionMedia, writtenResponseJsonSchema };
+import { Tt as SCRIPT_MAX_TURNS } from "./registry-D92hz9iA.js";
+import { i as validateItemGroup } from "./item-group-CeDk7mfM.js";
+import { a as dictationJsonSchema, c as itemGroupJsonSchema, d as readAloudJsonSchema, f as stimulusJsonSchema, i as contentJsonSchema, l as jsonSchemaFor, n as validateMedia, o as fillInTheBlanksJsonSchema, p as writtenResponseJsonSchema, r as validateOptionMedia, s as gapSelectJsonSchema, t as validateActivity, u as multipleChoiceJsonSchema } from "./schemas-C7TViWCg.js";
+export { SCRIPT_MAX_TURNS, contentJsonSchema, dictationJsonSchema, fillInTheBlanksJsonSchema, gapSelectJsonSchema, itemGroupJsonSchema, jsonSchemaFor, multipleChoiceJsonSchema, readAloudJsonSchema, stimulusJsonSchema, validateActivity, validateItemGroup, validateMedia, validateOptionMedia, writtenResponseJsonSchema };

package/dist/{scoring-lKQVYsxy.cjs → scoring-CtkCFyFT.cjs}

@@ -1,7 +1,7 @@
-const require_registry = require("./registry-Ce00A_OW.cjs");
+const require_registry = require("./registry-hzrkTeIT.cjs");
 let zod_v4 = require("zod/v4");
 zod_v4 = require_registry.__toESM(zod_v4, 1);
-//#region src/scoring/grade-numbers.ts
+// src/scoring/grade-numbers.ts
 /**
 * How far past its own maximum a score may sit and still be a grade. A grader
 * that sums weighted parts lands on `1.0000000000000002` for a perfect answer
@@ -24,8 +24,7 @@ const OVERSHOOT = 1e-9;
 function isGradeInRange(score, maxScore) {
 	return Number.isFinite(maxScore) && maxScore > 0 && Number.isFinite(score) && score >= 0 && score - maxScore <= maxScore * OVERSHOOT;
 }
-//#endregion
-//#region src/is-redacted.ts
+// src/is-redacted.ts
 /**
 * True when `data` is a `redact()` projection rather than full activity data.
 * Grading a redacted item is always a bug: the answer key is gone by design, so
@@ -42,8 +41,7 @@ function isGradeInRange(score, maxScore) {
 function isRedacted(data) {
 	return typeof data === "object" && data !== null && data.redacted === true;
 }
-//#endregion
-//#region src/scoring/item-scoring.ts
+// src/scoring/item-scoring.ts
 /**
 * The policy that changes nothing: one try, nothing costs anything, the first
 * try counts. What an absent policy resolves to, and exactly how questions were
@@ -214,8 +212,7 @@ function scoreTries(tries, policy) {
 		tries: scored
 	};
 }
-//#endregion
-//#region src/scoring/rounding.ts
+// src/scoring/rounding.ts
 const ROUNDING_MODES = [
 	"half-up",
 	"half-even",
@@ -327,8 +324,7 @@ function classifyBand(value, bands) {
 	for (const band of bands) if (value >= band.min - EPSILON && (best === null || band.min > best.min)) best = band;
 	return best;
 }
-//#endregion
-//#region src/scoring/pass-threshold.ts
+// src/scoring/pass-threshold.ts
 /** Default minimum scaled score required to pass when `passThreshold` is absent. */
 const DEFAULT_PASS_THRESHOLD = .7;
 /**
@@ -358,8 +354,7 @@ function selectFeedback(activityData, passed) {
 	if (feedback === void 0) return null;
 	return (passed ? feedback.correct : feedback.incorrect) ?? null;
 }
-//#endregion
-//#region src/content-hash.ts
+// src/content-hash.ts
 /**
 * Content fingerprinting — "is this the same content the learner was served?"
 *
@@ -430,8 +425,7 @@ function fingerprint(input) {
 function contentHash(value) {
 	return fingerprint(canonicalJson(value));
 }
-//#endregion
-//#region src/scoring/assisted/calibration.ts
+// src/scoring/assisted/calibration.ts
 const mean = (values) => values.reduce((sum, value) => sum + value, 0) / values.length;
 /** Population variance. */
 function variance(values) {
@@ -758,8 +752,7 @@ function calibrationReport(pairs, scope) {
 		}
 	};
 }
-//#endregion
-//#region src/grading.ts
+// src/grading.ts
 /**
 * Computes the weighted total from per-criterion scores — the arithmetic that
 * must NOT be delegated to a language model.
@@ -885,8 +878,7 @@ function outcomeFromGrade(grade) {
 function hasGrade(outcome) {
 	return outcome.status === "scored" || outcome.status === "graded";
 }
-//#endregion
-//#region src/scoring/assisted/grade-from-judgement.ts
+// src/scoring/assisted/grade-from-judgement.ts
 /**
 * The grade a checked model judgement gives a written response: the total
 * computed as `gradeFromRubric` computes every grade — never by the model — with
@@ -952,8 +944,7 @@ function gradeFromJudgement(judgement, data, options = {}) {
 		...provenance?.generatedAt !== void 0 ? { gradedAt: provenance.generatedAt } : {}
 	};
 }
-//#endregion
-//#region src/shuffle.ts
+// src/shuffle.ts
 /**
 * Seeded, deterministic shuffling — the ONE algorithm every presentation-order
 * decision in the SDK goes through: option order in a multiple-choice item,
@@ -990,8 +981,7 @@ function shuffleWithSeed(items, seed, version) {
 function seededShuffle(items, seed, options = {}) {
 	return shuffleWithSeed(items, hashSeed(seed), options.version ?? 1);
 }
-//#endregion
-//#region src/scoring/assisted/routing.ts
+// src/scoring/assisted/routing.ts
 /** A threshold the caller configured: a finite number, and a rate within 0 to 1 where it is one. */
 function checkThreshold(name, value, rate) {
 	if (value === void 0) return;
@@ -1139,8 +1129,7 @@ function outcomeFromRoutedGrade(grade, routing) {
 		pendingGrade: routed
 	};
 }
-//#endregion
-//#region src/scoring/compose.ts
+// src/scoring/compose.ts
 function earned(item) {
 	const { outcome } = item;
 	if (hasGrade(outcome)) {
@@ -1271,8 +1260,7 @@ function composeAssessmentScore(sections, policy) {
 		unscorableSlotIds: unscorableAll
 	};
 }
-//#endregion
-//#region src/scoring/dictation/chars.ts
+// src/scoring/dictation/chars.ts
 /**
 * The code-point edit operations between two NORMALISED strings — the
 * `reference` and `attempt` of a `DictationAlignment`, or one word pair from
@@ -1307,8 +1295,7 @@ function diffDictationChars(reference, attempt) {
 		};
 	});
 }
-//#endregion
-//#region src/scoring/speech/tokens.ts
+// src/scoring/speech/tokens.ts
 /**
 * The normalised tokens of the words that can be marked, each remembering the
 * word it came from, up to what {@link SPEECH_ASSESSMENT_MAX_TEXT_LENGTH} code
@@ -1349,8 +1336,7 @@ function heardTokens(words) {
 		length
 	};
 }
-//#endregion
-//#region src/scoring/speech/assessment.ts
+// src/scoring/speech/assessment.ts
 /** A score on the assessment's 0..100 scale. `z.number()` refuses NaN and both infinities. */
 const Score = zod_v4.number().min(0).max(100);
 /** A confidence, 0..1. */
@@ -1572,8 +1558,7 @@ function validateSpeechAssessment(value) {
 		errors
 	};
 }
-//#endregion
-//#region src/scoring/speech/align.ts
+// src/scoring/speech/align.ts
 /**
 * The word's accuracy when it has one. Absent means the assessor did not
 * measure the word, which is never the same as measuring it at 0.
@@ -1712,8 +1697,7 @@ function placeInsertions(assessment, entries) {
 		});
 	});
 }
-//#endregion
-//#region src/scoring/speech/grade.ts
+// src/scoring/speech/grade.ts
 /**
 * The read-aloud grade: the arithmetic over a pronunciation assessment's
 * dimension scores, and the checks that decide whether that evidence may be
@@ -1904,8 +1888,7 @@ function gradeReadAloud(data, response, assessment, options) {
 function referenceWordsOf(data) {
 	return require_registry.dictationReferenceWords({ transcript: data.referenceText })[0];
 }
-//#endregion
-//#region src/scoring/speech/wav.ts
+// src/scoring/speech/wav.ts
 /** `RIFF` + the file size + `WAVE`, before the first chunk. */
 const HEADER_BYTES = 12;
 /** A chunk's four-character id and its little-endian size. */
@@ -2053,8 +2036,7 @@ function inspectWav(bytes, policy) {
 		voicedMs: Math.min(voicedMs, durationMs)
 	};
 }
-//#endregion
-//#region src/scoring/unscorable.ts
+// src/scoring/unscorable.ts
 /**
 * Lifts a result that cannot be graded — a `SpeechUnscorable` from
 * `gradeReadAloud`, or anything else carrying a `code` and a `reason` — into
@@ -2072,8 +2054,7 @@ function outcomeFromUnscorable(result) {
 		code: result.code
 	};
 }
-//#endregion
-//#region src/scoring/index.ts
+// src/scoring/index.ts
 /**
 * Scores a learner response against activity data and returns a full
 * {@link ScoringResult}.
@@ -2253,7 +2234,6 @@ function costed(data, opening, graded, rules, rounding) {
 		tries: result.tries
 	};
 }
-//#endregion
 Object.defineProperty(exports, "DEFAULT_ITEM_SCORING_POLICY", {
 	enumerable: true,
 	get: function() {
@@ -2465,4 +2445,4 @@ Object.defineProperty(exports, "validateSpeechAssessment", {
 	}
 });
 
-//# sourceMappingURL=scoring-lKQVYsxy.cjs.map
+//# sourceMappingURL=scoring-CtkCFyFT.cjs.map