@longsightgroup/qti3-core 0.7.2 → 0.8.0

package/src/support.ts

@@ -1,8 +1,12 @@
 import type {
+  QtiDiagnostic,
   QtiElementSupport,
   QtiInteractionElementSupport,
+  QtiInteractionRegistryStatus,
   QtiInteractionType,
+  QtiItemMetadataElementSupport,
   QtiProcessingElementSupport,
+  QtiSourceLocation,
 } from "./types.js";
 
 export const interactionSupport: QtiInteractionElementSupport[] = [
@@ -10,9 +14,7 @@ export const interactionSupport: QtiInteractionElementSupport[] = [
   entry("qti-choice-interaction", "choice"),
   entry("qti-drawing-interaction", "drawing"),
   entry("qti-end-attempt-interaction", "endAttempt"),
-  textControlInteractionEntry("qti-extended-text-interaction", "extendedText", [
-    "packages/fixtures/packages/sv-matrix/items/extended-text-pattern-mask.xml",
-  ]),
+  extendedTextInteractionEntry(),
   entry("qti-gap-match-interaction", "gapMatch"),
   entry("qti-graphic-associate-interaction", "graphicAssociate"),
   entry("qti-graphic-gap-match-interaction", "graphicGapMatch"),
@@ -27,9 +29,7 @@ export const interactionSupport: QtiInteractionElementSupport[] = [
   pciEntry(),
   entry("qti-select-point-interaction", "selectPoint"),
   entry("qti-slider-interaction", "slider"),
-  textControlInteractionEntry("qti-text-entry-interaction", "textEntry", [
-    "packages/fixtures/packages/sv-matrix/items/text-entry-pattern-mask-inline.xml",
-  ]),
+  textEntryInteractionEntry(),
   entry("qti-upload-interaction", "upload"),
 ];
 
@@ -192,10 +192,114 @@ export const processingSupport: QtiProcessingElementSupport[] = [
   processingEntry("qti-custom-operator", "packages/core/src/core.test.ts"),
 ];
 
+export const itemMetadataSupport: QtiItemMetadataElementSupport[] = [
+  {
+    qtiName: "qti-catalog-info",
+    category: "itemMetadata",
+    support: "parsed",
+    specReference: "QTI 3.0.1 ASI",
+    parse: true,
+    validate: true,
+    render: false,
+    process: false,
+    fixtures: [
+      "packages/fixtures/packages/basic-item-player/valid-item-only/items/tolerance-extra-features.xml",
+    ],
+    tests: ["packages/core/src/core.test.ts", "packages/core/src/parser-item-metadata.test.ts"],
+    notes:
+      "Parsed by parser-item-metadata.ts and validated by validateCatalogInfo. Duplicate containers emit item.child.duplicate.",
+  },
+  {
+    qtiName: "qti-stylesheet",
+    category: "itemMetadata",
+    support: "parsed",
+    specReference: "QTI 3.0.1 ASI",
+    parse: true,
+    validate: true,
+    render: false,
+    process: false,
+    fixtures: [
+      "packages/fixtures/packages/basic-item-player/valid-item-only/items/tolerance-extra-features.xml",
+    ],
+    tests: ["packages/core/src/core.test.ts", "packages/core/src/parser-item-metadata.test.ts"],
+    notes: "Parsed by parser-item-metadata.ts and validated by validateStylesheets.",
+  },
+  {
+    qtiName: "qti-modal-feedback",
+    category: "itemMetadata",
+    support: "parsed",
+    specReference: "QTI 3.0.1 ASI",
+    parse: true,
+    validate: true,
+    render: false,
+    process: false,
+    fixtures: ["packages/fixtures/src/index.ts"],
+    tests: ["packages/core/src/core.test.ts", "packages/core/src/parser-item-metadata.test.ts"],
+    notes:
+      "Parsed by parser-item-metadata.ts and validated by validateModalFeedback. Player rendering remains out of scope for this metadata slice.",
+  },
+  {
+    qtiName: "qti-companion-materials-info",
+    category: "itemMetadata",
+    support: "parsed",
+    specReference: "QTI 3.0.1 ASI",
+    parse: true,
+    validate: true,
+    render: false,
+    process: false,
+    fixtures: [
+      "packages/fixtures/packages/basic-item-player/valid-item-only/items/tolerance-extra-features.xml",
+    ],
+    tests: [
+      "packages/core/src/parser-companion-materials.test.ts",
+      "packages/core/src/parser-item-metadata.test.ts",
+    ],
+    notes:
+      "Parses qti-physical-material text only. qti-digital-material is preserved in unparsedChildren and emits companionMaterials.child.unsupported at parse time.",
+  },
+  {
+    qtiName: "qti-physical-material",
+    category: "itemMetadata",
+    support: "parsed",
+    specReference: "QTI 3.0.1 ASI",
+    parse: true,
+    validate: true,
+    render: false,
+    process: false,
+    fixtures: ["packages/core/src/parser-companion-materials.test.ts"],
+    tests: [
+      "packages/core/src/parser-companion-materials.test.ts",
+      "packages/core/src/parser-item-metadata.test.ts",
+    ],
+    notes:
+      "Child of qti-companion-materials-info. Empty XML text emits companionMaterials.physicalMaterial.empty at parse time; invalid model entries emit companionMaterials.physicalMaterial.empty.model at validation time.",
+  },
+  {
+    qtiName: "qti-digital-material",
+    category: "itemMetadata",
+    support: "unsupported",
+    specReference: "QTI 3.0.1 ASI",
+    parse: false,
+    validate: false,
+    render: false,
+    process: false,
+    fixtures: [
+      "packages/fixtures/packages/basic-item-player/valid-item-only/items/tolerance-extra-features.xml",
+    ],
+    tests: [
+      "packages/core/src/parser-companion-materials.test.ts",
+      "packages/core/src/parser-item-metadata.test.ts",
+    ],
+    notes:
+      "Recognized as an unparsed child of qti-companion-materials-info. Full digital material parsing is not implemented yet.",
+  },
+];
+
 export const elementSupport: QtiElementSupport[] = [
   ...interactionSupport,
   ...deprecatedInteractionSupport,
   ...processingSupport,
+  ...itemMetadataSupport,
 ];
 
 const allInteractionSupport = [...interactionSupport, ...deprecatedInteractionSupport];
@@ -208,6 +312,42 @@ export function getInteractionSupport(qtiName: string): QtiElementSupport | unde
   return allInteractionSupport.find((item) => item.qtiName === qtiName);
 }
 
+export function interactionRegistryStatus(qtiName: string): QtiInteractionRegistryStatus {
+  const support = getInteractionSupport(qtiName);
+  if (!support) return "unsupported";
+  return support.support === "deprecated" ? "deprecated" : "supported";
+}
+
+export function interactionRegistryDiagnostics(
+  qtiName: string,
+  source: QtiSourceLocation,
+): QtiDiagnostic[] {
+  const support = getInteractionSupport(qtiName);
+  if (!support) {
+    return [
+      {
+        code: "interaction.unsupported",
+        severity: "warning",
+        message: `${qtiName} is not currently in the support registry.`,
+        path: source.path,
+        source,
+      },
+    ];
+  }
+  if (support.support === "deprecated") {
+    return [
+      {
+        code: "interaction.deprecated",
+        severity: "warning",
+        message: `${qtiName} is deprecated. ${support.notes ?? ""}`.trim(),
+        path: source.path,
+        source,
+      },
+    ];
+  }
+  return [];
+}
+
 function entry(qtiName: string, interactionType: QtiInteractionType): QtiInteractionElementSupport {
   return {
     qtiName,
@@ -229,14 +369,34 @@ function entry(qtiName: string, interactionType: QtiInteractionType): QtiInterac
   };
 }
 
-function textControlInteractionEntry(
-  qtiName: string,
-  interactionType: "extendedText" | "textEntry",
-  extraFixtures: string[],
-): QtiInteractionElementSupport {
+function extendedTextInteractionEntry(): QtiInteractionElementSupport {
+  return {
+    ...entry("qti-extended-text-interaction", "extendedText"),
+    fixtures: [
+      "packages/fixtures/xml/extendedText-reference.xml",
+      "packages/fixtures/packages/sv-matrix/items/extended-text-pattern-mask.xml",
+      "packages/fixtures/packages/sv-matrix/items/extended-text-xhtml.xml",
+    ],
+    tests: [
+      "packages/fixtures/src/fixtures.test.ts",
+      "packages/conformance/src/conformance.test.ts",
+      "packages/a11y/src/a11y.test.ts",
+      "packages/core/src/pattern-mask.test.ts",
+      "tests/browser/player.spec.ts",
+      "tests/browser/player-dom-behavior.spec.ts",
+      "tests/browser/player-extended-text-xhtml.spec.ts",
+    ],
+    notes: "Supports plain and format=xhtml extended text.",
+  };
+}
+
+function textEntryInteractionEntry(): QtiInteractionElementSupport {
   return {
-    ...entry(qtiName, interactionType),
-    fixtures: [`packages/fixtures/xml/${interactionType}-reference.xml`, ...extraFixtures],
+    ...entry("qti-text-entry-interaction", "textEntry"),
+    fixtures: [
+      "packages/fixtures/xml/textEntry-reference.xml",
+      "packages/fixtures/packages/sv-matrix/items/text-entry-pattern-mask-inline.xml",
+    ],
     tests: [
       "packages/fixtures/src/fixtures.test.ts",
       "packages/conformance/src/conformance.test.ts",
@@ -245,7 +405,7 @@ function textControlInteractionEntry(
       "tests/browser/player.spec.ts",
       "tests/browser/player-dom-behavior.spec.ts",
     ],
-    notes: "Supports placeholder-text and pattern-mask on block and inline text-entry controls.",
+    notes: "Supports placeholder-text and pattern-mask on text-entry controls.",
   };
 }
 

package/src/types.ts

@@ -138,7 +138,10 @@ export interface QtiTemplateDeclaration extends QtiVariableDeclaration {
 
 export interface QtiChoice {
   identifier: string;
+  /** Plain-text fallback used for speech, TTS, diagnostics, and native controls. */
   text: string;
+  /** Parsed visual content for renderers that can display rich choice markup such as MathML. */
+  content?: QtiContentNode[] | undefined;
   asset?: QtiObjectAsset | undefined;
   role: QtiChoiceRole;
   qtiName: string;
@@ -186,18 +189,27 @@ export type QtiInteractionType =
   | "textEntry"
   | "upload";
 
+/** Parse-time status from the core interaction support registry. */
+export type QtiInteractionRegistryStatus = "supported" | "deprecated" | "unsupported";
+
 export interface QtiInteraction {
   type: QtiInteractionType;
+  /** Parse-time status from the core interaction support registry. */
+  registryStatus: QtiInteractionRegistryStatus;
   qtiName: string;
   responseIdentifier?: string | undefined;
   responseCardinality?: QtiCardinality | undefined;
   responseBaseType?: QtiBaseType | undefined;
+  /** Flat accessibility/fallback label derived from prompt content with annotations stripped. */
   prompt?: string | undefined;
+  /** Structured prompt content for visual rendering. When present, block headings render this instead of prompt. */
+  promptContent?: QtiContentNode[] | undefined;
   promptAttributes?: Record<string, string> | undefined;
   promptSource?: QtiSourceLocation | undefined;
   contextText?: string | undefined;
   object?: QtiObjectAsset | undefined;
   positionObjectStage?: QtiObjectAsset | undefined;
+  customInteraction?: QtiCustomInteractionDefinition | undefined;
   portableCustom?: QtiPortableCustomDefinition | undefined;
   choices: QtiChoice[];
   hottextSegments?: QtiHottextSegment[] | undefined;
@@ -266,20 +278,25 @@ export interface QtiMediaTrack {
   source?: QtiSourceLocation | undefined;
 }
 
-export interface QtiPortableCustomDefinition {
+export interface QtiInteractionMarkupDefinition {
   responseIdentifier?: string | undefined;
+  interactionMarkup: QtiContentNode[];
+  interactionMarkupRaw?: string | undefined;
+  dataAttributes: Record<string, string>;
+  attributes: Record<string, string>;
+  source?: QtiSourceLocation | undefined;
+}
+
+export type QtiCustomInteractionDefinition = QtiInteractionMarkupDefinition;
+
+export interface QtiPortableCustomDefinition extends QtiInteractionMarkupDefinition {
   customInteractionTypeIdentifier?: string | undefined;
   module?: string | undefined;
   interactionModules?: QtiPortableCustomInteractionModules | undefined;
-  interactionMarkup: QtiContentNode[];
-  interactionMarkupRaw?: string | undefined;
   templateVariables: QtiPortableCustomVariableBinding[];
   contextVariables: QtiPortableCustomVariableBinding[];
   stylesheets: QtiStylesheet[];
   catalogInfo?: QtiCatalogInfo | undefined;
-  dataAttributes: Record<string, string>;
-  attributes: Record<string, string>;
-  source?: QtiSourceLocation | undefined;
 }
 
 export interface QtiPortableCustomInteractionModules {
@@ -429,6 +446,7 @@ export interface QtiAssessmentItem {
   interactions: QtiInteraction[];
   modalFeedback: QtiModalFeedback[];
   catalogInfo?: QtiCatalogInfo | undefined;
+  companionMaterials?: QtiCompanionMaterialsInfo | undefined;
   catalogReferences: QtiCatalogReference[];
   stylesheets: QtiStylesheet[];
   body: QtiContentNode[];
@@ -436,6 +454,22 @@ export interface QtiAssessmentItem {
   source?: QtiSourceLocation | undefined;
 }
 
+export interface QtiCompanionMaterialsInfo {
+  physicalMaterials: QtiPhysicalMaterial[];
+  unparsedChildren: QtiCompanionMaterialsUnparsedChild[];
+  source?: QtiSourceLocation | undefined;
+}
+
+export interface QtiCompanionMaterialsUnparsedChild {
+  qtiName: string;
+  source?: QtiSourceLocation | undefined;
+}
+
+export interface QtiPhysicalMaterial {
+  text: string;
+  source?: QtiSourceLocation | undefined;
+}
+
 export interface QtiModalFeedback {
   identifier: string;
   outcomeIdentifier: string;
@@ -682,7 +716,10 @@ export interface QtiScoreResult {
   state: QtiAttemptStateV1;
 }
 
-export type QtiElementSupport = QtiInteractionElementSupport | QtiProcessingElementSupport;
+export type QtiElementSupport =
+  | QtiInteractionElementSupport
+  | QtiProcessingElementSupport
+  | QtiItemMetadataElementSupport;
 
 interface QtiElementSupportBase {
   qtiName: string;
@@ -706,6 +743,10 @@ export interface QtiProcessingElementSupport extends QtiElementSupportBase {
   category: "processing";
 }
 
+export interface QtiItemMetadataElementSupport extends QtiElementSupportBase {
+  category: "itemMetadata";
+}
+
 export interface SharedVocabularyClassSupport {
   className: string;
   scope: "interaction" | "content" | "gap";