@longsightgroup/qti3-core 0.10.4 → 0.10.5

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

@@ -0,0 +1,38 @@
+import { type QtiPackageSummary } from "./qti-package-plan.js";
+import type { QtiPackageItem } from "./qti-package-types.js";
+/** An immutable entry inventory and host-owned, bounded reads of decoded entry bytes. */
+export interface QtiPackageSource {
+    readonly entries: readonly {
+        readonly path: string;
+        readonly size: number;
+    }[];
+    /** Enforce maxBytes during extraction, before allocating an oversized body. */
+    readonly readEntry: (path: string, maxBytes: number) => Promise<Uint8Array>;
+}
+/** Explicit resource budgets for an incremental package read. */
+export interface QtiPackageStreamLimits {
+    readonly maxEntries: number;
+    readonly maxEntryBytes: number;
+    readonly maxTotalBytes: number;
+    readonly maxDiagnostics: number;
+}
+/** Package metadata without extracted bodies or retained item models. */
+export type QtiPackageStreamSummary = QtiPackageSummary;
+/** Items are provisional until the terminal summary reports ok; hosts must stage them. */
+export type QtiPackageStreamEvent = {
+    readonly kind: "item";
+    readonly index: number;
+    readonly item: QtiPackageItem;
+} | {
+    readonly kind: "summary";
+    readonly summary: QtiPackageStreamSummary;
+};
+/**
+ * Parse immutable package entries sequentially with canonical package semantics.
+ *
+ * The caller owns ZIP/object storage and must not collect item events when bounded
+ * memory is required. Assets are described in the terminal summary, never loaded.
+ * Breaking iteration stops subsequent reads. Read failures become safe diagnostics.
+ */
+export declare function parseQtiPackageStream(source: QtiPackageSource, limits: QtiPackageStreamLimits): AsyncGenerator<QtiPackageStreamEvent>;
+//# sourceMappingURL=qti-package-stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qti-package-stream.d.ts","sourceRoot":"","sources":["../src/qti-package-stream.ts"],"names":[],"mappings":"AAMA,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAK7D,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9E,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7E;AAED,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,yEAAyE;AACzE,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAExD,0FAA0F;AAC1F,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAA;CAAE,CAAC;AAE5E;;;;;;GAMG;AACH,wBAAuB,qBAAqB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,sBAAsB,GAC7B,cAAc,CAAC,qBAAqB,CAAC,CA6FvC"}

package/dist/qti-package-stream.js

