@conform-ed/contracts 0.0.14 → 0.0.16

package/.turbo/turbo-format.log

@@ -2,4 +2,4 @@ $ oxfmt --config ../../.oxfmtrc.jsonc --check .
 Checking formatting...
 
 All matched files use the correct format.
-Finished in 614ms on 188 files using 8 threads.
+Finished in 626ms on 189 files using 8 threads.

package/.turbo/turbo-lint.log

@@ -1,3 +1,3 @@
 $ oxlint --config ../../.oxlintrc.jsonc .
 Found 0 warnings and 0 errors.
-Finished in 1.3s on 169 files with 123 rules using 8 threads.
+Finished in 1.3s on 170 files with 123 rules using 8 threads.

package/.turbo/turbo-test.log

@@ -2,227 +2,232 @@ $ bun test
 bun test v1.3.14 (0d9b296a)
 
 test/xapi.test.ts:
-(pass) xAPI 1.0.3 statement schema accepts the core data model [21.30ms]
-(pass) xAPI 2.0 statement schema accepts the same core data model [3.60ms]
-(pass) xAPI 2.0 statement schema accepts IEEE 2.0 contextAgent/contextGroup objects [8.00ms]
-(pass) xAPI statement submission schema accepts batches [0.45ms]
-(pass) xAPI document, listing, and about schemas validate LRS metadata [14.35ms]
-(pass) xAPI validation rejects statements missing required fields [0.69ms]
-(pass) xAPI statement result, person object, and resource queries validate missing spec objects [4.06ms]
-(pass) xAPI Agent schema enforces exactly one Inverse Functional Identifier [0.65ms]
-(pass) xAPI HTTP method enum validates LRS operations [0.18ms]
-(pass) xAPI error response schema validates LRS error payloads [0.93ms]
-(pass) xAPI error codes validate standard HTTP status responses [0.43ms]
-(pass) xAPI concurrency schema validates ETags and conditional headers [0.72ms]
-(pass) xAPI multipart attachment part schema validates attachment data structure [0.26ms]
-(pass) xAPI multipart request schema validates statement with attachments [3.02ms]
-(pass) xAPI resource schema models LRS endpoint definitions [0.69ms]
-(pass) xAPI request and response headers are properly enumerated [0.30ms]
+(pass) xAPI 1.0.3 statement schema accepts the core data model [12.48ms]
+(pass) xAPI 2.0 statement schema accepts the same core data model [2.06ms]
+(pass) xAPI 2.0 statement schema accepts IEEE 2.0 contextAgent/contextGroup objects [7.76ms]
+(pass) xAPI statement submission schema accepts batches [0.41ms]
+(pass) xAPI document, listing, and about schemas validate LRS metadata [3.01ms]
+(pass) xAPI validation rejects statements missing required fields [0.41ms]
+(pass) xAPI statement result, person object, and resource queries validate missing spec objects [2.07ms]
+(pass) xAPI Agent schema enforces exactly one Inverse Functional Identifier [0.45ms]
+(pass) xAPI HTTP method enum validates LRS operations [0.13ms]
+(pass) xAPI error response schema validates LRS error payloads [0.49ms]
+(pass) xAPI error codes validate standard HTTP status responses [0.11ms]
+(pass) xAPI concurrency schema validates ETags and conditional headers [0.40ms]
+(pass) xAPI multipart attachment part schema validates attachment data structure [0.17ms]
+(pass) xAPI multipart request schema validates statement with attachments [0.96ms]
+(pass) xAPI resource schema models LRS endpoint definitions [0.55ms]
+(pass) xAPI request and response headers are properly enumerated [0.16ms]
 
 test/cmi5-v1_0.test.ts:
-(pass) cmi5 course structure schema parses the simple XML example [7.24ms]
-(pass) cmi5 keyword extension schema parses the extended XML example [4.96ms]
-(pass) cmi5 recursive course structure schema accepts nested blocks and AUs [1.30ms]
+(pass) cmi5 course structure schema parses the simple XML example [12.71ms]
+(pass) cmi5 keyword extension schema parses the extended XML example [3.36ms]
+(pass) cmi5 recursive course structure schema accepts nested blocks and AUs [0.86ms]
 
 test/oneroster-v1_2.test.ts:
-(pass) UserSchema parses a minimal OneRoster user [4.29ms]
-(pass) LineItemSchema parses a minimal gradebook line item [2.44ms]
-(pass) ResourceSchema parses a minimal resource entry [1.37ms]
-(pass) ImsxStatusInfoSchema parses a OneRoster status envelope [1.08ms]
-(pass) EnrollmentRoleSchema accepts extension values and rejects unknown built-ins [0.23ms]
-(pass) ClassSchema requires at least one term reference [1.56ms]
+(pass) UserSchema parses a minimal OneRoster user [2.98ms]
+(pass) LineItemSchema parses a minimal gradebook line item [1.23ms]
+(pass) ResourceSchema parses a minimal resource entry [0.73ms]
+(pass) ImsxStatusInfoSchema parses a OneRoster status envelope [0.88ms]
+(pass) EnrollmentRoleSchema accepts extension values and rejects unknown built-ins [0.19ms]
+(pass) ClassSchema requires at least one term reference [1.28ms]
 (pass) OneRoster12DerivedZodTemplates exposes core published entry points [0.06ms]
 (pass) OneRoster REST binding operation catalogs expose all endpoint schemas [0.06ms]
 (pass) Gradebook operation bindings expose request/response payload schemas [0.04ms]
-(pass) ManifestCsvRowSchema accepts either starred or unstarred optional file keys [1.71ms]
-(pass) UsersCsvRowSchema validates required OneRoster 1.2 user CSV columns [1.09ms]
-(pass) OneRosterCsvBindingPackageSchema validates package-level CSV document sets [1.76ms]
+(pass) ManifestCsvRowSchema accepts either starred or unstarred optional file keys [1.66ms]
+(pass) UsersCsvRowSchema validates required OneRoster 1.2 user CSV columns [1.05ms]
+(pass) OneRosterCsvBindingPackageSchema validates package-level CSV document sets [1.50ms]
 
 test/qti-v2_1.test.ts:
-(pass) QtiV2_1 metadata document parses a minimal metadata payload [0.85ms]
-(pass) QtiV2_1 assessment item document parses a minimal choice item [14.43ms]
-(pass) QtiV2_1 result document rejects record responses without field identifiers [1.75ms]
-(pass) QtiV2_1 manifest document parses a minimal package [2.87ms]
-(pass) QtiV2_1 APIP accessibility document parses a minimal payload [1.87ms]
+(pass) QtiV2_1 metadata document parses a minimal metadata payload [0.76ms]
+(pass) QtiV2_1 assessment item document parses a minimal choice item [10.66ms]
+(pass) QtiV2_1 result document rejects record responses without field identifiers [2.08ms]
+(pass) QtiV2_1 manifest document parses a minimal package [1.38ms]
+(pass) QtiV2_1 APIP accessibility document parses a minimal payload [1.47ms]
 
 test/qti-v3_0_1.test.ts:
