@longsightgroup/qti3-core 0.9.3 → 0.9.4

package/dist/qti-package-manifest.js

@@ -0,0 +1,109 @@
+import { normalizePackagePath, pushPackageDiagnostic } from "./qti-package-paths.js";
+import { childPackageElements, packageDescendants, stripHrefSuffix } from "./qti-package-xml.js";
+export const QTI_PACKAGE_MANIFEST_PATH = "imsmanifest.xml";
+export function isQtiItemResource(type) {
+    return type.toLowerCase().startsWith("imsqti_item_xmlv3p0");
+}
+export function isQtiAssessmentTestResource(type) {
+    return type.toLowerCase().startsWith("imsqti_test_xmlv3p0");
+}
+export function parseManifestResources(manifestRoot, entriesByPath, diagnostics) {
+    const resourceNodes = packageDescendants(manifestRoot, "resources").flatMap((resources) => childPackageElements(resources, "resource"));
+    const resources = [];
+    for (const node of resourceNodes) {
+        const identifier = node.attributes.identifier ?? "";
+        if (identifier.length === 0) {
+            pushPackageDiagnostic(diagnostics, "package.manifest.resource.identifier.missing", "error", "Manifest resource is missing an identifier.", QTI_PACKAGE_MANIFEST_PATH);
+        }
+        const files = parseManifestFiles(node, entriesByPath, diagnostics);
+        const href = node.attributes.href === undefined
+            ? firstXmlManifestFileHref(files)
+            : normalizePackagePath(stripHrefSuffix(node.attributes.href), `manifest resource ${identifier || "(missing identifier)"} href`, diagnostics);
+        const dependencies = parseManifestDependencies(node, diagnostics);
+        resources.push({
+            identifier,
+            type: node.attributes.type ?? "",
+            href,
+            files,
+            dependencies,
+            attributes: { ...node.attributes },
+        });
+    }
+    return resources;
+}
+function parseManifestFiles(resourceNode, entriesByPath, diagnostics) {
+    const files = [];
+    for (const fileNode of packageDescendants(resourceNode, "file")) {
+        const rawHref = fileNode.attributes.href;
+        if (!rawHref) {
+            pushPackageDiagnostic(diagnostics, "package.manifest.file.href.missing", "error", "Manifest file entry is missing href.", QTI_PACKAGE_MANIFEST_PATH);
+            continue;
+        }
+        const href = normalizePackagePath(stripHrefSuffix(rawHref), "manifest file href", diagnostics);
+        if (!href)
+            continue;
+        files.push({ href, attributes: { ...fileNode.attributes } });
+        if (!entriesByPath.has(href)) {
+            pushPackageDiagnostic(diagnostics, "package.manifest.file.missing", "error", `Manifest file reference ${href} was not found in the package.`, href);
+        }
+    }
+    return files;
+}
+function parseManifestDependencies(resourceNode, diagnostics) {
+    const dependencies = [];
+    for (const dependencyNode of packageDescendants(resourceNode, "dependency")) {
+        const identifierref = dependencyNode.attributes.identifierref;
+        if (!identifierref) {
+            pushPackageDiagnostic(diagnostics, "package.manifest.dependency.identifierref.missing", "error", "Manifest dependency is missing identifierref.", QTI_PACKAGE_MANIFEST_PATH);
+            continue;
+        }
+        dependencies.push(identifierref);
+    }
+    return [...new Set(dependencies)];
+}
+function firstXmlManifestFileHref(files) {
+    return files.find((file) => file.href.toLowerCase().endsWith(".xml"))?.href;
+}
+export function indexManifestResources(resources, diagnostics) {
+    const byIdentifier = new Map();
+    for (const resource of resources) {
+        const identifier = resource.identifier;
+        if (identifier.length === 0)
+            continue;
+        if (byIdentifier.has(identifier)) {
+            pushPackageDiagnostic(diagnostics, "package.manifest.resource.identifier.duplicate", "error", `Manifest contains duplicate resource identifier ${identifier}.`, QTI_PACKAGE_MANIFEST_PATH);
+            continue;
+        }
+        byIdentifier.set(identifier, resource);
+    }
+    return byIdentifier;
+}
+export function diagnoseManifestDependencyReferences(resources, resourcesByIdentifier, diagnostics) {
+    for (const resource of resources) {
+        for (const dependency of resource.dependencies) {
+            if (resourcesByIdentifier.has(dependency))
+                continue;
+            pushPackageDiagnostic(diagnostics, "package.manifest.dependency.missing", "error", `Manifest resource ${resource.identifier} depends on missing resource ${dependency}.`, QTI_PACKAGE_MANIFEST_PATH);
+        }
+    }
+}
+export function diagnosePrimaryResourceHrefs(resources, diagnostics) {
+    for (const resource of resources) {
+        if (resource.href)
+            continue;
+        pushPackageDiagnostic(diagnostics, "package.manifest.resource.href.missing", "error", `Manifest resource ${resource.identifier || "(missing identifier)"} is missing a primary XML href.`, QTI_PACKAGE_MANIFEST_PATH);
+    }
+}
+export function detectPackageShape(itemResources, assessmentTestResources, diagnostics) {
+    if (assessmentTestResources.length > 0 && itemResources.length > 0) {
+        pushPackageDiagnostic(diagnostics, "package.shape.ambiguous", "error", "Manifest contains both QTI item resources and QTI assessment-test resources.", QTI_PACKAGE_MANIFEST_PATH);
+        return "unknown";
+    }
+    if (assessmentTestResources.length > 0)
+        return "assessment-test-resource";
+    if (itemResources.length > 0)
+        return "manifest-item-resources";
+    pushPackageDiagnostic(diagnostics, "package.shape.unsupported", "error", "Manifest does not contain QTI item or assessment-test resources.", QTI_PACKAGE_MANIFEST_PATH);
+    return "unknown";
+}
+//# sourceMappingURL=qti-package-manifest.js.map