@@ -0,0 +1,149 @@
+import { itemReferencesForPackageShape, parseAssessmentTestPackageModel, parsePackageItem, } from "./qti-package-items.js";
+import { QTI_PACKAGE_MANIFEST_PATH } from "./qti-package-manifest.js";
+import { buildPackageSummary, enforceDiagnosticLimit, failedPackageSummary, inspectPackageManifest, } from "./qti-package-plan.js";
+import { normalizePackagePath, pushPackageDiagnostic } from "./qti-package-paths.js";
+import { parsePackageXml } from "./qti-package-xml.js";
+/**
+ * Parse immutable package entries sequentially with canonical package semantics.
+ *
+ * The caller owns ZIP/object storage and must not collect item events when bounded
+ * memory is required. Assets are described in the terminal summary, never loaded.
+ * Breaking iteration stops subsequent reads. Read failures become safe diagnostics.
+ */
+export async function* parseQtiPackageStream(source, limits) {
+    const diagnostics = [];
+    const inventory = inspectInventory(source, limits, diagnostics);
+    if (!inventory) {
+        yield { kind: "summary", summary: failedPackageSummary(diagnostics) };
+        return;
+    }
+    const read = createEntryReader(source, inventory, limits, diagnostics);
+    const manifestEntry = await read(QTI_PACKAGE_MANIFEST_PATH);
+    const manifest = inspectPackageManifest(inventory, manifestEntry ? parsePackageXml(manifestEntry) : undefined, diagnostics);
+    // Only the primary assessment test supplies the package structure. The shared
+    // parser diagnoses additional test resources without loading their bodies.
+    const testEntries = new Map();
+    const testHref = manifest.assessmentTestResources[0]?.href;
+    if (testHref !== undefined) {
+        const entry = await read(testHref);
+        if (entry)
+            testEntries.set(testHref, entry);
+    }
+    const assessmentTest = parseAssessmentTestPackageModel(manifest.packageShape, manifest.assessmentTestResources, testEntries, new Map(), diagnostics);
+    const references = itemReferencesForPackageShape(manifest.packageShape, manifest.itemResources, assessmentTest, diagnostics);
+    const assetItems = [];
+    const itemStandards = [];
+    const titleItems = [];
+    const seen = new Set();
+    let itemCount = 0;
+    let timedItemCount = 0;
+    let soleItemTiming;
+    for (const reference of references) {
+        if (diagnostics.length >= limits.maxDiagnostics)
+            break;
+        if (seen.has(reference.href)) {
+            pushPackageDiagnostic(diagnostics, "package.item.reference.duplicate", "warning", `Package item ${reference.href} is referenced more than once.`, reference.href);
+            continue;
+        }
+        seen.add(reference.href);
+        const entry = await read(reference.href);
+        if (!entry)
+            continue;
+        const item = parsePackageItem(reference, entry, undefined, diagnostics);
+        if (item.title !== undefined && titleItems.length === 0) {
+            titleItems.push({ title: item.title });
+        }
+        if (item.timing !== undefined) {
+            timedItemCount += 1;
+            soleItemTiming = item.timing;
+        }
+        itemStandards.push(...item.standards);
+        assetItems.push({
+            href: item.href,
+            manifestResourceIdentifier: item.manifestResourceIdentifier,
+            assetHrefs: item.assetHrefs,
+        });
+        yield { kind: "item", index: itemCount++, item };
+    }
+    enforceDiagnosticLimit(diagnostics, limits.maxDiagnostics);
+    yield {
+        kind: "summary",
+        summary: buildPackageSummary({
+            manifestRoot: manifest.manifestRoot,
+            manifestResources: manifest.manifestResources,
+            resourcesByIdentifier: manifest.resourcesByIdentifier,
+            packageShape: manifest.packageShape,
+            assessmentTest,
+            assetItems,
+            titleItems,
+            timedItemCount,
+            soleItemTiming,
+            itemStandards,
+            entriesByPath: inventory,
+            diagnostics,
+            itemCount,
+        }),
+    };
+}
+function createEntryReader(source, inventory, limits, diagnostics) {
+    return async (path) => {
+        const size = inventory.get(path);
+        if (size === undefined)
+            return undefined;
+        try {
+            const bytes = await source.readEntry(path, limits.maxEntryBytes);
+            if (!(bytes instanceof Uint8Array) || bytes.byteLength !== size) {
+                pushPackageDiagnostic(diagnostics, "package.entry.size", "error", "Package entry size does not match its immutable inventory.", path);
+                return undefined;
+            }
+            return { path, bytes };
+        }
+        catch {
+            pushPackageDiagnostic(diagnostics, "package.entry.read", "error", "Package entry could not be read.", path);
+            return undefined;
+        }
+    };
+}
+function inspectInventory(source, limits, diagnostics) {
+    if (!validStreamLimits(limits)) {
+        pushPackageDiagnostic(diagnostics, "package.limits.invalid", "error", "Package limits must be positive safe integers.");
+        return undefined;
+    }
+    if (source.entries.length > limits.maxEntries) {
+        pushPackageDiagnostic(diagnostics, "package.entries.limit", "error", "Package contains more entries than allowed.");
+        return undefined;
+    }
+    const inventory = new Map();
+    let total = 0;
+    for (const entry of source.entries) {
+        const path = normalizePackagePath(entry.path, "entry", diagnostics);
+        if (!path)
+            return undefined;
+        if (path !== entry.path || inventory.has(path)) {
+            pushPackageDiagnostic(diagnostics, "package.entry.duplicate", "error", "Package inventory paths must be unique and canonical.", entry.path);
+            return undefined;
+        }
+        total += entry.size;
+        if (!Number.isSafeInteger(entry.size) ||
+            entry.size < 0 ||
+            entry.size > limits.maxEntryBytes ||
+            !Number.isSafeInteger(total) ||
+            total > limits.maxTotalBytes) {
+            pushPackageDiagnostic(diagnostics, "package.bytes.limit", "error", "Package entry or total size exceeds its configured budget.", path);
+            return undefined;
+        }
+        inventory.set(path, entry.size);
+    }
+    return inventory;
+}
+function validStreamLimits(limits) {
+    return (Number.isSafeInteger(limits.maxEntries) &&
+        limits.maxEntries > 0 &&
+        Number.isSafeInteger(limits.maxEntryBytes) &&
+        limits.maxEntryBytes > 0 &&
+        Number.isSafeInteger(limits.maxTotalBytes) &&
+        limits.maxTotalBytes > 0 &&
+        Number.isSafeInteger(limits.maxDiagnostics) &&
+        limits.maxDiagnostics > 0);
+}
+//# sourceMappingURL=qti-package-stream.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"qti-package.d.ts","sourceRoot":"","sources":["../src/qti-package.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGpE,OAAO,EACL,mCAAmC,EACnC,UAAU,EACV,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,mCAAmC,EAAE,UAAU,EAAE,wBAAwB,EAAE,CAAC;AACrF,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC9F,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,YAAY,EACV,gCAAgC,EAChC,wBAAwB,EACxB,6BAA6B,EAC7B,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,+BAA+B,EAC/B,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,aAAa,EACb,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,0FAA0F;AAC1F,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAIvB"}
+{"version":3,"file":"qti-package.d.ts","sourceRoot":"","sources":["../src/qti-package.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EACL,mCAAmC,EACnC,UAAU,EACV,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,mCAAmC,EAAE,UAAU,EAAE,wBAAwB,EAAE,CAAC;AACrF,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC9F,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,YAAY,EACV,gCAAgC,EAChC,wBAAwB,EACxB,6BAA6B,EAC7B,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,+BAA+B,EAC/B,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,aAAa,EACb,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,0FAA0F;AAC1F,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAIvB"}

package/dist/qti-package.js

@@ -1,10 +1,8 @@
 import { pushPackageDiagnostic } from "./qti-package-paths.js";
-import { collectPackageAssets } from "./qti-package-assets.js";
-import { detectPackageShape, diagnoseManifestDependencyReferences, diagnosePrimaryResourceHrefs, indexManifestResources, isQtiAssessmentTestResource, isQtiItemResource, parseManifestResources, QTI_PACKAGE_MANIFEST_PATH, } from "./qti-package-manifest.js";
+import { QTI_PACKAGE_MANIFEST_PATH } from "./qti-package-manifest.js";
+import { buildPackageSummary, inspectPackageManifest } from "./qti-package-plan.js";
 import { itemReferencesForPackageShape, parseAssessmentTestPackageModel, parsePackageItems, } from "./qti-package-items.js";
-import { packageTitle, parseStandardAlignments, primaryTiming, uniqueStandards, } from "./qti-package-metadata.js";
-import { QTI_PACKAGE_MANIFEST_NAMESPACE } from "./qti-namespaces.js";
-import { parseXmlFiles, pushXmlDiagnostics } from "./qti-package-xml.js";
+import { parseXmlFiles } from "./qti-package-xml.js";
 import { DEFAULT_QTI_PACKAGE_RESOURCE_LIMITS, decodeUtf8, readQtiPackageZipEntries, } from "./qti-package-zip.js";
 export { DEFAULT_QTI_PACKAGE_RESOURCE_LIMITS, decodeUtf8, readQtiPackageZipEntries };
 export { discoverQtiPackageContentAssets } from "./qti-package-assets.js";
@@ -19,58 +17,30 @@ export function parseQtiPackage(bytes, options = {}) {
 function parseQtiPackageEntries(entries, options, diagnostics) {
     const entriesByPath = indexEntries(entries, diagnostics);
     const xmlFilesByPath = parseXmlFiles(entriesByPath);
-    const manifestXml = xmlFilesByPath.get(QTI_PACKAGE_MANIFEST_PATH);
-    if (!manifestXml) {
-        pushPackageDiagnostic(diagnostics, "package.manifest.missing", "error", "QTI package does not contain imsmanifest.xml.", QTI_PACKAGE_MANIFEST_PATH);
-    }
-    else {
-        pushXmlDiagnostics(manifestXml, diagnostics);
-    }
-    const manifestRoot = manifestXml?.root?.localName === "manifest" &&
-        manifestXml.root.uri === QTI_PACKAGE_MANIFEST_NAMESPACE
-        ? manifestXml.root
-        : undefined;
-    if (manifestXml?.root && !manifestRoot) {
-        pushPackageDiagnostic(diagnostics, "package.manifest.root", "error", manifestXml.root.localName === "manifest"
-            ? `Expected imsmanifest.xml manifest in namespace ${QTI_PACKAGE_MANIFEST_NAMESPACE}, found ${manifestXml.root.uri ?? "(none)"}.`
-            : `Expected imsmanifest.xml root manifest, found ${manifestXml.root.localName}.`, QTI_PACKAGE_MANIFEST_PATH);
-    }
-    const manifestResourceRecords = manifestRoot
-        ? parseManifestResources(manifestRoot, entriesByPath, diagnostics)
-        : [];
-    const manifestResources = manifestResourceRecords;
-    const resourcesByIdentifier = indexManifestResources(manifestResourceRecords, diagnostics);
-    diagnoseManifestDependencyReferences(manifestResourceRecords, resourcesByIdentifier, diagnostics);
-    const itemResources = manifestResourceRecords.filter((resource) => isQtiItemResource(resource.type));
-    const assessmentTestResources = manifestResourceRecords.filter((resource) => isQtiAssessmentTestResource(resource.type));
-    diagnosePrimaryResourceHrefs([...itemResources, ...assessmentTestResources], diagnostics);
-    const packageShape = detectPackageShape(itemResources, assessmentTestResources, diagnostics);
+    const { manifestRoot, manifestResources, resourcesByIdentifier, itemResources, assessmentTestResources, packageShape, } = inspectPackageManifest(entriesByPath, xmlFilesByPath.get(QTI_PACKAGE_MANIFEST_PATH), diagnostics);
     const assessmentTest = parseAssessmentTestPackageModel(packageShape, assessmentTestResources, entriesByPath, xmlFilesByPath, diagnostics);
     const itemReferences = itemReferencesForPackageShape(packageShape, itemResources, assessmentTest, diagnostics);
     const items = parsePackageItems(itemReferences, entriesByPath, xmlFilesByPath, diagnostics);
-    const assets = collectPackageAssets(resourcesByIdentifier, assessmentTest, items, entriesByPath, diagnostics);
-    const manifestStandards = manifestRoot
-        ? parseStandardAlignments(manifestRoot, QTI_PACKAGE_MANIFEST_PATH)
-        : [];
-    const standards = uniqueStandards([
-        ...manifestStandards,
-        ...(assessmentTest?.standards ?? []),
-        ...items.flatMap((item) => item.standards),
-    ]);
-    const timing = primaryTiming(assessmentTest, items);
-    const title = packageTitle(manifestRoot, assessmentTest, items);
-    return {
-        ok: diagnostics.every((diagnostic) => diagnostic.severity !== "error"),
-        title,
-        entries,
-        packageShape,
-        items,
-        assets,
+    const timedItems = items.filter((item) => item.timing !== undefined);
+    const { itemCount: _itemCount, ...summary } = buildPackageSummary({
+        manifestRoot,
         manifestResources,
+        resourcesByIdentifier,
+        packageShape,
         assessmentTest,
-        timing,
-        standards,
+        assetItems: items,
+        titleItems: items,
+        timedItemCount: timedItems.length,
+        soleItemTiming: timedItems.length === 1 ? timedItems[0]?.timing : undefined,
+        itemStandards: items.flatMap((item) => item.standards),
+        entriesByPath,
         diagnostics,
+        itemCount: items.length,
+    });
+    return {
+        ...summary,
+        entries,
+        items,
     };
 }
 function indexEntries(entries, diagnostics) {

package/dist/qti-package.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longsightgroup/qti3-core",
-  "version": "0.10.4",
+  "version": "0.10.5",
   "description": "Framework-neutral TypeScript core for parsing, validating, scoring, and serializing QTI 3 assessment items.",
   "keywords": [
     "assessment",

package/src/index.ts

@@ -368,3 +368,11 @@ export {
   readQtiJsonValue,
   unknownToDisplayString,
 } from "./value-format.js";
+
+export {
+  parseQtiPackageStream,
+  type QtiPackageSource,
+  type QtiPackageStreamLimits,
+  type QtiPackageStreamEvent,
+  type QtiPackageStreamSummary,
+} from "./qti-package-stream.js";

package/src/qti-package-assets.ts

@@ -14,7 +14,6 @@ import {
   resolvePackageHref,
   type PackageXmlFile,
 } from "./qti-package-xml.js";
-import type { QtiPackageEntry } from "./qti-package-zip.js";
 import type { QtiDiagnostic } from "./types.js";
 
 interface PendingAssetReference {
@@ -87,8 +86,8 @@ export function discoverContentAssetHrefs(
 export function collectPackageAssets(
   resourcesByIdentifier: ReadonlyMap<string, QtiManifestResource>,
   assessmentTest: QtiAssessmentTestPackageModel | undefined,
-  items: readonly QtiPackageItem[],
-  entriesByPath: ReadonlyMap<string, QtiPackageEntry>,
+  items: readonly Pick<QtiPackageItem, "href" | "manifestResourceIdentifier" | "assetHrefs">[],
+  entriesByPath: { has(path: string): boolean },
   diagnostics: QtiDiagnostic[],
 ): QtiPackageAsset[] {
   const pending: PendingAssetReference[] = [];
@@ -220,7 +219,7 @@ function collectPackageRelativeTextRefs(
 
 function materializeAssets(
   pending: readonly PendingAssetReference[],
-  entriesByPath: ReadonlyMap<string, QtiPackageEntry>,
+  entriesByPath: { has(path: string): boolean },
 ): QtiPackageAsset[] {
   const assetsByHref = new Map<string, PendingAssetReference[]>();
   for (const reference of pending) {

package/src/qti-package-items.ts

@@ -346,6 +346,55 @@ export function itemReferencesForPackageShape(
   return references;
 }
 
+export function parsePackageItem(
+  reference: PackageItemReference,
+  entry: QtiPackageEntry,
+  xmlFile: PackageXmlFile | undefined,
+  diagnostics: QtiDiagnostic[],
+): QtiPackageItem {
+  const resolvedXml = xmlFile ?? parsePackageXml(entry);
+  // Full QTI parse for document model; lightweight tree above supplies metadata and asset refs.
+  const parsed = parseQtiXml(resolvedXml.xml);
+  const itemDiagnostics = parsed.diagnostics.map((diagnostic) =>
+    scopeDiagnosticToPackagePath(reference.href, diagnostic),
+  );
+  diagnostics.push(...itemDiagnostics);
+
+  const assetHrefs = resolvedXml.root ? discoverContentAssetHrefs(resolvedXml, diagnostics) : [];
+  const root =
+    resolvedXml.root?.localName === "qti-assessment-item" &&
+    resolvedXml.root.uri === QTI_ASI_NAMESPACE
+      ? resolvedXml.root
+      : undefined;
+  const item = parsed.document?.item;
+  const timeLimits = root
+    ? parseTimeLimits(qtiChildElements(root, "qti-time-limits")[0], reference.href, diagnostics)
+    : undefined;
+
+  return {
+    href: reference.href,
+    source: reference.source,
+    manifestResourceIdentifier: reference.manifestResourceIdentifier,
+    assessmentItemRefIdentifier: reference.assessmentItemRefIdentifier,
+    identifier: item?.identifier,
+    title: item?.title,
+    document: parsed.document,
+    timing: root ? parseTimingMetadata(root, reference.href, diagnostics, timeLimits) : undefined,
+    timeLimits,
+    standards: uniqueStandards([
+      ...reference.standards.filter(
+        (standard) =>
+          standard.resourcePartIdentifier === undefined ||
+          standard.resourcePartIdentifier === item?.identifier,
+      ),
+      ...(root ? parseStandardAlignments(root, reference.href) : []),
+    ]),
+    assetHrefs,
+    diagnostics: itemDiagnostics,
+    xml: resolvedXml.xml,
+  };
+}
+
 export function parsePackageItems(
   references: readonly PackageItemReference[],
   entriesByPath: ReadonlyMap<string, QtiPackageEntry>,
@@ -380,46 +429,7 @@ export function parsePackageItems(
       continue;
     }
 
-    const xmlFile = xmlFilesByPath.get(reference.href) ?? parsePackageXml(entry);
-    // Full QTI parse for document model; lightweight tree above supplies metadata and asset refs.
-    const parsed = parseQtiXml(xmlFile.xml);
-    const itemDiagnostics = parsed.diagnostics.map((diagnostic) =>
-      scopeDiagnosticToPackagePath(reference.href, diagnostic),
-    );
-    diagnostics.push(...itemDiagnostics);
-
-    const assetHrefs = xmlFile.root ? discoverContentAssetHrefs(xmlFile, diagnostics) : [];
-    const root =
-      xmlFile.root?.localName === "qti-assessment-item" && xmlFile.root.uri === QTI_ASI_NAMESPACE
-        ? xmlFile.root
-        : undefined;
-    const item = parsed.document?.item;
-    const timeLimits = root
-      ? parseTimeLimits(qtiChildElements(root, "qti-time-limits")[0], reference.href, diagnostics)
-      : undefined;
-
-    items.push({
-      href: reference.href,
-      source: reference.source,
-      manifestResourceIdentifier: reference.manifestResourceIdentifier,
-      assessmentItemRefIdentifier: reference.assessmentItemRefIdentifier,
-      identifier: item?.identifier,
-      title: item?.title,
-      document: parsed.document,
-      timing: root ? parseTimingMetadata(root, reference.href, diagnostics, timeLimits) : undefined,
-      timeLimits,
-      standards: uniqueStandards([
-        ...reference.standards.filter(
-          (standard) =>
-            standard.resourcePartIdentifier === undefined ||
-            standard.resourcePartIdentifier === item?.identifier,
-        ),
-        ...(root ? parseStandardAlignments(root, reference.href) : []),
-      ]),
-      assetHrefs,
-      diagnostics: itemDiagnostics,
-      xml: xmlFile.xml,
-    });
+    items.push(parsePackageItem(reference, entry, xmlFilesByPath.get(reference.href), diagnostics));
   }
 
   return items;

package/src/qti-package-manifest.ts

@@ -3,7 +3,6 @@ import { normalizePackagePath, pushPackageDiagnostic } from "./qti-package-paths
 import { parseStandardAlignments } from "./qti-package-metadata.js";
 import type { QtiManifestFile, QtiManifestResource, QtiPackageShape } from "./qti-package-types.js";
 import { childPackageElements, packageDescendants, stripHrefSuffix } from "./qti-package-xml.js";
-import type { QtiPackageEntry } from "./qti-package-zip.js";
 import type { QtiDiagnostic } from "./types.js";
 import { QTI_PACKAGE_MANIFEST_NAMESPACE } from "./qti-namespaces.js";
 
@@ -21,7 +20,7 @@ export function isQtiAssessmentTestResource(type: string): boolean {
 
 export function parseManifestResources(
   manifestRoot: QtiPackageXmlNode,
-  entriesByPath: ReadonlyMap<string, QtiPackageEntry>,
+  entriesByPath: { has(path: string): boolean },
   diagnostics: QtiDiagnostic[],
 ): QtiManifestResource[] {
   const resourceNodes = packageDescendants(
@@ -72,7 +71,7 @@ export function parseManifestResources(
 
 function parseManifestFiles(
   resourceNode: QtiPackageXmlNode,
-  entriesByPath: ReadonlyMap<string, QtiPackageEntry>,
+  entriesByPath: { has(path: string): boolean },
   diagnostics: QtiDiagnostic[],
 ): QtiManifestFile[] {
   const files: QtiManifestFile[] = [];

package/src/qti-package-metadata.ts

@@ -282,19 +282,31 @@ function optionalFiniteNumber(raw: string | undefined): number | undefined {
   return Number.isFinite(value) ? value : undefined;
 }
 
-export function primaryTiming(
+export function primaryTimingFromScan(
   assessmentTest: QtiAssessmentTestPackageModel | undefined,
-  items: readonly QtiPackageItem[],
+  timedItemCount: number,
+  soleItemTiming: QtiTimingMetadata | undefined,
 ): QtiTimingMetadata | undefined {
   if (assessmentTest?.timing) return assessmentTest.timing;
+  return timedItemCount === 1 ? soleItemTiming : undefined;
+}
+
+export function primaryTiming(
+  assessmentTest: QtiAssessmentTestPackageModel | undefined,
+  items: readonly Pick<QtiPackageItem, "timing">[],
+): QtiTimingMetadata | undefined {
   const timedItems = items.filter((item) => item.timing !== undefined);
-  return timedItems.length === 1 ? timedItems[0]?.timing : undefined;
+  return primaryTimingFromScan(
+    assessmentTest,
+    timedItems.length,
+    timedItems.length === 1 ? timedItems[0]?.timing : undefined,
+  );
 }
 
 export function packageTitle(
   manifestRoot: QtiPackageXmlNode | undefined,
   assessmentTest: QtiAssessmentTestPackageModel | undefined,
-  items: readonly QtiPackageItem[],
+  items: readonly Pick<QtiPackageItem, "title">[],
 ): string {
   const manifestTitle = manifestRoot
     ? packageDescendants(manifestRoot, "title", QTI_PACKAGE_MANIFEST_NAMESPACE)