-(pass) QtiMetadataDocumentSchema parses a minimal metadata document [1.50ms]
-(pass) QtiAccessForAllPnpDocumentSchema parses a minimal preferences document [5.64ms]
-(pass) QtiAssessmentResultDocumentSchema parses a minimal result report [3.17ms]
-(pass) QtiAssessmentResultDocumentSchema rejects record response values without field identifiers [0.27ms]
-(pass) QtiAssessmentResultDocumentSchema rejects record outcomes with baseType [0.92ms]
-(pass) QtiUsageDataDocumentSchema parses ordinary and categorized statistics [4.88ms]
-(pass) QtiUsageDataDocumentSchema rejects invalid objectType and mapping bounds [0.83ms]
-(pass) QtiResponseProcessingDocumentSchema parses typed processing operators [15.79ms]
-(pass) QtiOutcomeProcessingDocumentSchema parses typed aggregate operators [22.86ms]
-(pass) QtiResponseProcessingDocumentSchema rejects invalid operator parameters [5.40ms]
-(pass) QtiOutcomeProcessingDocumentSchema rejects invalid operator arity and ranges [2.87ms]
-(pass) QtiAssessmentSectionDocumentSchema parses a minimal standalone section [3.35ms]
-(pass) QtiAssessmentStimulusDocumentSchema parses a minimal stimulus [2.25ms]
-(pass) QtiOutcomeDeclarationDocumentSchema parses a minimal outcome declaration [1.09ms]
-(pass) QtiAsiProfileDocumentSchema accepts resource-specific QTI documents [1.71ms]
-(pass) QtiAssessmentItemDocumentSchema parses a minimal choice item [52.00ms]
-(pass) QtiAssessmentItemDocumentSchema rejects incompatible response declarations [4.98ms]
-(pass) QtiAssessmentTestDocumentSchema parses a minimal test document [5.04ms]
-(pass) Qti301DerivedZodTemplates exposes expected document templates [0.11ms]
-(pass) QTI barrel exports prefixed XML extension node helpers [0.77ms]
-(pass) built-in outcome completionStatus needs no declaration in processing rules [0.48ms]
-(pass) an integer SCORE is accepted — the official corpus ships it [0.22ms]
-(pass) a non-numeric or multiple SCORE is still rejected [0.43ms]
-(pass) snake_case completion_status is accepted as the built-in's corpus alias [0.58ms]
-(pass) maxChoices 0 means unbounded and never conflicts with minChoices [0.79ms]
+(pass) QtiMetadataDocumentSchema parses a minimal metadata document [2.27ms]
+(pass) QtiAccessForAllPnpDocumentSchema parses a minimal preferences document [2.56ms]
+(pass) QtiAssessmentResultDocumentSchema parses a minimal result report [2.56ms]
+(pass) QtiAssessmentResultDocumentSchema rejects record response values without field identifiers [0.23ms]
+(pass) QtiAssessmentResultDocumentSchema rejects record outcomes with baseType [0.56ms]
+(pass) QtiUsageDataDocumentSchema parses ordinary and categorized statistics [2.61ms]
+(pass) QtiUsageDataDocumentSchema rejects invalid objectType and mapping bounds [0.41ms]
+(pass) QtiResponseProcessingDocumentSchema parses typed processing operators [12.29ms]
+(pass) QtiOutcomeProcessingDocumentSchema parses typed aggregate operators [7.14ms]
+(pass) QtiResponseProcessingDocumentSchema rejects invalid operator parameters [2.60ms]
+(pass) QtiOutcomeProcessingDocumentSchema rejects invalid operator arity and ranges [1.83ms]
+(pass) QtiAssessmentSectionDocumentSchema parses a minimal standalone section [2.78ms]
+(pass) QtiAssessmentStimulusDocumentSchema parses a minimal stimulus [1.75ms]
+(pass) QtiOutcomeDeclarationDocumentSchema parses a minimal outcome declaration [0.91ms]
+(pass) QtiAsiProfileDocumentSchema accepts resource-specific QTI documents [1.18ms]
+(pass) QtiAssessmentItemDocumentSchema parses a minimal choice item [19.61ms]
+(pass) QtiAssessmentItemDocumentSchema rejects incompatible response declarations [0.66ms]
+(pass) QtiAssessmentTestDocumentSchema parses a minimal test document [1.96ms]
+(pass) Qti301DerivedZodTemplates exposes expected document templates [0.04ms]
+(pass) QTI barrel exports prefixed XML extension node helpers [0.36ms]
+(pass) built-in outcome completionStatus needs no declaration in processing rules [0.25ms]
+(pass) an integer SCORE is accepted — the official corpus ships it [0.14ms]
+(pass) a non-numeric or multiple SCORE is still rejected [0.15ms]
+(pass) snake_case completion_status is accepted as the built-in's corpus alias [0.18ms]
+(pass) maxChoices 0 means unbounded and never conflicts with minChoices [0.42ms]
+(pass) QtiCatalogInfoSchema parses cards with language-keyed entries and direct content [1.29ms]
+(pass) QtiCatalogInfoSchema accepts data-* discriminators, defaults, and file references [0.32ms]
+(pass) a card is either entries or direct content, never both (XSD choice) [0.21ms]
+(pass) only one card entry may carry the default designation (§5.27.2) [0.11ms]
+(pass) card supports are the SupportEnum tokens or ext: extension strings [0.25ms]
 
 test/contracts.test.ts:
-(pass) RunnerConfigSchema parses minimal config [2.07ms]
-(pass) RunnerConfigSchema requires adapter for cmi5 suite [0.19ms]
-(pass) RunnerConfigSchema enforces bearer adapter token source [0.72ms]
-(pass) AdapterCapabilitySchema validates profile payload [0.57ms]
-(pass) AdapterProfileSchema validates cmi5 interoperability contract [3.75ms]
-(pass) AdapterProfileSchema requires cmi5 packageUpload [0.19ms]
-(pass) AdapterErrorSchema validates uniform error envelope [0.81ms]
+(pass) RunnerConfigSchema parses minimal config [3.56ms]
+(pass) RunnerConfigSchema requires adapter for cmi5 suite [0.36ms]
+(pass) RunnerConfigSchema enforces bearer adapter token source [1.27ms]
+(pass) AdapterCapabilitySchema validates profile payload [0.49ms]
+(pass) AdapterProfileSchema validates cmi5 interoperability contract [1.34ms]
+(pass) AdapterProfileSchema requires cmi5 packageUpload [0.09ms]
+(pass) AdapterErrorSchema validates uniform error envelope [0.49ms]
 
 test/qti-v2_2.test.ts:
-(pass) QtiV2_2 metadata document parses a minimal metadata payload with scoring modes [1.30ms]
-(pass) QtiV2_2 assessment stimulus and assessment item documents parse together [5.54ms]
-(pass) QtiV2_2 processing rejects invalid numeric operator parameters [13.66ms]
-(pass) QtiV2_2 curriculum standards metadata and manifest documents parse [2.30ms]
-(pass) QtiV2_2 APIP accessibility document parses external supplemental accessibility [2.29ms]
+(pass) QtiV2_2 metadata document parses a minimal metadata payload with scoring modes [0.73ms]
+(pass) QtiV2_2 assessment stimulus and assessment item documents parse together [3.50ms]
+(pass) QtiV2_2 processing rejects invalid numeric operator parameters [10.43ms]
+(pass) QtiV2_2 curriculum standards metadata and manifest documents parse [4.06ms]
+(pass) QtiV2_2 APIP accessibility document parses external supplemental accessibility [1.39ms]
 
 test/cat-v1_0.test.ts:
-(pass) CAT v1.0 Zod Schemas > Shared validators > UuidSchema validates RFC4122 compliant UUIDs [3.02ms]
-(pass) CAT v1.0 Zod Schemas > Shared validators > DateTimeSchema validates ISO8601 datetimes [0.39ms]
-(pass) CAT v1.0 Zod Schemas > Shared validators > ExtensionEnum supports standard values and ext:* vendor extensions [0.33ms]
-(pass) CAT v1.0 Zod Schemas > Shared validators > OutcomeVariableType supports outcome types and vendor extensions [0.06ms]
-(pass) CAT v1.0 Zod Schemas > Core data types > OutcomeVariable validates outcome variable structure [0.70ms]
-(pass) CAT v1.0 Zod Schemas > Core data types > OutcomeVariable rejects additional properties [0.15ms]
-(pass) CAT v1.0 Zod Schemas > Core data types > ResponseVariable validates candidate responses [0.23ms]
-(pass) CAT v1.0 Zod Schemas > Core data types > ItemRef validates item references [0.32ms]
-(pass) CAT v1.0 Zod Schemas > Core data types > ItemPool validates item pool with multiple items [0.27ms]
-(pass) CAT v1.0 Zod Schemas > Core data types > SectionData validates complete section configuration [1.10ms]
-(pass) CAT v1.0 Zod Schemas > Core data types > ItemStage validates items to present to candidate [0.76ms]
-(pass) CAT v1.0 Zod Schemas > Core data types > AssessmentResult validates candidate responses and outcomes [1.15ms]
-(pass) CAT v1.0 Zod Schemas > Core data types > CatEngineResultReport validates CAT engine response [0.93ms]
-(pass) CAT v1.0 Zod Schemas > Core data types > SessionInfo validates session state [0.87ms]
-(pass) CAT v1.0 Zod Schemas > REST operation payloads > CreateSectionRequest validates section creation [0.31ms]
-(pass) CAT v1.0 Zod Schemas > REST operation payloads > CreateSectionResponse validates section creation response [0.30ms]
-(pass) CAT v1.0 Zod Schemas > REST operation payloads > CreateSessionRequest validates session creation [0.40ms]
-(pass) CAT v1.0 Zod Schemas > REST operation payloads > CreateSessionResponse validates session creation response [0.30ms]
-(pass) CAT v1.0 Zod Schemas > REST operation payloads > SubmitResultsRequest validates result submission [0.37ms]
-(pass) CAT v1.0 Zod Schemas > REST operation payloads > SubmitResultsResponse validates CAT engine result report [0.08ms]
-(pass) CAT v1.0 Zod Schemas > REST operation payloads > EndSessionRequest validates session termination [0.34ms]
-(pass) CAT v1.0 Zod Schemas > REST operation payloads > EndSessionResponse validates session termination response [0.38ms]
-(pass) CAT v1.0 Zod Schemas > REST operation payloads > EndSectionRequest validates section closure [0.27ms]
-(pass) CAT v1.0 Zod Schemas > REST operation payloads > EndSectionResponse validates section closure response [0.16ms]
+(pass) CAT v1.0 Zod Schemas > Shared validators > UuidSchema validates RFC4122 compliant UUIDs [0.35ms]
+(pass) CAT v1.0 Zod Schemas > Shared validators > DateTimeSchema validates ISO8601 datetimes [0.26ms]
+(pass) CAT v1.0 Zod Schemas > Shared validators > ExtensionEnum supports standard values and ext:* vendor extensions [0.26ms]
+(pass) CAT v1.0 Zod Schemas > Shared validators > OutcomeVariableType supports outcome types and vendor extensions [0.04ms]
+(pass) CAT v1.0 Zod Schemas > Core data types > OutcomeVariable validates outcome variable structure [2.01ms]
+(pass) CAT v1.0 Zod Schemas > Core data types > OutcomeVariable rejects additional properties [0.28ms]
+(pass) CAT v1.0 Zod Schemas > Core data types > ResponseVariable validates candidate responses [0.20ms]
+(pass) CAT v1.0 Zod Schemas > Core data types > ItemRef validates item references [0.25ms]
+(pass) CAT v1.0 Zod Schemas > Core data types > ItemPool validates item pool with multiple items [0.20ms]
+(pass) CAT v1.0 Zod Schemas > Core data types > SectionData validates complete section configuration [0.64ms]
+(pass) CAT v1.0 Zod Schemas > Core data types > ItemStage validates items to present to candidate [0.53ms]
+(pass) CAT v1.0 Zod Schemas > Core data types > AssessmentResult validates candidate responses and outcomes [0.75ms]
+(pass) CAT v1.0 Zod Schemas > Core data types > CatEngineResultReport validates CAT engine response [0.62ms]
+(pass) CAT v1.0 Zod Schemas > Core data types > SessionInfo validates session state [0.58ms]
+(pass) CAT v1.0 Zod Schemas > REST operation payloads > CreateSectionRequest validates section creation [0.28ms]
+(pass) CAT v1.0 Zod Schemas > REST operation payloads > CreateSectionResponse validates section creation response [0.26ms]
+(pass) CAT v1.0 Zod Schemas > REST operation payloads > CreateSessionRequest validates session creation [0.29ms]
+(pass) CAT v1.0 Zod Schemas > REST operation payloads > CreateSessionResponse validates session creation response [0.21ms]
+(pass) CAT v1.0 Zod Schemas > REST operation payloads > SubmitResultsRequest validates result submission [0.26ms]
+(pass) CAT v1.0 Zod Schemas > REST operation payloads > SubmitResultsResponse validates CAT engine result report [0.05ms]
+(pass) CAT v1.0 Zod Schemas > REST operation payloads > EndSessionRequest validates session termination [0.19ms]
+(pass) CAT v1.0 Zod Schemas > REST operation payloads > EndSessionResponse validates session termination response [0.23ms]
+(pass) CAT v1.0 Zod Schemas > REST operation payloads > EndSectionRequest validates section closure [0.14ms]
+(pass) CAT v1.0 Zod Schemas > REST operation payloads > EndSectionResponse validates section closure response [0.10ms]
 (pass) CAT v1.0 Zod Schemas > REST operation bindings > REST operation catalog exposes all 6 CAT operations [0.05ms]
-(pass) CAT v1.0 Zod Schemas > REST operation bindings > CreateSection operation has correct structure [0.04ms]
-(pass) CAT v1.0 Zod Schemas > REST operation bindings > SubmitResults operation has correct path template [0.03ms]
-(pass) CAT v1.0 Zod Schemas > Derived templates > Cat10DerivedZodTemplates exposes specification metadata [0.36ms]
-(pass) CAT v1.0 Zod Schemas > Derived templates > Specification links point to official CAT v1.0 resources [0.08ms]
-(pass) CAT v1.0 Zod Schemas > Error handling > ErrorResponse validates error payloads [0.59ms]
+(pass) CAT v1.0 Zod Schemas > REST operation bindings > CreateSection operation has correct structure [0.03ms]
+(pass) CAT v1.0 Zod Schemas > REST operation bindings > SubmitResults operation has correct path template [0.02ms]
+(pass) CAT v1.0 Zod Schemas > Derived templates > Cat10DerivedZodTemplates exposes specification metadata [0.26ms]
+(pass) CAT v1.0 Zod Schemas > Derived templates > Specification links point to official CAT v1.0 resources [0.06ms]
+(pass) CAT v1.0 Zod Schemas > Error handling > ErrorResponse validates error payloads [0.34ms]
 
 test/schema-examples.test.ts:
-(pass) example configs parse with RunnerConfigSchema [0.49ms]
-(pass) summary sample shape validates [1.72ms]
-(pass) requirement trace sample shape validates [0.54ms]
-(pass) run metadata sample shape validates [1.38ms]
-(pass) adapter profile sample shape validates [0.18ms]
+(pass) example configs parse with RunnerConfigSchema [0.46ms]
+(pass) summary sample shape validates [1.63ms]
+(pass) requirement trace sample shape validates [0.52ms]
+(pass) run metadata sample shape validates [1.08ms]
+(pass) adapter profile sample shape validates [0.16ms]
 
 test/clr-v2_0.test.ts:
-(pass) ClrCredentialSchema parses a realistic CLR 2.0 credential [8.73ms]
-(pass) AchievementCredentialSchema parses a minimal achievement credential [2.21ms]
-(pass) ProfileSchema parses a minimal issuer profile [0.08ms]
-(pass) GetClrCredentialsResponseSchema parses credential and JWS collections [0.44ms]
-(pass) ImsxStatusInfoSchema enforces known status vocabularies [0.43ms]
-(pass) ClrCredentialSchema rejects credentials without the CLR context set [0.41ms]
-(pass) Clr20DerivedZodTemplates exposes the published entry points [0.08ms]
+(pass) ClrCredentialSchema parses a realistic CLR 2.0 credential [7.02ms]
+(pass) AchievementCredentialSchema parses a minimal achievement credential [1.84ms]
+(pass) ProfileSchema parses a minimal issuer profile [0.09ms]
+(pass) GetClrCredentialsResponseSchema parses credential and JWS collections [0.43ms]
+(pass) ImsxStatusInfoSchema enforces known status vocabularies [0.53ms]
+(pass) ClrCredentialSchema rejects credentials without the CLR context set [0.38ms]
+(pass) Clr20DerivedZodTemplates exposes the published entry points [0.05ms]
 
 test/cc-v1_4.test.ts:
-(pass) CommonCartridgeV1_4 parses a minimal core manifest [6.07ms]
-(pass) CommonCartridgeV1_4 rejects question-bank references from organization items [1.39ms]
-(pass) CommonCartridgeV1_4 parses a minimal thin manifest with embedded webLink XML [3.97ms]
-(pass) CommonCartridgeV1_4 thin profile rejects mismatched embedded resource XML [2.36ms]
-(pass) CommonCartridgeV1_4 K-12 LOM resource profile enforces required educational metadata [3.82ms]
-(pass) CommonCartridgeV1_4 parses assignment, line item, accessibility, and open video documents [6.17ms]
-(pass) CommonCartridgeV1_4 exposes expected derived templates [0.07ms]
+(pass) CommonCartridgeV1_4 parses a minimal core manifest [3.65ms]
+(pass) CommonCartridgeV1_4 rejects question-bank references from organization items [0.92ms]
+(pass) CommonCartridgeV1_4 parses a minimal thin manifest with embedded webLink XML [2.38ms]
+(pass) CommonCartridgeV1_4 thin profile rejects mismatched embedded resource XML [1.30ms]
+(pass) CommonCartridgeV1_4 K-12 LOM resource profile enforces required educational metadata [2.58ms]
+(pass) CommonCartridgeV1_4 parses assignment, line item, accessibility, and open video documents [5.43ms]
+(pass) CommonCartridgeV1_4 exposes expected derived templates [0.06ms]
 
 test/open-badges-v3_0.test.ts:
-(pass) AchievementCredentialSchema parses a realistic Open Badge credential [0.81ms]
-(pass) EndorsementCredentialSchema parses a valid endorsement credential [2.42ms]
-(pass) GetOpenBadgeCredentialsResponseSchema parses credential and JWS collections [0.46ms]
-(pass) AchievementCredentialSchema rejects missing OB context [0.47ms]
-(pass) OpenBadges30DerivedZodTemplates exposes expected entry points [0.07ms]
+(pass) AchievementCredentialSchema parses a realistic Open Badge credential [0.51ms]
+(pass) EndorsementCredentialSchema parses a valid endorsement credential [1.43ms]
+(pass) GetOpenBadgeCredentialsResponseSchema parses credential and JWS collections [0.36ms]
+(pass) AchievementCredentialSchema rejects missing OB context [0.33ms]
+(pass) OpenBadges30DerivedZodTemplates exposes expected entry points [0.05ms]
 
 test/vc-data-model-v2_0.test.ts:
-(pass) VerifiableCredentialSchema parses a minimal VC Data Model 2.0 credential [1.69ms]
-(pass) VerifiablePresentationSchema parses a presentation carrying VC and JWS credentials [0.89ms]
-(pass) VerifiableCredentialSchema rejects wrong core context [0.29ms]
-(pass) VcDataModel20DerivedZodTemplates exposes expected entry points [0.06ms]
+(pass) VerifiableCredentialSchema parses a minimal VC Data Model 2.0 credential [1.04ms]
+(pass) VerifiablePresentationSchema parses a presentation carrying VC and JWS credentials [0.54ms]
+(pass) VerifiableCredentialSchema rejects wrong core context [0.18ms]
+(pass) VcDataModel20DerivedZodTemplates exposes expected entry points [0.04ms]
 
 test/h5p-v1.test.ts:
-(pass) H5P PackageManifest accepts a minimal valid h5p.json [3.04ms]
-(pass) H5P PackageManifest accepts all optional fields [0.98ms]
-(pass) H5P PackageManifest rejects missing required title [0.27ms]
-(pass) H5P PackageManifest rejects invalid machine name [0.23ms]
-(pass) H5P PackageManifest rejects invalid embed type [0.20ms]
-(pass) H5P PackageManifest rejects yearTo < yearFrom [0.19ms]
-(pass) H5P PackageManifest rejects duplicate embed types [0.16ms]
-(pass) H5P LibraryManifest accepts a minimal valid library.json [1.99ms]
-(pass) H5P LibraryManifest accepts a runnable library with full fields [1.08ms]
-(pass) H5P LibraryManifest rejects invalid machineName [0.23ms]
-(pass) H5P VersionRef rejects patch version (not part of the schema) [0.13ms]
-(pass) H5P LibraryFolderName validates correct folder name [0.11ms]
-(pass) H5P LibraryFolderName rejects folder names with patch version [0.08ms]
-(pass) H5P Semantics accepts a simple text field [1.58ms]
-(pass) H5P Semantics accepts a boolean field [3.66ms]
-(pass) H5P Semantics accepts a select field with options [5.15ms]
-(pass) H5P Semantics accepts a group with nested fields [2.88ms]
-(pass) H5P Semantics accepts a list field containing a group [2.25ms]
-(pass) H5P Semantics accepts deeply nested groups (3 levels) [0.37ms]
-(pass) H5P Semantics accepts library field with options [0.19ms]
-(pass) H5P Semantics accepts an image field [0.12ms]
-(pass) H5P Semantics rejects unknown field type [1.96ms]
-(pass) H5P Semantics rejects field without name [0.79ms]
-(pass) H5P MediaFile accepts a valid image file reference [1.21ms]
-(pass) H5P LibraryEmbed accepts a valid embedded library reference [0.51ms]
+(pass) H5P PackageManifest accepts a minimal valid h5p.json [1.96ms]
+(pass) H5P PackageManifest accepts all optional fields [0.57ms]
+(pass) H5P PackageManifest rejects missing required title [0.15ms]
+(pass) H5P PackageManifest rejects invalid machine name [0.14ms]
+(pass) H5P PackageManifest rejects invalid embed type [0.11ms]
+(pass) H5P PackageManifest rejects yearTo < yearFrom [0.12ms]
+(pass) H5P PackageManifest rejects duplicate embed types [0.09ms]
+(pass) H5P LibraryManifest accepts a minimal valid library.json [1.10ms]
+(pass) H5P LibraryManifest accepts a runnable library with full fields [0.60ms]
+(pass) H5P LibraryManifest rejects invalid machineName [0.14ms]
+(pass) H5P VersionRef rejects patch version (not part of the schema) [0.06ms]
+(pass) H5P LibraryFolderName validates correct folder name [0.06ms]
+(pass) H5P LibraryFolderName rejects folder names with patch version [0.06ms]
+(pass) H5P Semantics accepts a simple text field [0.87ms]
+(pass) H5P Semantics accepts a boolean field [2.11ms]
+(pass) H5P Semantics accepts a select field with options [2.95ms]
+(pass) H5P Semantics accepts a group with nested fields [1.70ms]
+(pass) H5P Semantics accepts a list field containing a group [1.12ms]
+(pass) H5P Semantics accepts deeply nested groups (3 levels) [0.20ms]
+(pass) H5P Semantics accepts library field with options [0.11ms]
+(pass) H5P Semantics accepts an image field [0.07ms]
+(pass) H5P Semantics rejects unknown field type [1.04ms]
+(pass) H5P Semantics rejects field without name [0.42ms]
+(pass) H5P MediaFile accepts a valid image file reference [0.70ms]
+(pass) H5P LibraryEmbed accepts a valid embedded library reference [0.31ms]
 
 test/lti.test.ts:
-(pass) LTI core launch schema accepts a normalized resource link launch [7.33ms]
-(pass) LTI deep linking schema accepts request settings and response items [3.84ms]
-(pass) LTI AGS schema accepts endpoint, line item, score, and result shapes [2.78ms]
-(pass) LTI NRPS schema accepts names/roles service and membership container shapes [2.18ms]
-(pass) LTI proctoring schema accepts start and end assessment messages [2.80ms]
+(pass) LTI core launch schema accepts a normalized resource link launch [2.00ms]
+(pass) LTI deep linking schema accepts request settings and response items [1.93ms]
+(pass) LTI AGS schema accepts endpoint, line item, score, and result shapes [1.94ms]
+(pass) LTI NRPS schema accepts names/roles service and membership container shapes [1.46ms]
+(pass) LTI proctoring schema accepts start and end assessment messages [1.59ms]
 
 test/case-v1_1.test.ts:
-(pass) CASE v1.1 Schemas > Core entity schemas > should validate a valid CFAssociation [1.81ms]
-(pass) CASE v1.1 Schemas > Core entity schemas > should reject CFAssociation with invalid UUID [0.32ms]
-(pass) CASE v1.1 Schemas > REST binding operations > should expose getCFAssociation operation [0.05ms]
-(pass) CASE v1.1 Schemas > REST binding operations > should expose listCFAssociations operation [0.03ms]
-(pass) CASE v1.1 Schemas > REST binding operations > should expose getCFPackage operation [0.03ms]
+(pass) CASE v1.1 Schemas > Core entity schemas > should validate a valid CFAssociation [3.95ms]
+(pass) CASE v1.1 Schemas > Core entity schemas > should reject CFAssociation with invalid UUID [0.20ms]
+(pass) CASE v1.1 Schemas > REST binding operations > should expose getCFAssociation operation [0.03ms]
+(pass) CASE v1.1 Schemas > REST binding operations > should expose listCFAssociations operation [0.02ms]
+(pass) CASE v1.1 Schemas > REST binding operations > should expose getCFPackage operation [0.02ms]
 (pass) CASE v1.1 Schemas > REST binding operations > should expose listCFItems operation [0.02ms]
-(pass) CASE v1.1 Schemas > REST binding operations > should expose getCFRubric operation [0.03ms]
-(pass) CASE v1.1 Schemas > Shared validators > should validate RFC4122 UUID [0.04ms]
-(pass) CASE v1.1 Schemas > Shared validators > should reject invalid UUID format [3.11ms]
-(pass) CASE v1.1 Schemas > Shared validators > should validate ISO8601 datetime [0.15ms]
-(pass) CASE v1.1 Schemas > Shared validators > should validate link URI [0.61ms]
-(pass) CASE v1.1 Schemas > Extensible vocabularies > should allow standard association types [0.20ms]
-(pass) CASE v1.1 Schemas > Extensible vocabularies > should allow ext:* custom extensions [0.09ms]
-(pass) CASE v1.1 Schemas > Extensible vocabularies > should reject invalid ext: format [0.15ms]
-(pass) CASE v1.1 Schemas > Derived templates > should expose spec links [0.06ms]
-(pass) CASE v1.1 Schemas > Derived templates > should document scope coverage [0.04ms]
+(pass) CASE v1.1 Schemas > REST binding operations > should expose getCFRubric operation [0.01ms]
+(pass) CASE v1.1 Schemas > Shared validators > should validate RFC4122 UUID [0.02ms]
+(pass) CASE v1.1 Schemas > Shared validators > should reject invalid UUID format [0.06ms]
+(pass) CASE v1.1 Schemas > Shared validators > should validate ISO8601 datetime [0.02ms]
+(pass) CASE v1.1 Schemas > Shared validators > should validate link URI [0.36ms]
+(pass) CASE v1.1 Schemas > Extensible vocabularies > should allow standard association types [0.13ms]
+(pass) CASE v1.1 Schemas > Extensible vocabularies > should allow ext:* custom extensions [0.06ms]
+(pass) CASE v1.1 Schemas > Extensible vocabularies > should reject invalid ext: format [0.08ms]
+(pass) CASE v1.1 Schemas > Derived templates > should expose spec links [0.04ms]
+(pass) CASE v1.1 Schemas > Derived templates > should document scope coverage [0.02ms]
 
 test/caliper-v1_2.test.ts:
