@conform-ed/qti-xml 0.0.20 → 0.0.22

package/dist/cc-qti/convert-to-v3.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Bridge Common Cartridge QTI ASI 1.2.1 (`questestinterop`) into QTI 3.0.1 ASI XML, so a CC
+ * cartridge's assessments/question-banks can be ingested + delivered + scored by the same
+ * QTI 3 engine as everything else (ADR-0022). The conversion targets the *normalized* QTI 3
+ * document the serializers consume, so the emitted XML is guaranteed to re-validate via
+ * `validateQtiXmlContent`.
+ *
+ * A `questestinterop` is either an `<objectbank>` (→ N standalone items) or an `<assessment>`
+ * (→ N items + one `assessmentTest` that references them).
+ */
+export type CcQtiInteractionKind = "choice" | "textEntry" | "extendedText";
+export type CcQtiConvertedItem = {
+    identifier: string;
+    title: string;
+    ccProfile: string | undefined;
+    interactionKind: CcQtiInteractionKind;
+    xml: string;
+};
+export type CcQtiConvertedTest = {
+    identifier: string;
+    title: string;
+    itemIdentifiers: string[];
+    xml: string;
+};
+export type CcQtiConversionResult = {
+    status: "converted";
+    source: "assessment" | "objectbank";
+    items: CcQtiConvertedItem[];
+    test?: CcQtiConvertedTest;
+} | {
+    status: "invalid";
+    issues: string[];
+};
+/**
+ * Convert a CC `questestinterop` XML string into QTI 3.0.1 artifacts. Returns the converted
+ * item XMLs (+ a test XML when the source is an `<assessment>`), or a structured `invalid`
+ * result when the input is not even structurally valid CC QTI.
+ *
+ * Validation defaults to **structural** (the raw CC schema). The stricter CC *profile* rules
+ * (item-type coherence, no duplicate idents, feedback linkage) are opt-in via `{ profile: true }`
+ * — they are a conformance gate for clean cartridges, not a bar a best-effort import of a
+ * real-world export should trip over (those routinely violate the profile).
+ */
+export declare function convertCcQtiV1ToV3(xml: string, options?: {
+    profile?: boolean;
+}): CcQtiConversionResult;

package/dist/cc-qti/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./normalize-questestinterop";
+export * from "./convert-to-v3";

package/dist/cc-qti/normalize-questestinterop.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Normalize a Common Cartridge QTI ASI 1.2.1 (`questestinterop`) document — the QTI dialect
+ * CC 1.3/1.4 carries — from raw XML into the `kind`-tagged structure described by
+ * `@conform-ed/contracts/common-cartridge/v1_4`. This mirrors the QTI 3 `normalize.ts`
+ * pattern (XML node tree → typed contract shape) and is the input stage of the CC→QTI-3
+ * bridge (`convert-to-v3.ts`). The output is validated against the official CC profile, so
+ * non-conformant questestinterop is rejected here rather than silently mis-converted.
+ */
+import { type QtiQuestestinteropRaw } from "@conform-ed/contracts/common-cartridge/v1_4";
+/** CC 1.x carries QTI ASI 1.2.1 under this namespace. */
+export declare const ccQtiNamespace = "http://www.imsglobal.org/xsd/ims_qtiasiv1p2";
+export type NormalizeQuestestinteropResult = {
+    status: "valid";
+    document: {
+        questestinterop: QtiQuestestinteropRaw;
+    };
+} | {
+    status: "invalid";
+    issues: string[];
+};
+/**
+ * Parse + normalize a `questestinterop` XML string into the CC 1.4 contract shape and validate
+ * it. When `profile` is true (default), the stricter CC profile rules are applied (item-type
+ * coherence, feedback linkage); when false, only the structural raw schema is checked.
+ */
+export declare function normalizeQuestestinterop(xml: string, options?: {
+    profile?: boolean;
+}): NormalizeQuestestinteropResult;

package/dist/index.d.ts

@@ -12,3 +12,4 @@ export * from "./serialize-usage-data";
 export * from "./serialize-asi";
 export * from "./serialize-manifest";
 export * from "./serialize-document";
+export * from "./cc-qti";