package/dist/qti-package-manifest.js.map

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

package/dist/qti-package-metadata.d.ts

@@ -0,0 +1,8 @@
+import type { QtiPackageXmlNode } from "./package-xml.js";
+import type { QtiAssessmentTestPackageModel, QtiPackageItem, QtiStandardAlignment, QtiTimingMetadata } from "./qti-package-types.js";
+export declare function parseTimingMetadata(root: QtiPackageXmlNode, sourcePath: string): QtiTimingMetadata | undefined;
+export declare function parseStandardAlignments(root: QtiPackageXmlNode, sourcePath: string): QtiStandardAlignment[];
+export declare function uniqueStandards(standards: readonly QtiStandardAlignment[]): QtiStandardAlignment[];
+export declare function primaryTiming(assessmentTest: QtiAssessmentTestPackageModel | undefined, items: readonly QtiPackageItem[]): QtiTimingMetadata | undefined;
+export declare function packageTitle(manifestRoot: QtiPackageXmlNode | undefined, assessmentTest: QtiAssessmentTestPackageModel | undefined, items: readonly QtiPackageItem[]): string;
+//# sourceMappingURL=qti-package-metadata.d.ts.map

package/dist/qti-package-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qti-package-metadata.d.ts","sourceRoot":"","sources":["../src/qti-package-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,KAAK,EACV,6BAA6B,EAC7B,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAkBhC,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,EACvB,UAAU,EAAE,MAAM,GACjB,iBAAiB,GAAG,SAAS,CAa/B;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,iBAAiB,EACvB,UAAU,EAAE,MAAM,GACjB,oBAAoB,EAAE,CAgCxB;AAeD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,oBAAoB,EAAE,GACzC,oBAAoB,EAAE,CAkBxB;AAED,wBAAgB,aAAa,CAC3B,cAAc,EAAE,6BAA6B,GAAG,SAAS,EACzD,KAAK,EAAE,SAAS,cAAc,EAAE,GAC/B,iBAAiB,GAAG,SAAS,CAI/B;AAED,wBAAgB,YAAY,CAC1B,YAAY,EAAE,iBAAiB,GAAG,SAAS,EAC3C,cAAc,EAAE,6BAA6B,GAAG,SAAS,EACzD,KAAK,EAAE,SAAS,cAAc,EAAE,GAC/B,MAAM,CAaR"}

package/dist/qti-package-metadata.js