-(pass) ActionSchema validates Caliper action vocabulary [0.34ms]
-(pass) PersonSchema requires top-level @context for described entity documents [1.40ms]
-(pass) EventSchema enforces URN UUID ids and UTC-millisecond eventTime [2.09ms]
-(pass) AnnotationEventSchema enforces textual actor/action/object constraints [1.70ms]
-(pass) MessageEventSchema accepts MarkedAsUnRead textual alias [0.66ms]
-(pass) ViewEventSchema restricts target entity type to Frame [0.71ms]
-(pass) EnvelopeSchema enforces required fields and disallows custom top-level properties [9.82ms]
-(pass) TextPositionSelectorSchema requires type/start/end [0.85ms]
-(pass) SystemIdentifierSchema validates required identifier fields [0.75ms]
-(pass) Caliper12DerivedZodTemplates exposes key Caliper entry points and conformance metadata [0.11ms]
-
- 187 pass
+(pass) ActionSchema validates Caliper action vocabulary [0.17ms]
+(pass) PersonSchema requires top-level @context for described entity documents [1.11ms]
+(pass) EventSchema enforces URN UUID ids and UTC-millisecond eventTime [1.24ms]
+(pass) AnnotationEventSchema enforces textual actor/action/object constraints [0.99ms]
+(pass) MessageEventSchema accepts MarkedAsUnRead textual alias [0.40ms]
+(pass) ViewEventSchema restricts target entity type to Frame [0.41ms]
+(pass) EnvelopeSchema enforces required fields and disallows custom top-level properties [6.46ms]
+(pass) TextPositionSelectorSchema requires type/start/end [0.49ms]
+(pass) SystemIdentifierSchema validates required identifier fields [0.56ms]
+(pass) Caliper12DerivedZodTemplates exposes key Caliper entry points and conformance metadata [0.07ms]
+
+ 192 pass
  0 fail
- 318 expect() calls
-Ran 187 tests across 17 files. [826.00ms]
+ 325 expect() calls
+Ran 192 tests across 17 files. [518.00ms]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conform-ed/contracts",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "type": "module",
   "module": "src/index.ts",
   "exports": {

package/src/qti/v3_0_1/assessment-internal.ts

@@ -18,6 +18,7 @@ import {
   QtiShapeSchema,
   QtiShowHideSchema,
   QtiStringListSchema,
+  QtiMimeTypeSchema,
   QtiSuppressTtsSchema,
   QtiSubmissionModeSchema,
   QtiViewSchema,
@@ -766,11 +767,69 @@ export const QtiStimulusBodySchema: z.ZodType = z.lazy(() =>
   }),
 );
 
+// ---------- Companion materials (§2.13.1: "content props that provide key information") ----------
+
+/** ItemFileInfo: a content-file reference with its optional icon (digital materials, calculator info). */
+export const QtiItemFileInfoSchema = strictObject({
+  mimeType: QtiMimeTypeSchema.optional(),
+  label: z.string().optional(),
+  fileHref: z.string().min(1),
+  resourceIcon: z.string().optional(),
+});
+
+/** A measured increment: decimal value plus its required unit (linear or radial). */
+export const QtiMeasurementValueSchema = strictObject({
+  value: z.number(),
+  unit: z.enum([
+    "Millimeter",
+    "Centimeter",
+    "Meter",
+    "Kilometer",
+    "Inch",
+    "Foot",
+    "Yard",
+    "Mile",
+    "Radian",
+    "Degree",
+    "Minute",
+    "Second",
+  ]),
+});
+
+export const QtiCompanionCalculatorSchema = strictObject({
+  calculatorType: z.enum(["basic", "standard", "scientific", "graphing"]),
+  description: z.string(),
+  calculatorInfo: QtiItemFileInfoSchema.optional(),
+});
+
+export const QtiCompanionRuleSystemSchema = strictObject({
+  minimumLength: z.number().int(),
+  minorIncrement: QtiMeasurementValueSchema.optional(),
+  majorIncrement: QtiMeasurementValueSchema,
+});
+
+export const QtiCompanionRuleSchema = strictObject({
+  description: z.string(),
+  ruleSystemSi: QtiCompanionRuleSystemSchema.optional(),
+  ruleSystemUs: QtiCompanionRuleSystemSchema.optional(),
+});
+
+export const QtiCompanionProtractorIncrementSchema = strictObject({
+  minorIncrement: QtiMeasurementValueSchema.optional(),
+  majorIncrement: QtiMeasurementValueSchema,
+});
+
+export const QtiCompanionProtractorSchema = strictObject({
+  description: z.string(),
+  incrementSi: QtiCompanionProtractorIncrementSchema.optional(),
+  incrementUs: QtiCompanionProtractorIncrementSchema.optional(),
+});
+
 export const QtiCompanionMaterialsInfoSchema = strictObject({
-  calculators: z.array(z.unknown()).optional(),
-  rules: z.array(z.unknown()).optional(),
-  protractors: z.array(z.unknown()).optional(),
-  digitalMaterials: z.array(z.unknown()).optional(),
+  calculators: z.array(QtiCompanionCalculatorSchema).optional(),
+  rules: z.array(QtiCompanionRuleSchema).optional(),
+  protractors: z.array(QtiCompanionProtractorSchema).optional(),
+  digitalMaterials: z.array(QtiItemFileInfoSchema).optional(),
   physicalMaterials: z.array(z.string()).optional(),
   extensions: z.array(z.unknown()).optional(),
 });
@@ -1544,6 +1603,13 @@ export type QtiGapChoice = z.infer<typeof QtiGapChoiceSchema>;
 export type QtiCompanionMaterialsInfo = z.infer<typeof QtiCompanionMaterialsInfoSchema>;
 export type QtiAdaptiveHref = z.infer<typeof QtiAdaptiveHrefSchema>;
 export type QtiAdaptiveSelection = z.infer<typeof QtiAdaptiveSelectionSchema>;
+export type QtiItemFileInfo = z.infer<typeof QtiItemFileInfoSchema>;
+export type QtiMeasurementValue = z.infer<typeof QtiMeasurementValueSchema>;
+export type QtiCompanionCalculator = z.infer<typeof QtiCompanionCalculatorSchema>;
+export type QtiCompanionRuleSystem = z.infer<typeof QtiCompanionRuleSystemSchema>;
+export type QtiCompanionRule = z.infer<typeof QtiCompanionRuleSchema>;
+export type QtiCompanionProtractorIncrement = z.infer<typeof QtiCompanionProtractorIncrementSchema>;
+export type QtiCompanionProtractor = z.infer<typeof QtiCompanionProtractorSchema>;
 export type QtiSelection = z.infer<typeof QtiSelectionSchema>;
 export type QtiOrdering = z.infer<typeof QtiOrderingSchema>;
 export type QtiAssessmentItemRef = z.infer<typeof QtiAssessmentItemRefSchema>;

package/src/qti/v3_0_1/imsqtiv3p0_imscpv1p2_v1p0.ts

