@learncard/credential-library 2.0.4 → 2.1.0

package/README.md

@@ -209,6 +209,18 @@ their `kind`, reserved ID/spec pairing, and materialization template remain expl
 
 See the [Credential Viewer README](../../examples/credential-viewer/README.md) for details.
 
+### Practice and administrative examples
+
+Seven curated examples exercise RubricScore (`obv3/food-allergen-practice`),
+matched instructor scope (`obv3/food-allergen-facilitator`), French text
+(`obv3/food-allergen-practice-fr`), combined level-only and raw-score results
+(`obv3/phishing-transfer`), enrollment and accommodation claims without an
+achievement (`custom/course-enrollment`, `custom/exam-accommodation`), and mixed
+roles with canonical scalar CLR associations (`clr/mixed-role-portfolio`).
+They use the usual metadata and tag filters; all are unsigned templates. See
+[source provenance and attribution](./SOURCES.md) for the adapted corpus and
+alignment licenses.
+
 ## Fixture Metadata
 
 `kind` identifies the fixture's runtime shape: W3C VC fixtures use
@@ -251,7 +263,7 @@ See the [Credential Viewer README](../../examples/credential-viewer/README.md) f
 -   `vc-v2/membership-credential` — Professional association membership
 -   `vc-v2/license-credential` — Professional nursing license
 
-### Open Badges v3 (12)
+### Open Badges v3
 
 -   `obv3/minimal-badge` — Minimal OBv3 achievement credential
 -   `obv3/full-badge` — Full-featured badge with image, evidence, alignment, results, expiration
@@ -266,6 +278,23 @@ See the [Credential Viewer README](../../examples/credential-viewer/README.md) f
 -   `obv3/endorsement-credential` — Program accreditation endorsement
 -   `obv3/rubric-aligned-badge` — Open Skills Alignment result with rubric levels and CTDL alignment
 