@@ -0,0 +1,115 @@
+import { parseXmlBoolean } from "./parser-values.js";
+import { packageDescendants } from "./qti-package-xml.js";
+/** Known QTI / IMS CP alignment element names plus attribute-driven manifest metadata. */
+const STANDARD_ALIGNMENT_ELEMENT_NAMES = new Set([
+    "standard-alignment",
+    "qti-standard-alignment",
+    "alignment-objective",
+]);
+const STANDARD_ALIGNMENT_ATTRIBUTE_NAMES = new Set([
+    "standard-id",
+    "standardIdentifier",
+    "standard-framework",
+    "standardFramework",
+    "target-id",
+    "targetIdentifier",
+]);
+export function parseTimingMetadata(root, sourcePath) {
+    const timeLimits = packageDescendants(root, "qti-time-limits")[0];
+    const timeDependent = parseXmlBoolean(root.attributes["time-dependent"]);
+    if (!timeLimits && timeDependent === undefined)
+        return undefined;
+    return {
+        sourcePath,
+        timeDependent,
+        minTime: timeLimits?.attributes["min-time"],
+        maxTime: timeLimits?.attributes["max-time"],
+        allowLateSubmission: parseXmlBoolean(timeLimits?.attributes["allow-late-submission"]),
+        attributes: timeLimits ? { ...timeLimits.attributes } : {},
+    };
+}
+export function parseStandardAlignments(root, sourcePath) {
+    const alignments = [];
+    for (const node of packageDescendants(root)) {
+        if (!isStandardAlignmentNode(node))
+            continue;
+        const text = node.text.trim();
+        alignments.push({
+            sourcePath,
+            qtiName: node.localName,
+            identifier: firstAttribute(node, [
+                "identifier",
+                "id",
+                "standard-id",
+                "standardIdentifier",
+                "target-id",
+                "targetIdentifier",
+            ]),
+            framework: firstAttribute(node, [
+                "framework",
+                "standard-framework",
+                "standardFramework",
+                "educational-framework",
+                "educationalFramework",
+            ]),
+            targetName: firstAttribute(node, ["target-name", "targetName", "name"]) ??
+                (text.length > 0 ? text : undefined),
+            targetUrl: firstAttribute(node, ["href", "url", "uri", "target-url", "targetUrl"]),
+            text: text.length > 0 ? text : undefined,
+            attributes: { ...node.attributes },
+        });
+    }
+    return alignments;
+}
+function isStandardAlignmentNode(node) {
+    if (STANDARD_ALIGNMENT_ELEMENT_NAMES.has(node.localName))
+        return true;
+    return Object.keys(node.attributes).some((name) => STANDARD_ALIGNMENT_ATTRIBUTE_NAMES.has(name));
+}
+function firstAttribute(node, names) {
+    for (const name of names) {
+        const value = node.attributes[name];
+        if (value && value.trim().length > 0)
+            return value.trim();
+    }
+    return undefined;
+}
+export function uniqueStandards(standards) {
+    const seen = new Set();
+    const unique = [];
+    for (const standard of standards) {
+        const key = [
+            standard.sourcePath,
+            standard.qtiName,
+            standard.identifier ?? "",
+            standard.framework ?? "",
+            standard.targetName ?? "",
+            standard.targetUrl ?? "",
+            standard.text ?? "",
+        ].join("\u0000");
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        unique.push(standard);
+    }
+    return unique;
+}
+export function primaryTiming(assessmentTest, items) {
+    if (assessmentTest?.timing)
+        return assessmentTest.timing;
+    const timedItems = items.filter((item) => item.timing !== undefined);
+    return timedItems.length === 1 ? timedItems[0]?.timing : undefined;
+}
+export function packageTitle(manifestRoot, assessmentTest, items) {
+    const manifestTitle = manifestRoot
+        ? packageDescendants(manifestRoot, "title")
+            .map((node) => node.text.trim())
+            .find((text) => text.length > 0)
+        : undefined;
+    return (assessmentTest?.title ??
+        manifestTitle ??
+        items.find((item) => item.title !== undefined)?.title ??
+        manifestRoot?.attributes.identifier ??
+        "");
+}
+//# sourceMappingURL=qti-package-metadata.js.map