@@ -0,0 +1,76 @@
+import { z } from "zod";
+
+import { QtiMetadataSchema } from "./imsqti_metadatav3p0_v1p0";
+import { strictObject } from "./shared";
+
+/**
+ * The QTI 3.0 content-package manifest (imsqtiv3p0_imscpv1p2_v1p0.xsd, namespace
+ * …/qti/qtiv3p0/imscp_v1p1). Resource types are an open vocabulary by design — the
+ * official corpus itself mixes the imsqti_*_xmlv3p0 tokens with mime-style values
+ * (qtiusagedata/xml, resourcemetadata/xml) and LTI link types (imslti_xmlv1p1).
+ */
+
+const NonEmptyStringSchema = z.string().min(1);
+
+export const QtiV3ManifestResourceMetadataSchema = strictObject({
+  qtiMetadata: QtiMetadataSchema.optional(),
+  /** IEEE LOM subtree, preserved structurally (its own specification). */
+  lom: z.unknown().optional(),
+});
+
+export const QtiV3ManifestMetadataSchema = strictObject({
+  schema: NonEmptyStringSchema,
+  schemaVersion: NonEmptyStringSchema,
+  qtiMetadata: QtiMetadataSchema.optional(),
+  lom: z.unknown().optional(),
+});
+
+export const QtiV3ManifestFileSchema = strictObject({
+  href: NonEmptyStringSchema,
+  metadata: QtiV3ManifestResourceMetadataSchema.optional(),
+});
+
+export const QtiV3ManifestDependencySchema = strictObject({
+  identifierRef: NonEmptyStringSchema,
+});
+
+export const QtiV3ManifestResourceSchema = strictObject({
+  identifier: NonEmptyStringSchema,
+  type: NonEmptyStringSchema,
+  href: NonEmptyStringSchema.optional(),
+  metadata: QtiV3ManifestResourceMetadataSchema.optional(),
+  files: z.array(QtiV3ManifestFileSchema).optional(),
+  dependencies: z.array(QtiV3ManifestDependencySchema).optional(),
+});
+
+export const QtiV3ManifestSchema = strictObject({
+  identifier: NonEmptyStringSchema,
+  metadata: QtiV3ManifestMetadataSchema,
+  organizations: strictObject({}),
+  resources: z.array(QtiV3ManifestResourceSchema).default([]),
+}).superRefine((value, context) => {
+  const seen = new Set<string>();
+
+  for (const [index, resource] of value.resources.entries()) {
+    if (seen.has(resource.identifier)) {
+      context.addIssue({
+        code: "custom",
+        path: ["resources", index, "identifier"],
+        message: `Duplicate manifest resource identifier: ${resource.identifier}`,
+      });
+    }
+    seen.add(resource.identifier);
+  }
+});
+
+export const QtiManifestDocumentSchema = strictObject({
+  manifest: QtiV3ManifestSchema,
+});
+// Inferred types from exported Zod validators.
+export type QtiV3ManifestResourceMetadata = z.infer<typeof QtiV3ManifestResourceMetadataSchema>;
+export type QtiV3ManifestMetadata = z.infer<typeof QtiV3ManifestMetadataSchema>;
+export type QtiV3ManifestFile = z.infer<typeof QtiV3ManifestFileSchema>;
+export type QtiV3ManifestDependency = z.infer<typeof QtiV3ManifestDependencySchema>;
+export type QtiV3ManifestResource = z.infer<typeof QtiV3ManifestResourceSchema>;
+export type QtiV3Manifest = z.infer<typeof QtiV3ManifestSchema>;
+export type QtiManifestDocument = z.infer<typeof QtiManifestDocumentSchema>;

package/src/qti/v3_0_1/index.ts

@@ -13,6 +13,7 @@ export * from "./imsqti_sectionv3p0p1_v1p0";
 export * from "./imsqti_stimulusv3p0p1_v1p0";
 export * from "./imsqti_testv3p0p1_v1p0";
 export * from "./imsqti_usagedatav3p0_v1p0";
+export * from "./imsqtiv3p0_imscpv1p2_v1p0";
 export * from "./imsqtiv3p0_afa3p0pnp_v1p0";
 
 import { QtiAsiProfileDocumentSchema } from "./imsqti_asiv3p0p1_v1p0";
@@ -30,6 +31,7 @@ import {
 } from "./imsqti_testv3p0p1_v1p0";
 import { QtiUsageDataDocumentSchema } from "./imsqti_usagedatav3p0_v1p0";
 import { QtiAccessForAllPnpDocumentSchema, QtiAccessForAllPnpRecordsDocumentSchema } from "./imsqtiv3p0_afa3p0pnp_v1p0";