+#### Qualifications (LC-2111)
+
+All seven are synthetic OBv3 credentials, searchable with the `lc-2111` tag in the [credential viewer](../../examples/credential-viewer/README.md#testing-qualifications-lc-2111):
+
+-   `obv3/qualification-license` — Professional electrical license
+-   `obv3/qualification-certification` — Project management certification
+-   `obv3/qualification-apprenticeship` — Electrical apprenticeship certificate
+-   `obv3/qualification-journeyman` — Journeyman electrician certificate
+-   `obv3/qualification-master` — Master electrician certificate
+-   `obv3/qualification-expired` — Safety certification expired on January 1, 2024
+-   `obv3/qualification-badge-override` — Certification with explicit `display.displayType: 'badge'`
+
+The expired credential is structurally valid and remains in **Select All Valid**. Enable **Keep fixture dates (including expired credentials)** in the viewer when issuing or sending it; default preparation refreshes historical expiration dates.
+
+Each fixture includes themed artwork in both `credential.image` and `credentialSubject.achievement.image`. The unmodified illustrations are by [OpenMoji](https://openmoji.org/), licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/); image captions retain the attribution. These are remotely hosted SVGs and require network access to load. Reissue or resend fixtures to see new artwork—previously issued credentials are not modified.
+
+
 ### CLR v2 (4)
 
 -   `clr/minimal` — Minimal Comprehensive Learner Record

package/SOURCES.md

@@ -0,0 +1,63 @@
+# Curated example sources
+
+The following seven unsigned examples are adapted from the FrenchFry Unsigned VC
+Library v1 (ZIP version 2, SHA-256
+`7b8fc95babb339f029d07fb132e93efd5f67a7296afc0a725ccfb6f6856cd748`).
+The corpus was generated by its `scripts/generate.py`; these examples are authored
+scenarios, not records of real assessments. Their metadata uses the existing
+`source: 'synthetic'`, `signed: false` convention. `validity: 'valid'` describes
+structural validity of an unsigned template, not verified issuance or authenticity.
+
+| Fixture                          | Original credential UUID               | Coverage                                                    |
+| -------------------------------- | -------------------------------------- | ----------------------------------------------------------- |
+| `obv3/food-allergen-practice`    | `7cc497f9-092a-5ea2-8cdb-7a2e60c25e68` | RubricScore with observed practice                          |
+| `obv3/food-allergen-facilitator` | `04adda59-747f-5d5b-b287-1a9b1943b2ba` | Teaching scope on the same topic                            |
+| `obv3/food-allergen-practice-fr` | `14adf3a3-43d2-5271-90be-9812f906deef` | French text with the same scoring structure and alignment   |
+| `obv3/phishing-transfer`         | `670ef7c6-b8de-532c-9667-9817a0c942e8` | Achieved-level-only and raw-score results together          |
+| `custom/course-enrollment`       | `6ea43ad2-3fb5-55dd-aee8-6380b7ec0725` | Enrollment without completion or assessed attainment        |
+| `custom/exam-accommodation`      | `0e341ee2-6006-51b9-a559-62d7ac21a4e1` | Accommodation without diagnosis or assessed attainment      |
+| `clr/mixed-role-portfolio`       | `47213155-4246-5f73-bcf4-54776e488e21` | Three mixed-role children and canonical scalar associations |
+
+Presentation text is shortened and issuer names follow the package's example
+conventions. Administrative examples use distinct custom types with inline
+JSON-LD mappings. The CLR uses the cached `context.json` URL, following the other
+CLR fixtures. Credential UUIDs and reserved example-domain identifiers remain
+deterministic; `prepareFixture` makes fresh UUIDs when requested. The CLR's
+achievement list mirrors child definitions and does not add awards. No corpus
+evaluation labels, other payloads, generator, or shared generation templates are
+imported. The French example is a counterpart, not a second independent scoring
+case.
+
+Issuer profiles reuse existing fictional examples: Cedar Technical Training
+(`clr/training-provider-record`), Tech Academy (`obv3/full-badge`), Community College
+XYZ (`clr/multi-achievement`), Metropolis University – Office of the Registrar
+(`vc-v2/education-degree`), and State University (`obv3/micro-credential`). The five
+issuer groups remain distinct; the CLR and its three children share the Community
+College XYZ profile. Administrative contexts define the profile and URL terms
+without adding achievement claims. These display profiles do not assert issuer
+trust or verification, and the original corpus release is unchanged.
+
+## Licenses and attribution
+
+Authored corpus scenario text and fixture bodies are dedicated under
+[CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/), excluding third-party
+material. TypeScript wrappers and package code follow the repository's MIT license.
+
+Alignment labels and descriptions retain their source identifiers:
+
+- **O\*NET:** Instructing and Critical Thinking, from the O*NET 31.0 Database,
+  U.S. Department of Labor, Employment and Training Administration (USDOL/ETA).
+  Used under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+  [Source and prescribed credit](https://www.onetcenter.org/license_db.html).
+  O*NET® is a trademark of USDOL/ETA. The scenario mappings and JSON representation
+  are adaptations; USDOL/ETA has not approved, endorsed, or tested them.
+- **ESCO:** Food safety principles and statistics, developed by the
+  European Commission's Directorate-General for Employment, Social Affairs and
+  Inclusion; dataset v1.2.0 was requested by the source corpus. Labels and
+  descriptions are used under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+  [Attribution and third-party notices](https://esco.ec.europa.eu/uk/node/456).
+  Scenario mappings and JSON representation are adaptations and do not imply
+  European Commission endorsement.
+
+W3C and 1EdTech contexts are referenced by URL, not copied or relicensed here.
+No CASE framework content is included in these seven examples.

package/dist/bundles/index.d.ts

@@ -0,0 +1,5 @@
+import type { CredentialBundle } from './types';
+export declare const getBundle: (id: string) => CredentialBundle;
+export { studentBundle } from './student';
+export type { CredentialBundle, CredentialBundleEntry, CredentialBundleIssuer } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/bundles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bundles/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAOhD,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,KAAG,gBAQtC,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC"}

package/dist/bundles/student.d.ts

@@ -0,0 +1,3 @@
+import type { CredentialBundle } from './types';
+export declare const studentBundle: CredentialBundle;
+//# sourceMappingURL=student.d.ts.map

package/dist/bundles/student.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"student.d.ts","sourceRoot":"","sources":["../../src/bundles/student.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAA0B,MAAM,SAAS,CAAC;AA+ExE,eAAO,MAAM,aAAa,EAAE,gBA2K3B,CAAC"}

package/dist/bundles/types.d.ts

@@ -0,0 +1,24 @@
+export interface CredentialBundleIssuer {
+    /** Namespaced profile ID created and owned by the sample seeder. */
+    profileId: `sample-${string}`;
+    /** Issuer name shown on the rendered credential. */
+    displayName: string;
+    /** Optional issuer avatar copied to the safe sample profile. */
+    image?: string;
+}
+export interface CredentialBundleEntry {
+    fixtureId: string;
+    /** Shift the fixture's issue date relative to the seed run. */
+    validFromOffsetDays: number;
+    /** Safe sample issuer used when publishing this credential. */
+    issuer: CredentialBundleIssuer;
+    /** Override the credential's display name after fixture preparation. */
+    name?: string;
+}
+export interface CredentialBundle {
+    id: string;
+    displayName: string;
+    blurb: string;
+    entries: readonly CredentialBundleEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/bundles/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bundles/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACnC,oEAAoE;IACpE,SAAS,EAAE,UAAU,MAAM,EAAE,CAAC;IAC9B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,MAAM,EAAE,sBAAsB,CAAC;IAC/B,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC7C"}