package/dist/qti-package-metadata.js.map

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

package/dist/qti-package-paths.d.ts

@@ -0,0 +1,6 @@
+import type { QtiDiagnostic } from "./types.js";
+/** Add a package parser diagnostic to an existing diagnostics list. */
+export declare function pushPackageDiagnostic(diagnostics: QtiDiagnostic[], code: string, severity: QtiDiagnostic["severity"], message: string, path?: string): void;
+/** Normalize a package-relative path and diagnose absolute or escaping paths. */
+export declare function normalizePackagePath(path: string, context: string, diagnostics: QtiDiagnostic[]): string | undefined;
+//# sourceMappingURL=qti-package-paths.d.ts.map

package/dist/qti-package-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qti-package-paths.d.ts","sourceRoot":"","sources":["../src/qti-package-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,uEAAuE;AACvE,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,aAAa,EAAE,EAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,EACnC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI,CAON;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,aAAa,EAAE,GAC3B,MAAM,GAAG,SAAS,CAgCpB"}

package/dist/qti-package-paths.js

@@ -0,0 +1,32 @@
+/** Add a package parser diagnostic to an existing diagnostics list. */
+export function pushPackageDiagnostic(diagnostics, code, severity, message, path) {
+    diagnostics.push({
+        code,
+        severity,
+        message,
+        path,
+    });
+}
+/** Normalize a package-relative path and diagnose absolute or escaping paths. */
+export function normalizePackagePath(path, context, diagnostics) {
+    if (path.startsWith("/") || /^[A-Za-z]:[\\/]/.test(path) || /^[a-z][a-z0-9+.-]*:/i.test(path)) {
+        pushPackageDiagnostic(diagnostics, "package.path.absolute", "error", `${context} ${path} must be a package-relative path.`, path);
+        return undefined;
+    }
+    const parts = [];
+    for (const part of path.split("/")) {
+        if (!part || part === ".")
+            continue;
+        if (part === "..") {
+            if (parts.length === 0) {
+                pushPackageDiagnostic(diagnostics, "package.path.escape", "error", `${context} ${path} escapes the package root.`, path);
+                return undefined;
+            }
+            parts.pop();
+            continue;
+        }
+        parts.push(part);
+    }
+    return parts.join("/");
+}
+//# sourceMappingURL=qti-package-paths.js.map

package/dist/qti-package-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qti-package-paths.js","sourceRoot":"","sources":["../src/qti-package-paths.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,MAAM,UAAU,qBAAqB,CACnC,WAA4B,EAC5B,IAAY,EACZ,QAAmC,EACnC,OAAe,EACf,IAAa;IAEb,WAAW,CAAC,IAAI,CAAC;QACf,IAAI;QACJ,QAAQ;QACR,OAAO;QACP,IAAI;KACL,CAAC,CAAC;AACL,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,OAAe,EACf,WAA4B;IAE5B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9F,qBAAqB,CACnB,WAAW,EACX,uBAAuB,EACvB,OAAO,EACP,GAAG,OAAO,IAAI,IAAI,mCAAmC,EACrD,IAAI,CACL,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG;YAAE,SAAS;QACpC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,qBAAqB,CACnB,WAAW,EACX,qBAAqB,EACrB,OAAO,EACP,GAAG,OAAO,IAAI,IAAI,4BAA4B,EAC9C,IAAI,CACL,CAAC;gBACF,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,KAAK,CAAC,GAAG,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/qti-package-types.d.ts