+import { QtiManifestDocumentSchema } from "./imsqtiv3p0_imscpv1p2_v1p0";
 
 export const Qti301DerivedZodTemplates = {
   qtiAsiProfileDocument: QtiAsiProfileDocumentSchema,
@@ -45,6 +47,7 @@ export const Qti301DerivedZodTemplates = {
   qtiMetadataDocument: QtiMetadataDocumentSchema,
   qtiAssessmentResultDocument: QtiAssessmentResultDocumentSchema,
   qtiUsageDataDocument: QtiUsageDataDocumentSchema,
+  qtiManifestDocument: QtiManifestDocumentSchema,
   qtiAccessForAllPnpDocument: QtiAccessForAllPnpDocumentSchema,
   qtiAccessForAllPnpRecordsDocument: QtiAccessForAllPnpRecordsDocumentSchema,
 } as const;

package/src/qti/v3_0_1/variables-internal.ts

@@ -10,7 +10,7 @@ import {
   QtiShapeSchema,
   QtiViewSchema,
   addIssue,
-  looseObject,
+  createXmlNodeSchema,
   strictObject,
 } from "./shared";
 
@@ -84,9 +84,93 @@ export const QtiStyleSheetSchema = strictObject({
   title: z.string().optional(),
 });
 
-export const QtiCatalogSchema = looseObject({
-  kind: z.literal("catalog"),
-  content: z.array(z.unknown()).optional(),
+// ---------- Catalog (CatalogInfo/Catalog/Card/CardEntry, §5.26–5.29) ----------
+
+/**
+ * Card support names: "This attribute names either pre-defined supports or a
+ * custom-named support" (§5.26.1) — the SupportEnum tokens (§8.38) or the XSD's
+ * SupportExtString pattern `(ext:)[a-zA-Z0-9_.\-]+`.
+ */
+export const QtiSupportNameSchema = z.union([
+  z.enum([
+    "additional-directions",
+    "audio-description",
+    "braille",
+    "glossary-on-screen",
+    "high-contrast",
+    "keyboard-directions",
+    "keyword-translation",
+    "linguistic-guidance",
+    "long-description",
+    "sign-language",
+    "simplified-language-portions",
+    "simplified-graphics",
+    "spoken",
+    "tactile",
+    "transcript",
+  ]),
+  z.string().regex(/^ext:[a-zA-Z0-9_.-]+$/u),
+]);
+
+/** Generic mixed HTML flow inside catalog content (HTMLContentFlow has no QTI elements). */
+const QtiHtmlContentFragmentSchema: z.ZodType = z.lazy(() =>
+  z.union([z.string(), createXmlNodeSchema(QtiHtmlContentFragmentSchema)]),
+);
+
+/** FileHrefCard (§7.15): a content-file URI with its required mime-type. */
+export const QtiFileHrefCardSchema = strictObject({
+  href: z.string(),
+  mimeType: QtiMimeTypeSchema,
+});
+
+/** HTMLContent (§5.63): the dormant alternative content in HTML format. */
+export const QtiCatalogHtmlContentSchema = strictObject({
+  xmlLang: z.string().optional(),
+  /** data-* extension characteristics, keyed without the "data-" prefix. */
+  dataAttributes: z.record(z.string(), z.string()).optional(),
+  content: z.array(QtiHtmlContentFragmentSchema).optional(),
+});
+
+/**
+ * CardEntry (§5.27): "an attribute (often custom attributes) on the CardEntry element
+ * declares the difference between the resources, and where the attribute value aligns
+ * with a specific preference/need from the candidate's PNP".
+ */
+export const QtiCardEntrySchema = strictObject({
+  xmlLang: z.string().optional(),
+  default: z.boolean().optional(),
+  /** data-* discriminators (e.g. data-reading-type), keyed without the "data-" prefix. */
+  dataAttributes: z.record(z.string(), z.string()).optional(),
+  htmlContent: QtiCatalogHtmlContentSchema.optional(),
+  fileHrefs: z.array(QtiFileHrefCardSchema).optional(),
+});
+
+/**
+ * Card (§5.26): dormant content for one named support. The XSD is a choice — either
+ * direct content (qti-html-content/qti-file-href) or card entries, never both.
+ */
+export const QtiCardSchema = strictObject({
+  support: QtiSupportNameSchema,
+  xmlLang: z.string().optional(),
+  htmlContent: QtiCatalogHtmlContentSchema.optional(),
+  fileHrefs: z.array(QtiFileHrefCardSchema).optional(),
+  cardEntries: z.array(QtiCardEntrySchema).min(1).optional(),
+}).superRefine((value, context) => {
+  if (value.cardEntries && (value.htmlContent || value.fileHrefs)) {
+    addIssue(context, ["cardEntries"], "A card holds either card entries or direct content, not both.");
+  }
+
+  // "Only one of the CardEntry instances can have a default designation." (§5.27.2)
+  const defaults = (value.cardEntries ?? []).filter((entry) => entry.default === true).length;
+  if (defaults > 1) {
+    addIssue(context, ["cardEntries"], "Only one card entry may be designated as the default.");
+  }
+});
+
+/** Catalog (§5.28): "located … from a data-catalog-idref" via its unique id. */
+export const QtiCatalogSchema = strictObject({
+  id: z.string().min(1),
+  cards: z.array(QtiCardSchema).min(1),
 });
 
 export const QtiCatalogInfoSchema = strictObject({
@@ -260,6 +344,11 @@ export type QtiInterpolationTable = z.infer<typeof QtiInterpolationTableSchema>;
 export type QtiMatchTableEntry = z.infer<typeof QtiMatchTableEntrySchema>;
 export type QtiMatchTable = z.infer<typeof QtiMatchTableSchema>;
 export type QtiStyleSheet = z.infer<typeof QtiStyleSheetSchema>;
+export type QtiSupportName = z.infer<typeof QtiSupportNameSchema>;
+export type QtiFileHrefCard = z.infer<typeof QtiFileHrefCardSchema>;
+export type QtiCatalogHtmlContent = z.infer<typeof QtiCatalogHtmlContentSchema>;
+export type QtiCardEntry = z.infer<typeof QtiCardEntrySchema>;
+export type QtiCard = z.infer<typeof QtiCardSchema>;
 export type QtiCatalog = z.infer<typeof QtiCatalogSchema>;
 export type QtiCatalogInfo = z.infer<typeof QtiCatalogInfoSchema>;
 export type QtiItemSessionControl = z.infer<typeof QtiItemSessionControlSchema>;

package/test/qti-v3_0_1.test.ts

@@ -9,6 +9,7 @@ import {
   QtiAssessmentSectionDocumentSchema,
   QtiAssessmentStimulusDocumentSchema,
   QtiAssessmentTestDocumentSchema,
+  QtiCatalogInfoSchema,
   QtiMetadataDocumentSchema,
   QtiOutcomeDeclarationDocumentSchema,
   QtiOutcomeProcessingDocumentSchema,
@@ -683,3 +684,111 @@ test("maxChoices 0 means unbounded and never conflicts with minChoices", () => {
 
   expect(parsed.success).toBe(true);
 });
+
+// ---------- Catalog (CatalogInfo/Catalog/Card/CardEntry, §5.26–5.29) ----------
+
+test("QtiCatalogInfoSchema parses cards with language-keyed entries and direct content", () => {
+  // Mirrors the official CatalogWithMultipleSupports.xml: a keyword-translation card
+  // with per-language entries plus a linguistic-guidance card carrying direct content.
+  const parsed = QtiCatalogInfoSchema.safeParse({
+    catalogs: [
+      {
+        id: "catalog1",
+        cards: [
+          {
+            support: "keyword-translation",
+            cardEntries: [
+              { xmlLang: "es", htmlContent: { content: ["preciso"] } },
+              { xmlLang: "de", htmlContent: { content: ["genau"] } },
+            ],
+          },
+          {
+            support: "linguistic-guidance",
+            htmlContent: { content: ["Accurate means correct."] },
+          },
+        ],
+      },
+    ],
+  });
+
+  expect(parsed.success).toBe(true);
+});
+
+test("QtiCatalogInfoSchema accepts data-* discriminators, defaults, and file references", () => {
+  // The sharedStimulus exemplars discriminate spoken entries by data-reading-type; the
+  // XSD allows file references with a required mime-type (FileHrefCard, §7.15).
+  const parsed = QtiCatalogInfoSchema.safeParse({
+    catalogs: [
+      {
+        id: "cat123_1",
+        cards: [
+          {
+            support: "spoken",
+            cardEntries: [
+              {
+                dataAttributes: { "reading-type": "computer-read-aloud" },
+                htmlContent: { content: ["Anina saw the crocodile."] },
+              },
+              {
+                default: true,
+                fileHrefs: [{ href: "audio/item123.mp3", mimeType: "audio/mpeg" }],
+              },
+            ],
+          },
+        ],
+      },
+    ],
+  });
+
+  expect(parsed.success).toBe(true);
+});
+
+test("a card is either entries or direct content, never both (XSD choice)", () => {
+  const parsed = QtiCatalogInfoSchema.safeParse({
+    catalogs: [
+      {
+        id: "c1",
+        cards: [
+          {
+            support: "braille",
+            htmlContent: { content: ["text"] },
+            cardEntries: [{ htmlContent: { content: ["entry"] } }],
+          },
+        ],
+      },
+    ],
+  });
+
+  expect(parsed.success).toBe(false);
+});
+
+test("only one card entry may carry the default designation (§5.27.2)", () => {
+  const parsed = QtiCatalogInfoSchema.safeParse({
+    catalogs: [
+      {
+        id: "c1",
+        cards: [
+          {
+            support: "sign-language",
+            cardEntries: [
+              { xmlLang: "ase", default: true, htmlContent: { content: ["a"] } },
+              { xmlLang: "fsl", default: true, htmlContent: { content: ["b"] } },
+            ],
+          },
+        ],
+      },
+    ],
+  });
+
+  expect(parsed.success).toBe(false);
+});
+
+test("card supports are the SupportEnum tokens or ext: extension strings", () => {
+  const card = (support: string) => ({
+    catalogs: [{ id: "c1", cards: [{ support, htmlContent: { content: ["x"] } }] }],
+  });
+
+  expect(QtiCatalogInfoSchema.safeParse(card("glossary-on-screen")).success).toBe(true);
+  expect(QtiCatalogInfoSchema.safeParse(card("ext:my-program-support")).success).toBe(true);
+  expect(QtiCatalogInfoSchema.safeParse(card("not-a-support")).success).toBe(false);
+});