@longsightgroup/qti3-core 0.1.1 → 0.2.0

package/README.md

@@ -38,6 +38,7 @@ if (parsed.document) {
 - Validate item-level QTI behavior and emit structured diagnostics.
 - Score supported response-processing patterns without a DOM.
 - Serialize and restore attempt state through `qti3.attempt-state.v1`.
+- Preserve QTI 3 Portable Custom Interaction metadata and opaque PCI interaction state.
 - Publish support metadata for current and deprecated item interactions.
 
 See the main repository README for the support matrix and release notes:

package/dist/catalog.d.ts

@@ -0,0 +1,32 @@
+import type { QtiAssessmentItem, QtiCatalog, QtiCatalogFileHref, QtiCatalogHtmlContent, QtiDocument, QtiSourceLocation } from "./types.js";
+export interface QtiCatalogSupportResolutionOptions {
+    supports?: string | readonly string[] | undefined;
+    languages?: string | readonly string[] | undefined;
+    includeDefaultFallback?: boolean | undefined;
+}
+export interface QtiCatalogSupportResolution {
+    itemIdentifier: string;
+    references: QtiResolvedCatalogReference[];
+}
+export interface QtiResolvedCatalogReference {
+    idref: string;
+    catalog?: QtiCatalog | undefined;
+    matches: QtiResolvedCatalogSupport[];
+    source?: QtiSourceLocation | undefined;
+}
+export interface QtiResolvedCatalogSupport {
+    catalogId: string;
+    support: string;
+    default: boolean;
+    fileHrefs: QtiCatalogFileHref[];
+    attributes: Record<string, string>;
+    cardAttributes: Record<string, string>;
+    catalogAttributes: Record<string, string>;
+    language?: string | undefined;
+    htmlContent?: QtiCatalogHtmlContent | undefined;
+    source?: QtiSourceLocation | undefined;
+    cardSource?: QtiSourceLocation | undefined;
+    catalogSource?: QtiSourceLocation | undefined;
+}
+export declare function createCatalogSupportResolution(model: QtiDocument | QtiAssessmentItem, options?: QtiCatalogSupportResolutionOptions): QtiCatalogSupportResolution;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EAGV,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACnD,sBAAsB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,WAAW,2BAA2B;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,2BAA2B,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACjC,OAAO,EAAE,yBAAyB,EAAE,CAAC;IACrC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAChD,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvC,UAAU,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC3C,aAAa,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CAC/C;AAYD,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,WAAW,GAAG,iBAAiB,EACtC,OAAO,GAAE,kCAAuC,GAC/C,2BAA2B,CAqB7B"}

package/dist/catalog.js

@@ -0,0 +1,126 @@
+export function createCatalogSupportResolution(model, options = {}) {
+    const item = "item" in model ? model.item : model;
+    const supportFilter = stringFilter(options.supports);
+    const languages = stringList(options.languages).map((language) => language.toLowerCase());
+    const catalogById = new Map(item.catalogInfo?.catalogs.map((catalog) => [catalog.id, catalog]) ?? []);
+    return {
+        itemIdentifier: item.identifier,
+        references: item.catalogReferences.map((reference) => {
+            const catalog = catalogById.get(reference.idref);
+            const resolved = {
+                idref: reference.idref,
+                matches: catalog ? matchingCatalogSupports(catalog, supportFilter, languages, options) : [],
+            };
+            if (catalog)
+                resolved.catalog = catalog;
+            if (reference.source)
+                resolved.source = reference.source;
+            return resolved;
+        }),
+    };
+}
+function matchingCatalogSupports(catalog, supportFilter, languages, options) {
+    return catalog.cards.flatMap((card) => {
+        if (supportFilter && !supportFilter.has(card.support.toLowerCase()))
+            return [];
+        return selectedCandidates(card, languages, options).map((candidate) => resolvedSupport(catalog, candidate));
+    });
+}
+function selectedCandidates(card, languages, options) {
+    const candidates = catalogCandidates(card);
+    if (languages.length === 0) {
+        const defaults = candidates.filter((candidate) => candidate.default);
+        return defaults.length > 0 ? defaults : candidates;
+    }
+    const languageMatches = candidates
+        .map((candidate, index) => ({
+        candidate,
+        index,
+        rank: languageMatchRank(candidate.language, languages),
+    }))
+        .filter((entry) => Number.isInteger(entry.rank))
+        .sort((a, b) => a.rank - b.rank || a.index - b.index);
+    if (languageMatches.length > 0)
+        return languageMatches.map((entry) => entry.candidate);
+    if (options.includeDefaultFallback === false)
+        return [];
+    const defaults = candidates.filter((candidate) => candidate.default);
+    return defaults.length > 0 ? defaults : candidates.filter((candidate) => !candidate.language);
+}
+function catalogCandidates(card) {
+    if (card.entries.length > 0) {
+        return card.entries.map((entry) => entryCandidate(card, entry));
+    }
+    return [
+        {
+            card,
+            default: true,
+            fileHrefs: card.fileHrefs,
+            attributes: card.attributes,
+            htmlContent: card.htmlContent,
+            source: card.source,
+        },
+    ];
+}
+function entryCandidate(card, entry) {
+    const candidate = {
+        card,
+        default: entry.default,
+        fileHrefs: entry.fileHrefs,
+        attributes: entry.attributes,
+    };
+    if (entry.language)
+        candidate.language = entry.language;
+    if (entry.htmlContent)
+        candidate.htmlContent = entry.htmlContent;
+    if (entry.source)
+        candidate.source = entry.source;
+    return candidate;
+}
+function resolvedSupport(catalog, candidate) {
+    const resolved = {
+        catalogId: catalog.id,
+        support: candidate.card.support,
+        default: candidate.default,
+        fileHrefs: candidate.fileHrefs,
+        attributes: candidate.attributes,
+        cardAttributes: candidate.card.attributes,
+        catalogAttributes: catalog.attributes,
+    };
+    if (candidate.language)
+        resolved.language = candidate.language;
+    if (candidate.htmlContent)
+        resolved.htmlContent = candidate.htmlContent;
+    if (candidate.source)
+        resolved.source = candidate.source;
+    if (candidate.card.source)
+        resolved.cardSource = candidate.card.source;
+    if (catalog.source)
+        resolved.catalogSource = catalog.source;
+    return resolved;
+}
+function languageMatchRank(language, requestedLanguages) {
+    if (!language)
+        return undefined;
+    const normalizedLanguage = language.toLowerCase();
+    const primaryLanguage = normalizedLanguage.split("-")[0] ?? normalizedLanguage;
+    for (const [index, requestedLanguage] of requestedLanguages.entries()) {
+        if (normalizedLanguage === requestedLanguage)
+            return index * 2;
+        const requestedPrimary = requestedLanguage.split("-")[0] ?? requestedLanguage;
+        if (primaryLanguage === requestedPrimary)
+            return index * 2 + 1;
+    }
+    return undefined;
+}
+function stringFilter(value) {
+    const values = stringList(value).map((entry) => entry.toLowerCase());
+    return values.length > 0 ? new Set(values) : undefined;
+}
+function stringList(value) {
+    if (value === undefined)
+        return [];
+    const entries = Array.isArray(value) ? value : [value];
+    return entries.map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,8 @@
+export { createCatalogSupportResolution, type QtiCatalogSupportResolution, type QtiCatalogSupportResolutionOptions, type QtiResolvedCatalogReference, type QtiResolvedCatalogSupport, } from "./catalog.js";
 export { parseQtiXml } from "./parser.js";
+export { createTextToSpeechTraversal, parseQtiDataSsml, validateQtiDataSsmlMetadata, type QtiDataSsml, type QtiDataSsmlBreak, type QtiDataSsmlBreakStrength, type QtiDataSsmlParseResult, type QtiDataSsmlPhoneme, type QtiDataSsmlProsody, type QtiDataSsmlSayAs, type QtiDataSsmlSub, type QtiTextToSpeechSegment, type QtiTextToSpeechSegmentKind, type QtiTextToSpeechTraversal, } from "./tts.js";
 export { assertQtiAttemptStateV1, createItemSession, isQtiAttemptStateV1, visibleModalFeedback, type QtiCustomOperatorContext, type QtiCustomOperatorHandler, type QtiCustomOperatorRegistry, type QtiItemSession, type QtiItemSessionOptions, } from "./session.js";
 export { deprecatedInteractionSupport, elementSupport, getInteractionSupport, interactionNameToType, interactionSupport, processingSupport, } from "./support.js";
 export { validateAssessmentItem } from "./validation.js";
-export type { QtiAssessmentItem, QtiAttemptStatus, QtiAttemptStateV1, QtiChoice, QtiChoiceRole, QtiContentNode, QtiDiagnostic, QtiDocument, QtiElementSupport, QtiInteractionElementSupport, QtiInteraction, QtiInteractionType, QtiModalFeedback, QtiObjectAsset, QtiParseResult, QtiProcessingElementSupport, QtiResponseBranch, QtiScoreResult, QtiSupportStatus, QtiTemplateDeclaration, QtiTemplateBranch, QtiTemplateProcessing, QtiTemplateRule, QtiValidationResult, QtiValue, } from "./types.js";
+export type { QtiAssessmentItem, QtiAttemptStatus, QtiAttemptStateV1, QtiCatalog, QtiCatalogCard, QtiCatalogCardEntry, QtiCatalogFileHref, QtiCatalogHtmlContent, QtiCatalogInfo, QtiCatalogReference, QtiChoice, QtiChoiceRole, QtiContentNode, QtiDiagnostic, QtiDocument, QtiElementSupport, QtiInteractionElementSupport, QtiInteraction, QtiInteractionType, QtiMediaSource, QtiMediaTrack, QtiModalFeedback, QtiObjectAsset, QtiParseResult, QtiProcessingElementSupport, QtiPortableCustomDefinition, QtiPortableCustomInteractionModule, QtiPortableCustomInteractionModules, QtiPortableCustomStateValue, QtiPortableCustomVariableBinding, QtiResponseBranch, QtiScoreResult, QtiSupportStatus, QtiTemplateDeclaration, QtiTemplateBranch, QtiTemplateProcessing, QtiTemplateRule, QtiValidationResult, QtiValue, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,4BAA4B,EAC5B,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,cAAc,EACd,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,4BAA4B,EAC5B,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,2BAA2B,EAC3B,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,QAAQ,GACT,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,KAAK,2BAA2B,EAChC,KAAK,kCAAkC,EACvC,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,GAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,2BAA2B,EAC3B,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,GAC9B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,4BAA4B,EAC5B,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,cAAc,EACd,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,4BAA4B,EAC5B,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,EAC3B,kCAAkC,EAClC,mCAAmC,EACnC,2BAA2B,EAC3B,gCAAgC,EAChC,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,QAAQ,GACT,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,4 +1,6 @@
+export { createCatalogSupportResolution, } from "./catalog.js";
 export { parseQtiXml } from "./parser.js";
+export { createTextToSpeechTraversal, parseQtiDataSsml, validateQtiDataSsmlMetadata, } from "./tts.js";
 export { assertQtiAttemptStateV1, createItemSession, isQtiAttemptStateV1, visibleModalFeedback, } from "./session.js";
 export { deprecatedInteractionSupport, elementSupport, getInteractionSupport, interactionNameToType, interactionSupport, processingSupport, } from "./support.js";
 export { validateAssessmentItem } from "./validation.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GAMrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,4BAA4B,EAC5B,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,GAK/B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,2BAA2B,GAY5B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GAMrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,4BAA4B,EAC5B,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAsBV,cAAc,EAcf,MAAM,YAAY,CAAC;AAiBpB,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CA0CvD"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAuBV,cAAc,EAkBf,MAAM,YAAY,CAAC;AAiBpB,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CA0CvD"}

package/dist/parser.js

@@ -78,6 +78,7 @@ function parseAssessmentItem(node, diagnostics) {
     return {
         identifier,
         title: node.attributes.title,
+        language: node.attributes["xml:lang"] ?? node.attributes.lang,
         adaptive: node.attributes.adaptive === "true",
         prompt: prompt ? textContent(prompt) : undefined,
         responseDeclarations,
@@ -351,7 +352,11 @@ function parseInteraction(node, diagnostics, responseDeclarationMap) {
     }
     const objectNode = interactionType === "positionObject"
         ? positionObjectInteractionObject(node)
-        : descendants(node, (child) => child.localName === "object" || child.localName === "img")[0];
+        : interactionType === "media"
+            ? mediaInteractionObject(node)
+            : interactionType === "drawing"
+                ? drawingInteractionObject(node)
+                : descendants(node, (child) => child.localName === "object" || child.localName === "img")[0];
     return {
         type: interactionType ?? "custom",
         qtiName: node.localName,
@@ -359,11 +364,16 @@ function parseInteraction(node, diagnostics, responseDeclarationMap) {
         responseCardinality: responseDeclaration?.cardinality,
         responseBaseType: responseDeclaration?.baseType,
         prompt: prompt ? textContent(prompt) : undefined,
+        promptAttributes: prompt?.attributes,
+        promptSource: prompt?.source,
         contextText: inlineInteractionContext(node, interactionType),
         object: parseObjectAsset(objectNode),
         positionObjectStage: interactionType === "positionObject"
             ? parseObjectAsset(positionObjectStageObject(node))
             : undefined,
+        portableCustom: interactionType === "portableCustom"
+            ? parsePortableCustomDefinition(node, diagnostics)
+            : undefined,
         choices: parseChoices(node),
         hottextSegments: interactionType === "hottext" ? parseHottextSegments(node) : undefined,
         gapMatchSegments: interactionType === "gapMatch" || interactionType === "graphicGapMatch"
@@ -378,9 +388,147 @@ function parseInteraction(node, diagnostics, responseDeclarationMap) {
         source: node.source,
     };
 }
+function parsePortableCustomDefinition(node, diagnostics) {
+    const markup = firstChildElement(node, "qti-interaction-markup", diagnostics);
+    const modules = firstChildElement(node, "qti-interaction-modules", diagnostics);
+    return {
+        responseIdentifier: node.attributes["response-identifier"],
+        customInteractionTypeIdentifier: node.attributes["custom-interaction-type-identifier"],
+        module: node.attributes.module,
+        interactionModules: modules ? parsePortableCustomInteractionModules(modules) : undefined,
+        interactionMarkup: markup ? parsePortableCustomMarkupChildren(markup, diagnostics) : [],
+        interactionMarkupRaw: markup ? serializeXmlContent(markup) : undefined,
+        templateVariables: childElements(node, "qti-template-variable").map((variable) => parsePortableCustomVariableBinding(variable, "template")),
+        contextVariables: childElements(node, "qti-context-variable").map((variable) => parsePortableCustomVariableBinding(variable, "context")),
+        stylesheets: childElements(node, "qti-stylesheet").map(parseStylesheet),
+        catalogInfo: parseCatalogInfo(childElements(node, "qti-catalog-info")[0]),
+        dataAttributes: Object.fromEntries(Object.entries(node.attributes).filter(([name]) => name.startsWith("data-"))),
+        attributes: node.attributes,
+        source: node.source,
+    };
+}
+function firstChildElement(node, name, diagnostics) {
+    const matches = childElements(node, name);
+    if (matches.length > 1) {
+        diagnostics.push({
+            code: "interaction.portableCustom.child.duplicate",
+            severity: "error",
+            message: `${node.localName} allows at most one ${name} child.`,
+            path: matches[1]?.source?.path ?? node.source?.path,
+            source: matches[1]?.source ?? node.source,
+        });
+    }
+    return matches[0];
+}
+function parsePortableCustomMarkupChildren(node, diagnostics) {
+    const content = [];
+    for (const entry of node.content) {
+        if (typeof entry === "string") {
+            if (entry.length > 0)
+                content.push({ kind: "text", text: entry, source: node.source });
+            continue;
+        }
+        content.push(parsePortableCustomMarkupNode(entry, diagnostics));
+    }
+    return content;
+}
+function parsePortableCustomMarkupNode(node, diagnostics) {
+    if (isInteractionElement(node)) {
+        diagnostics.push({
+            code: "interaction.portableCustom.markupInteraction",
+            severity: "error",
+            message: `qti-interaction-markup must not contain nested QTI interaction ${node.localName}.`,
+            path: node.source?.path,
+            source: node.source,
+        });
+    }
+    if (node.localName === "qti-printed-variable") {
+        return {
+            kind: "printedVariable",
+            identifier: node.attributes.identifier ?? "",
+            format: node.attributes.format,
+            attributes: node.attributes,
+            source: node.source,
+        };
+    }
+    if (node.localName === "qti-feedback-block" || node.localName === "qti-feedback-inline") {
+        return {
+            kind: "feedback",
+            feedbackType: node.localName === "qti-feedback-block" ? "block" : "inline",
+            identifier: node.attributes.identifier ?? "",
+            outcomeIdentifier: node.attributes["outcome-identifier"] ?? "",
+            showHide: node.attributes["show-hide"] === "hide" ? "hide" : "show",
+            attributes: node.attributes,
+            children: parsePortableCustomMarkupChildren(node, diagnostics),
+            source: node.source,
+        };
+    }
+    return {
+        kind: "element",
+        qtiName: node.localName,
+        attributes: node.attributes,
+        children: parsePortableCustomMarkupChildren(node, diagnostics),
+        source: node.source,
+    };
+}
+function parsePortableCustomInteractionModules(node) {
+    return {
+        primaryConfiguration: node.attributes["primary-configuration"],
+        secondaryConfiguration: node.attributes["secondary-configuration"] ?? node.attributes["fallback-configuration"],
+        modules: childElements(node, "qti-interaction-module").map(parsePortableCustomInteractionModule),
+        attributes: node.attributes,
+        source: node.source,
+    };
+}
+function parsePortableCustomInteractionModule(node) {
+    return {
+        id: node.attributes.id,
+        primaryPath: node.attributes["primary-path"],
+        fallbackPath: node.attributes["fallback-path"],
+        attributes: node.attributes,
+        source: node.source,
+    };
+}
+function parsePortableCustomVariableBinding(node, kind) {
+    return {
+        kind,
+        identifier: node.attributes.identifier ?? node.attributes["template-identifier"],
+        variableIdentifier: node.attributes["variable-identifier"],
+        attributes: node.attributes,
+        source: node.source,
+    };
+}
+function serializeXmlContent(node) {
+    return node.content
+        .map((entry) => (typeof entry === "string" ? escapeXmlText(entry) : serializeXmlNode(entry)))
+        .join("");
+}
+function serializeXmlNode(node) {
+    const attributes = Object.entries(node.attributes)
+        .map(([name, value]) => ` ${name}="${escapeXmlAttribute(value)}"`)
+        .join("");
+    if (node.content.length === 0)
+        return `<${node.name}${attributes}/>`;
+    return `<${node.name}${attributes}>${serializeXmlContent(node)}</${node.name}>`;
+}
+function escapeXmlText(value) {
+    return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function escapeXmlAttribute(value) {
+    return escapeXmlText(value).replaceAll('"', "&quot;");
+}
 function positionObjectInteractionObject(node) {
     return childElements(node).find((child) => child.localName === "object" || child.localName === "img");
 }
+function mediaInteractionObject(node) {
+    return childElements(node).find((child) => child.localName === "audio" ||
+        child.localName === "video" ||
+        child.localName === "object" ||
+        child.localName === "img");
+}
+function drawingInteractionObject(node) {
+    return childElements(node).find((child) => child.localName === "object" || child.localName === "img" || child.localName === "picture");
+}
 function positionObjectStageObject(node) {
     const ancestorStage = nearestAncestor(node, "qti-position-object-stage");
     const stage = ancestorStage ?? childElements(node, "qti-position-object-stage")[0];
@@ -478,17 +626,148 @@ function normalizeInlineContext(value) {
 function parseObjectAsset(node) {
     if (!node)
         return undefined;
-    const data = node.attributes.data ?? node.attributes.src;
+    const pictureImage = node.localName === "picture" ? childElements(node, "img")[0] : undefined;
+    const data = node.attributes.data ?? node.attributes.src ?? pictureImage?.attributes.src;
+    const sources = parseMediaSources(node);
+    const tracks = parseMediaTracks(node);
+    const inferredSvgDimensions = inlineSvgDimensions(data);
     return {
         data,
-        type: node.attributes.type ?? assetTypeFromData(data),
-        width: node.attributes.width,
-        height: node.attributes.height,
-        text: textContent(node),
+        type: node.attributes.type ??
+            pictureImage?.attributes.type ??
+            assetTypeFromData(data) ??
+            firstSourceType(sources),
+        width: node.attributes.width ?? pictureImage?.attributes.width ?? inferredSvgDimensions?.width,
+        height: node.attributes.height ?? pictureImage?.attributes.height ?? inferredSvgDimensions?.height,
+        sources,
+        tracks,
+        text: textContent(node) || node.attributes.alt || pictureImage?.attributes.alt || "",
         attributes: node.attributes,
         source: node.source,
     };
 }
+function inlineSvgDimensions(data) {
+    const svgText = decodeInlineSvgData(data);
+    if (!svgText)
+        return undefined;
+    const tree = parseXmlTree(svgText);
+    const svg = tree.root;
+    if (!svg || svg.localName !== "svg")
+        return undefined;
+    const width = svgLength(svg.attributes.width);
+    const height = svgLength(svg.attributes.height);
+    if (width !== undefined && height !== undefined) {
+        return { width: formatDimension(width), height: formatDimension(height) };
+    }
+    const viewBox = svgViewBoxDimensions(svg.attributes.viewBox);
+    if (!viewBox)
+        return undefined;
+    const inferredWidth = width ?? viewBox.width;
+    const inferredHeight = height ?? viewBox.height;
+    if (inferredWidth <= 0 || inferredHeight <= 0)
+        return undefined;
+    return { width: formatDimension(inferredWidth), height: formatDimension(inferredHeight) };
+}
+function decodeInlineSvgData(data) {
+    if (!data)
+        return undefined;
+    const comma = data.indexOf(",");
+    if (comma < 0)
+        return undefined;
+    const metadata = data.slice(0, comma);
+    if (!/^data:image\/svg\+xml(?:[;,]|$)/i.test(metadata))
+        return undefined;
+    const payload = data.slice(comma + 1);
+    if (/;base64(?:[;,]|$)/i.test(metadata))
+        return decodeBase64Ascii(payload);
+    try {
+        return decodeURIComponent(payload);
+    }
+    catch {
+        return payload;
+    }
+}
+function decodeBase64Ascii(value) {
+    const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+    const cleaned = value.replace(/\s+/g, "").replace(/=+$/, "");
+    let bits = 0;
+    let buffer = 0;
+    let output = "";
+    for (const char of cleaned) {
+        const digit = alphabet.indexOf(char);
+        if (digit < 0)
+            return undefined;
+        buffer = (buffer << 6) | digit;
+        bits += 6;
+        if (bits < 8)
+            continue;
+        bits -= 8;
+        output += String.fromCharCode((buffer >> bits) & 0xff);
+    }
+    return output;
+}
+function svgLength(value) {
+    if (!value || value.trim().endsWith("%"))
+        return undefined;
+    const match = value.trim().match(/^(\d+(?:\.\d+)?|\.\d+)(?:px)?$/i);
+    if (!match?.[1])
+        return undefined;
+    const parsed = Number(match[1]);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+}
+function svgViewBoxDimensions(value) {
+    const parts = value
+        ?.trim()
+        .split(/[\s,]+/)
+        .map((part) => Number(part));
+    if (!parts || parts.length !== 4 || parts.some((part) => !Number.isFinite(part))) {
+        return undefined;
+    }
+    const width = parts[2];
+    const height = parts[3];
+    if (width === undefined || height === undefined || width <= 0 || height <= 0)
+        return undefined;
+    return { width, height };
+}
+function formatDimension(value) {
+    return Number.isInteger(value) ? String(value) : String(Number(value.toFixed(4)));
+}
+function parseMediaSources(node) {
+    return childElements(node, "source").map((source) => {
+        const src = source.attributes.src ?? firstSrcsetCandidate(source.attributes.srcset);
+        return {
+            src,
+            type: source.attributes.type ?? assetTypeFromData(src),
+            attributes: source.attributes,
+            source: source.source,
+        };
+    });
+}
+function parseMediaTracks(node) {
+    return childElements(node, "track").map((track) => ({
+        kind: track.attributes.kind,
+        src: track.attributes.src,
+        srclang: track.attributes.srclang,
+        label: track.attributes.label,
+        default: track.attributes.default !== undefined,
+        attributes: track.attributes,
+        source: track.source,
+    }));
+}
+function firstSourceType(sources) {
+    const explicitType = sources.find((source) => source.type)?.type;
+    if (explicitType)
+        return explicitType;
+    return sources.find((source) => source.src)?.src
+        ? assetTypeFromData(sources.find((source) => source.src)?.src)
+        : undefined;
+}
+function firstSrcsetCandidate(srcset) {
+    return srcset
+        ?.split(",")
+        .map((candidate) => candidate.trim().split(/\s+/)[0])
+        .find((candidate) => candidate && candidate.length > 0);
+}
 function assetTypeFromData(data) {
     if (!data)
         return undefined;
@@ -496,8 +775,16 @@ function assetTypeFromData(data) {
         return "image/svg+xml";
     if (data.startsWith("data:image/"))
         return "image/*";
+    if (data.startsWith("data:audio/"))
+        return "audio/*";
+    if (data.startsWith("data:video/"))
+        return "video/*";
     if (/\.(svg|png|jpg|jpeg|gif|webp)(?:[?#].*)?$/i.test(data))
         return "image/*";
+    if (/\.(aac|flac|m4a|mp3|oga|ogg|opus|wav)(?:[?#].*)?$/i.test(data))
+        return "audio/*";
+    if (/\.(m4v|mov|mp4|ogv|webm)(?:[?#].*)?$/i.test(data))
+        return "video/*";
     return undefined;
 }
 function parseChoices(node) {