@@ -0,0 +1,98 @@
+import type { QtiDiagnostic, QtiDocument } from "./types.js";
+export type { QtiPackageInflateContext, QtiPackageInflateRaw, QtiPackageParseOptions, } from "./qti-package-zip.js";
+/** Neutral package shape detected from IMS manifest resources. */
+export type QtiPackageShape = "manifest-item-resources" | "assessment-test-resource" | "unknown";
+/** Origin of an assessment item inside a parsed QTI package. */
+export type QtiPackageItemSource = "manifest" | "assessment-test";
+/** Source of a package-local asset reference. */
+export type QtiPackageAssetSource = "manifest-resource" | "item-content" | "assessment-test-content";
+/** Parsed package manifest file entry. */
+export interface QtiManifestFile {
+    readonly href: string;
+    readonly attributes: Record<string, string>;
+}
+/** Parsed package manifest resource entry. */
+export interface QtiManifestResource {
+    readonly identifier: string;
+    readonly type: string;
+    readonly href?: string | undefined;
+    readonly files: readonly QtiManifestFile[];
+    readonly dependencies: readonly string[];
+    readonly attributes: Record<string, string>;
+}
+/** Parsed timing metadata from item or assessment-test XML. */
+export interface QtiTimingMetadata {
+    readonly sourcePath: string;
+    readonly timeDependent?: boolean | undefined;
+    readonly minTime?: string | undefined;
+    readonly maxTime?: string | undefined;
+    readonly allowLateSubmission?: boolean | undefined;
+    readonly attributes: Record<string, string>;
+}
+/** Neutral standard-alignment metadata discovered in package XML. */
+export interface QtiStandardAlignment {
+    readonly sourcePath: string;
+    readonly qtiName: string;
+    readonly identifier?: string | undefined;
+    readonly framework?: string | undefined;
+    readonly targetName?: string | undefined;
+    readonly targetUrl?: string | undefined;
+    readonly text?: string | undefined;
+    readonly attributes: Record<string, string>;
+}
+/** Assessment item reference from an assessment-test package. */
+export interface QtiAssessmentTestItemRef {
+    readonly identifier?: string | undefined;
+    readonly href: string;
+    readonly attributes: Record<string, string>;
+}
+/** Parsed assessment-test resource model for package-level importers. */
+export interface QtiAssessmentTestPackageModel {
+    readonly href: string;
+    readonly identifier: string;
+    readonly title?: string | undefined;
+    readonly manifestResourceIdentifier?: string | undefined;
+    readonly itemRefs: readonly QtiAssessmentTestItemRef[];
+    readonly timing?: QtiTimingMetadata | undefined;
+    readonly standards: readonly QtiStandardAlignment[];
+    readonly assetHrefs: readonly string[];
+    readonly diagnostics: readonly QtiDiagnostic[];
+    readonly attributes: Record<string, string>;
+    readonly xml: string;
+}
+/** Parsed assessment item model inside a QTI package. */
+export interface QtiPackageItem {
+    readonly href: string;
+    readonly source: QtiPackageItemSource;
+    readonly manifestResourceIdentifier?: string | undefined;
+    readonly assessmentItemRefIdentifier?: string | undefined;
+    readonly identifier?: string | undefined;
+    readonly title?: string | undefined;
+    readonly document?: QtiDocument | undefined;
+    readonly timing?: QtiTimingMetadata | undefined;
+    readonly standards: readonly QtiStandardAlignment[];
+    readonly assetHrefs: readonly string[];
+    readonly diagnostics: readonly QtiDiagnostic[];
+    readonly xml: string;
+}
+/** Package-local asset discovered from manifest files or XML content references. */
+export interface QtiPackageAsset {
+    readonly href: string;
+    readonly mediaType?: string | undefined;
+    readonly source: QtiPackageAssetSource;
+    readonly referencedBy: readonly string[];
+}
+/** Parsed QTI package manifest/resource graph and item/test projection. */
+export interface QtiPackageParseResult {
+    readonly ok: boolean;
+    readonly title: string;
+    readonly packageShape: QtiPackageShape;
+    readonly items: readonly QtiPackageItem[];
+    readonly assets: readonly QtiPackageAsset[];
+    readonly manifestResources: readonly QtiManifestResource[];
+    readonly assessmentTest?: QtiAssessmentTestPackageModel | undefined;
+    readonly timing?: QtiTimingMetadata | undefined;
+    readonly standards: readonly QtiStandardAlignment[];
+    readonly diagnostics: readonly QtiDiagnostic[];
+}
+//# sourceMappingURL=qti-package-types.d.ts.map

package/dist/qti-package-types.d.ts.map

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

package/dist/qti-package-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=qti-package-types.js.map

package/dist/qti-package-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qti-package-types.js","sourceRoot":"","sources":["../src/qti-package-types.ts"],"names":[],"mappings":""}

package/dist/qti-package-xml.d.ts

@@ -0,0 +1,21 @@
+import { type QtiPackageXmlNode } from "./package-xml.js";
+import { type QtiPackageEntry } from "./qti-package-zip.js";
+import type { QtiDiagnostic } from "./types.js";
+/** Parsed package XML file with lightweight tree and source text. */
+export interface PackageXmlFile {
+    readonly path: string;
+    readonly xml: string;
+    readonly root?: QtiPackageXmlNode | undefined;
+    readonly errors: readonly string[];
+}
+export declare function parseXmlFiles(entriesByPath: ReadonlyMap<string, QtiPackageEntry>): Map<string, PackageXmlFile>;
+export declare function parsePackageXml(entry: QtiPackageEntry): PackageXmlFile;
+export declare function pushXmlDiagnostics(xmlFile: PackageXmlFile, diagnostics: QtiDiagnostic[]): void;
+export declare function childPackageElements(node: QtiPackageXmlNode, localName?: string): QtiPackageXmlNode[];
+export declare function packageDescendants(node: QtiPackageXmlNode | undefined, localName?: string): QtiPackageXmlNode[];
+export declare function resolvePackageHref(from: string, href: string, diagnostics: QtiDiagnostic[]): string | undefined;
+export declare function stripHrefSuffix(href: string): string;
+export declare function isPackageRelativeHref(href: string | undefined): href is string;
+export declare function joinPackagePath(packagePath: string, localPath: string): string;
+export declare function scopeDiagnosticToPackagePath(packagePath: string, diagnostic: QtiDiagnostic): QtiDiagnostic;
+//# sourceMappingURL=qti-package-xml.d.ts.map

package/dist/qti-package-xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qti-package-xml.d.ts","sourceRoot":"","sources":["../src/qti-package-xml.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAElF,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,wBAAgB,aAAa,CAC3B,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAClD,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAO7B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,CAStE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,IAAI,CAI9F;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,iBAAiB,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,iBAAiB,EAAE,CAErB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,iBAAiB,GAAG,SAAS,EACnC,SAAS,CAAC,EAAE,MAAM,GACjB,iBAAiB,EAAE,CAQrB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,aAAa,EAAE,GAC3B,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,IAAI,MAAM,CAI9E;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,aAAa,GACxB,aAAa,CAQf"}

package/dist/qti-package-xml.js

@@ -0,0 +1,68 @@
+import { parseQtiPackageXmlTree } from "./package-xml.js";
+import { normalizePackagePath, pushPackageDiagnostic } from "./qti-package-paths.js";
+import { decodeUtf8 } from "./qti-package-zip.js";
+export function parseXmlFiles(entriesByPath) {
+    const xmlFiles = new Map();
+    for (const entry of entriesByPath.values()) {
+        if (!entry.path.toLowerCase().endsWith(".xml"))
+            continue;
+        xmlFiles.set(entry.path, parsePackageXml(entry));
+    }
+    return xmlFiles;
+}
+export function parsePackageXml(entry) {
+    const xml = decodeUtf8(entry.bytes);
+    const parsed = parseQtiPackageXmlTree(xml);
+    return {
+        path: entry.path,
+        xml,
+        root: parsed.root,
+        errors: parsed.errors,
+    };
+}
+export function pushXmlDiagnostics(xmlFile, diagnostics) {
+    for (const message of xmlFile.errors) {
+        pushPackageDiagnostic(diagnostics, "xml.parse", "error", message, xmlFile.path);
+    }
+}
+export function childPackageElements(node, localName) {
+    return node.children.filter((child) => !localName || child.localName === localName);
+}
+export function packageDescendants(node, localName) {
+    if (!node)
+        return [];
+    const found = [];
+    for (const child of node.children) {
+        if (!localName || child.localName === localName)
+            found.push(child);
+        found.push(...packageDescendants(child, localName));
+    }
+    return found;
+}
+export function resolvePackageHref(from, href, diagnostics) {
+    const strippedHref = stripHrefSuffix(href);
+    const base = from.includes("/") ? from.slice(0, from.lastIndexOf("/") + 1) : "";
+    return normalizePackagePath(`${base}${strippedHref}`, "package reference", diagnostics);
+}
+export function stripHrefSuffix(href) {
+    return href.split(/[?#]/, 1)[0] ?? "";
+}
+export function isPackageRelativeHref(href) {
+    const trimmed = href?.trim() ?? "";
+    if (!trimmed || trimmed.startsWith("#") || trimmed.startsWith("//"))
+        return false;
+    return !/^[a-z][a-z0-9+.-]*:/i.test(trimmed);
+}
+export function joinPackagePath(packagePath, localPath) {
+    return localPath.startsWith("/") ? `${packagePath}${localPath}` : `${packagePath}/${localPath}`;
+}
+export function scopeDiagnosticToPackagePath(packagePath, diagnostic) {
+    const localPath = diagnostic.path ?? diagnostic.source?.path;
+    const path = localPath ? joinPackagePath(packagePath, localPath) : packagePath;
+    return {
+        ...diagnostic,
+        path,
+        source: diagnostic.source ? { ...diagnostic.source, path } : diagnostic.source,
+    };
+}
+//# sourceMappingURL=qti-package-xml.js.map

package/dist/qti-package-xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qti-package-xml.js","sourceRoot":"","sources":["../src/qti-package-xml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAA0B,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,UAAU,EAAwB,MAAM,sBAAsB,CAAC;AAWxE,MAAM,UAAU,aAAa,CAC3B,aAAmD;IAEnD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IACnD,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,SAAS;QACzD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG;QACH,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAuB,EAAE,WAA4B;IACtF,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACrC,qBAAqB,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAuB,EACvB,SAAkB;IAElB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAmC,EACnC,SAAkB;IAElB,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,IAAY,EACZ,WAA4B;IAE5B,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,OAAO,oBAAoB,CAAC,GAAG,IAAI,GAAG,YAAY,EAAE,EAAE,mBAAmB,EAAE,WAAW,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAwB;IAC5D,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAClF,OAAO,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,SAAiB;IACpE,OAAO,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,SAAS,EAAE,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,WAAmB,EACnB,UAAyB;IAEzB,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC;IAC7D,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IAC/E,OAAO;QACL,GAAG,UAAU;QACb,IAAI;QACJ,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM;KAC/E,CAAC;AACJ,CAAC"}

package/dist/qti-package-zip.d.ts

@@ -0,0 +1,24 @@
+import type { QtiDiagnostic } from "./types.js";
+/** Context passed to a caller-owned raw DEFLATE inflater. */
+export interface QtiPackageInflateContext {
+    readonly path: string;
+    readonly compressedSize: number;
+    readonly uncompressedSize: number;
+    readonly compressionMethod: number;
+}
+/** Optional raw DEFLATE inflater for ZIP entries compressed with method 8. */
+export type QtiPackageInflateRaw = (bytes: Uint8Array, context: QtiPackageInflateContext) => Uint8Array;
+/** Options for parsing a QTI ZIP package. */
+export interface QtiPackageParseOptions {
+    readonly inflateRaw?: QtiPackageInflateRaw | undefined;
+}
+/** Decoded ZIP entry from a QTI package. */
+export interface QtiPackageEntry {
+    readonly path: string;
+    readonly bytes: Uint8Array;
+}
+/** Read stored ZIP entries and optionally inflate raw DEFLATE entries through caller code. */
+export declare function readQtiPackageZipEntries(bytes: Uint8Array, options: QtiPackageParseOptions, diagnostics: QtiDiagnostic[]): QtiPackageEntry[];
+/** Decode UTF-8 package entry names and XML payloads. */
+export declare function decodeUtf8(bytes: Uint8Array): string;
+//# sourceMappingURL=qti-package-zip.d.ts.map

package/dist/qti-package-zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qti-package-zip.d.ts","sourceRoot":"","sources":["../src/qti-package-zip.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,8EAA8E;AAC9E,MAAM,MAAM,oBAAoB,GAAG,CACjC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,wBAAwB,KAC9B,UAAU,CAAC;AAEhB,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACxD;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,8FAA8F;AAC9F,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,sBAAsB,EAC/B,WAAW,EAAE,aAAa,EAAE,GAC3B,eAAe,EAAE,CAYnB;AAKD,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAoBpD"}