@interop/wallet-core 0.1.1 → 0.3.0

package/README.md

@@ -20,9 +20,10 @@
 wallet apps (a React Native mobile wallet and a browser wallet) hold in common:
 the cross-replica byte-compatibility surface both must agree on to converge on
 identical bytes. It is isomorphic (browser, Node.js, React Native) and has no
-UI, storage, or crypto-key dependencies -- every side effect is injected.
+UI or storage dependencies -- side effects are injected, and the dep-heavier
+protocol subpaths are import-directly-only.
 
-Two subpaths:
+Five subpaths:
 
 - **`@interop/wallet-core/sync`** -- the Wallet Attached Storage (WAS)
   replication engine core: the `SyncEngine` orchestration (single-flight,
@@ -39,6 +40,27 @@ Two subpaths:
   derivation, and the `was-link` QR hand-off contract. Contacts collection specs
   live in [`@interop/social-core`](https://npm.im/@interop/social-core).
 
+- **`@interop/wallet-core/identity`** -- the WAS identity derivation both
+  wallet apps must perform byte-for-byte identically: `agentsFromSecret` /
+  `agentsFromSeed` (controller secret or 32-byte seed to the did:key
+  `CapabilityAgent`, `ZcapClient`, X25519 key agreement key, and single-key
+  resolver, under the fixed bootstrap handle / key name) and
+  `singleKeyResolver`.
+
+- **`@interop/wallet-core/request`** -- wallet-request / exchange protocol
+  handling: request classification and parsing (CHAPI get/store events,
+  wallet-api messages and URLs), QueryByExample matching, cryptosuite
+  negotiation, `composeVp` (signer and holder injected), the pure
+  `processRequest` (consent runs in the caller; zcap / App Connect processing
+  injected), the VC-API exchange client, and VCALM `interaction:` URL handling.
+  The VPR type vocabulary lives in
+  [`@interop/data-integrity-core`](https://npm.im/@interop/data-integrity-core)
+  and is re-exported here.
+
+- **`@interop/wallet-core/display`** -- pure verifiable-credential derivation /
+  display helpers and credential input parsing. Raw values out (ISO strings,
+  `Date`, booleans); date formatting, i18n, and UI concerns stay in the app.
+
 ## Install
 
 - Node.js 24+ is recommended.
@@ -68,7 +90,9 @@ import {
 } from '@interop/wallet-core/space'
 ```
 
-Both subpaths are re-exported from the package root as well.
+The `sync` and `space` subpaths are re-exported from the package root as well.
+`identity`, `request`, and `display` are import-directly-only, so consumers of
+the root never pull the signing / KMS / document-loader dependency graph.
 
 ## Contribute
 

package/dist/display/alignment.d.ts

@@ -0,0 +1,49 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * Achievement alignment normalization. Two functions are kept on purpose
+ * because they answer different questions:
+ *
+ * - `normalizeAlignments` (from Freewallet) trims each alignment and drops the
+ *   ones with no `targetName`, returning a plain `{ targetName, targetUrl,
+ *   targetDescription }` view. It does NOT validate URLs.
+ * - `getValidAlignments` (from DCW) additionally runs a strict http(s) URL
+ *   safety check and reports it via an `isValidUrl` flag, so the UI can decide
+ *   whether to render a target as a clickable link. It omits `targetUrl` when
+ *   absent (rather than emitting `''`).
+ *
+ * Both had passing tests in their respective apps and both are exported.
+ */
+import type { IAlignment } from '@interop/data-integrity-core';
+/** The trimmed, always-present-string alignment view `normalizeAlignments` emits. */
+export interface IAlignmentView {
+    targetName: string;
+    targetUrl: string;
+    targetDescription: string;
+}
+/** A display-safe alignment with an optional validated URL (`getValidAlignments`). */
+export interface ValidAlignment {
+    targetName: string;
+    targetUrl?: string;
+    targetDescription?: string;
+    isValidUrl?: boolean;
+}
+/**
+ * Normalizes a raw alignment field (a single alignment or an array) to trimmed
+ * views, dropping entries with no `targetName`. Does not validate URLs.
+ *
+ * @param rawAlignments {unknown}
+ * @returns {IAlignmentView[]}
+ */
+export declare function normalizeAlignments(rawAlignments: unknown): IAlignmentView[];
+/**
+ * Filters alignments to those with a `targetName` and, for each, reports
+ * whether its `targetUrl` (when present) is a safe http(s) URL via `isValidUrl`.
+ * `targetUrl` is omitted from the result when the input had none.
+ *
+ * @param alignments {IAlignment[] | undefined}
+ * @returns {ValidAlignment[]}
+ */
+export declare function getValidAlignments(alignments?: IAlignment[]): ValidAlignment[];
+//# sourceMappingURL=alignment.d.ts.map

package/dist/display/alignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alignment.d.ts","sourceRoot":"","sources":["../../src/display/alignment.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAG9D,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,OAAO,GAAG,cAAc,EAAE,CAqB5E;AAoED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,CAAC,EAAE,UAAU,EAAE,GACxB,cAAc,EAAE,CAwBlB"}

package/dist/display/alignment.js

@@ -0,0 +1,114 @@
+import { asRecord } from './text.js';
+/**
+ * Normalizes a raw alignment field (a single alignment or an array) to trimmed
+ * views, dropping entries with no `targetName`. Does not validate URLs.
+ *
+ * @param rawAlignments {unknown}
+ * @returns {IAlignmentView[]}
+ */
+export function normalizeAlignments(rawAlignments) {
+    if (!rawAlignments) {
+        return [];
+    }
+    const alignmentArray = Array.isArray(rawAlignments)
+        ? rawAlignments
+        : [rawAlignments];
+    return alignmentArray
+        .map((alignmentField) => {
+        const normalizedField = asRecord(alignmentField) ?? {};
+        return {
+            targetName: String(normalizedField.targetName ?? '').trim(),
+            targetUrl: String(normalizedField.targetUrl ?? '').trim(),
+            targetDescription: String(normalizedField.targetDescription ?? '').trim()
+        };
+    })
+        .filter(alignmentField => Boolean(alignmentField.targetName));
+}
+function normalizeUrl(raw) {
+    const trimmed = String(raw).trim();
+    // If it already has a scheme (e.g., http:, https:)
+    if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(trimmed)) {
+        return trimmed;
+    }
+    // Otherwise, assume https
+    return `https://${trimmed}`;
+}
+function isStrictHttpUrl(raw) {
+    const candidate = String(raw).trim();
+    if (candidate.length === 0) {
+        return null;
+    }
+    if (/\s/.test(candidate)) {
+        return null;
+    }
+    const normalized = normalizeUrl(candidate);
+    // Reject strings that embed multiple schemes
+    const firstSchemeIdx = normalized.indexOf('://');
+    if (firstSchemeIdx === -1) {
+        return null;
+    }
+    if (normalized.indexOf('://', firstSchemeIdx + 3) !== -1) {
+        return null;
+    }
+    try {
+        const u = new URL(normalized);
+        // Only allow http(s)
+        if (u.protocol !== 'http:' && u.protocol !== 'https:') {
+            return null;
+        }
+        // Must have a hostname
+        if (!u.hostname) {
+            return null;
+        }
+        // Forbid credentials/userinfo
+        if (u.username || u.password) {
+            return null;
+        }
+        // Hostname must be reasonable, or be 'localhost' or an IPv4
+        const isHostname = /^[A-Za-z0-9.-]+$/.test(u.hostname);
+        const isLocalhost = u.hostname.toLowerCase() === 'localhost';
+        const isIPv4 = /^(25[0-5]|2[0-4]\d|1?\d?\d)(\.(25[0-5]|2[0-4]\d|1?\d?\d)){3}$/.test(u.hostname);
+        if (!(isHostname || isLocalhost || isIPv4)) {
+            return null;
+        }
+        // If it's a standard hostname (not localhost/IP), require at least one dot
+        if (isHostname && !isLocalhost && !isIPv4 && !u.hostname.includes('.')) {
+            return null;
+        }
+        return normalized;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Filters alignments to those with a `targetName` and, for each, reports
+ * whether its `targetUrl` (when present) is a safe http(s) URL via `isValidUrl`.
+ * `targetUrl` is omitted from the result when the input had none.
+ *
+ * @param alignments {IAlignment[] | undefined}
+ * @returns {ValidAlignment[]}
+ */
+export function getValidAlignments(alignments) {
+    if (!alignments || !Array.isArray(alignments)) {
+        return [];
+    }
+    return alignments
+        .filter(alignment => {
+        // targetName is required for display
+        return !!alignment.targetName;
+    })
+        .map(alignment => {
+        const result = {
+            targetName: alignment.targetName,
+            targetDescription: alignment.targetDescription
+        };
+        if (alignment.targetUrl) {
+            const normalizedUrl = isStrictHttpUrl(alignment.targetUrl);
+            result.targetUrl = alignment.targetUrl;
+            result.isValidUrl = !!normalizedUrl;
+        }
+        return result;
+    });
+}
+//# sourceMappingURL=alignment.js.map

package/dist/display/alignment.js.map

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

package/dist/display/credentialName.d.ts

@@ -0,0 +1,42 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * Credential title derivation.
+ *
+ * Drift resolution (merged chain): DCW and Freewallet produced different titles
+ * for the same credential. The merged `credentialName` keeps DCW's
+ * type-specific human prefixes first (product copy its screens rely on:
+ * `Recommendation From ...`, `Performance Review: ...`, the SkillClaim skill
+ * name, `Employment: ... @ ...`, `Volunteer: ... @ ...`), then falls through to
+ * Freewallet's more complete generic chain: top-level `vc.name`, achievement
+ * name(s) JOINED with `' · '` (DCW returned only the first), skill name(s),
+ * resolved person full name, `hasCredential.name`, a `'Skill Claim'` label for
+ * a SkillClaimCredential, and finally `'Verifiable Credential'`.
+ *
+ * Deliberate behavior changes vs DCW: the final fallback is now
+ * `'Verifiable Credential'` (was `'Unknown Credential'`); a multi-achievement
+ * VC joins all names with `' · '`; and an `achievement` name now wins over a
+ * sibling `hasCredential` name (Freewallet's chain order), where DCW preferred
+ * `hasCredential`.
+ */
+import type { IVerifiableCredential } from '@interop/data-integrity-core';
+/**
+ * Freewallet's generic title chain over a resolved subject: top-level name,
+ * achievement name(s), skill name(s), person full name, `hasCredential.name`,
+ * a `'Skill Claim'` label, else `'Verifiable Credential'`.
+ *
+ * @param verifiableCredential {IVerifiableCredential}
+ * @param subject {Record<string, unknown>}
+ * @returns {string}
+ */
+export declare function credentialNameFrom(verifiableCredential: IVerifiableCredential, subject: Record<string, unknown>): string;
+/**
+ * The display title for a credential: DCW's type-specific prefixes first, then
+ * the generic {@link credentialNameFrom} chain.
+ *
+ * @param credential {IVerifiableCredential}
+ * @returns {string}
+ */
+export declare function credentialName(credential: IVerifiableCredential): string;
+//# sourceMappingURL=credentialName.d.ts.map

package/dist/display/credentialName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentialName.d.ts","sourceRoot":"","sources":["../../src/display/credentialName.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAOzE;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,oBAAoB,EAAE,qBAAqB,EAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CA8CR;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM,CAkDxE"}

package/dist/display/credentialName.js

@@ -0,0 +1,106 @@
+import { typeArray } from '@interop/data-integrity-core/guards';
+import { getSubject, resolvePersonFullName } from './subject.js';
+import { achievementsList, skillsList } from './obv3.js';
+import { isEmploymentCredential, isVolunteerCredential } from './types.js';
+import { asNonEmptyString, asRecord, getTrimmedString } from './text.js';
+/**
+ * Freewallet's generic title chain over a resolved subject: top-level name,
+ * achievement name(s), skill name(s), person full name, `hasCredential.name`,
+ * a `'Skill Claim'` label, else `'Verifiable Credential'`.
+ *
+ * @param verifiableCredential {IVerifiableCredential}
+ * @param subject {Record<string, unknown>}
+ * @returns {string}
+ */
+export function credentialNameFrom(verifiableCredential, subject) {
+    const topLevelName = getTrimmedString(verifiableCredential.name);
+    if (topLevelName) {
+        return topLevelName;
+    }
+    const achievementNames = achievementsList(subject)
+        .map(achievement => getTrimmedString(achievement.name))
+        .filter((name) => Boolean(name));
+    if (achievementNames.length > 1) {
+        return achievementNames.join(' · ');
+    }
+    const [firstAchievementName] = achievementNames;
+    if (firstAchievementName) {
+        return firstAchievementName;
+    }
+    const skillNames = skillsList(subject)
+        .map(skill => getTrimmedString(skill.name))
+        .filter((name) => Boolean(name));
+    if (skillNames.length > 1) {
+        return skillNames.join(' · ');
+    }
+    const [firstSkillName] = skillNames;
+    if (firstSkillName) {
+        return firstSkillName;
+    }
+    const resumeFullName = resolvePersonFullName(subject);
+    if (resumeFullName) {
+        return resumeFullName;
+    }
+    const hasCredential = asRecord(subject.hasCredential);
+    const hasCredentialName = getTrimmedString(hasCredential?.name);
+    if (hasCredentialName) {
+        return hasCredentialName;
+    }
+    if (typeArray(verifiableCredential.type).includes('SkillClaimCredential')) {
+        return 'Skill Claim';
+    }
+    return 'Verifiable Credential';
+}
+/**
+ * The display title for a credential: DCW's type-specific prefixes first, then
+ * the generic {@link credentialNameFrom} chain.
+ *
+ * @param credential {IVerifiableCredential}
+ * @returns {string}
+ */
+export function credentialName(credential) {
+    const types = typeArray(credential.type);
+    const subject = asRecord(getSubject(credential)) ?? {};
+    if (types.includes('https://schema.org/RecommendationCredential')) {
+        const name = asNonEmptyString(subject.name);
+        return name ? `Recommendation From ${name}` : 'Recommendation Credential';
+    }
+    if (types.includes('PerformanceReviewCredential')) {
+        const employeeName = asNonEmptyString(subject.employeeName);
+        return employeeName
+            ? `Performance Review: ${employeeName}`
+            : 'Performance Review Credential';
+    }
+    if (types.includes('SkillClaimCredential')) {
+        const [firstSkill] = skillsList(subject);
+        const skillName = asNonEmptyString(firstSkill?.name);
+        if (skillName) {
+            return skillName;
+        }
+        // fall through to the generic chain (lands on 'Skill Claim')
+    }
+    if (isEmploymentCredential(credential)) {
+        const fullName = asNonEmptyString(subject.fullName);
+        const company = asNonEmptyString(subject.company);
+        if (fullName && company) {
+            return `Employment: ${fullName} @ ${company}`;
+        }
+        if (fullName) {
+            return `Employment: ${fullName}`;
+        }
+        return 'Employment Credential';
+    }
+    if (isVolunteerCredential(credential)) {
+        const fullName = asNonEmptyString(subject.fullName);
+        const volunteerOrg = asNonEmptyString(subject.volunteerOrg);
+        if (fullName && volunteerOrg) {
+            return `Volunteer: ${fullName} @ ${volunteerOrg}`;
+        }
+        if (fullName) {
+            return `Volunteer: ${fullName}`;
+        }
+        return 'Volunteer Credential';
+    }
+    return credentialNameFrom(credential, subject);
+}
+//# sourceMappingURL=credentialName.js.map

package/dist/display/credentialName.js.map

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

package/dist/display/displayFields.d.ts

@@ -0,0 +1,55 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * Freewallet's aggregate display projection: one pass over a VC producing the
+ * flat field set the credential card and detail view render. Dates stay RAW
+ * (the `expirationDate` field is an ISO string, not a formatted one -- the
+ * raw-values seam); the title comes from the merged {@link credentialName}.
+ *
+ * `credentialNameFrom` lives in `credentialName.ts` (co-located with the merged
+ * title fn that calls it); `buildCredentialDescription` / `buildCriteria` are
+ * Freewallet's, kept here as they are used only by `getDisplayFields` (and
+ * covered by the ported helper tests).
+ */
+import type { IAlignment, IVerifiableCredential } from '@interop/data-integrity-core';
+/** The flat display projection of a VC for the card / detail view. */
+export interface CredentialDisplayFields {
+    credentialName: string;
+    issuedTo: string;
+    /** Raw ISO expiration string (`''` when none). */
+    expirationDate: string;
+    credentialDescription: string;
+    criteria: string;
+    achievementImage: string;
+    achievementType: string;
+    alignments: IAlignment[];
+}
+/**
+ * Joins achievement descriptions, skill narratives / durations, and various
+ * subject description fields into a single paragraph-separated string.
+ *
+ * @param subject {Record<string, unknown>}
+ * @param achievements {Record<string, unknown>[]}
+ * @returns {string}
+ */
+export declare function buildCredentialDescription(subject: Record<string, unknown>, achievements: Record<string, unknown>[]): string;
+/**
+ * Builds the criteria text from the achievements' criteria narratives (labeled
+ * with the achievement name when there is more than one), falling back to the
+ * subject's `hasCredential.competencyRequired`.
+ *
+ * @param subject {Record<string, unknown>}
+ * @param achievements {Record<string, unknown>[]}
+ * @returns {string}
+ */
+export declare function buildCriteria(subject: Record<string, unknown>, achievements: Record<string, unknown>[]): string;
+/**
+ * Projects a VC to its flat display field set. The title uses the merged
+ * {@link credentialName}; `expirationDate` is a raw ISO string.
+ *
+ * @param verifiableCredential {IVerifiableCredential}
+ * @returns {CredentialDisplayFields}
+ */
+export declare function getDisplayFields(verifiableCredential: IVerifiableCredential): CredentialDisplayFields;
+//# sourceMappingURL=displayFields.d.ts.map

package/dist/display/displayFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayFields.d.ts","sourceRoot":"","sources":["../../src/display/displayFields.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAEV,UAAU,EACV,qBAAqB,EACtB,MAAM,8BAA8B,CAAA;AAerC,sEAAsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAA;IACtB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,UAAU,EAAE,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACtC,MAAM,CAqDR;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACtC,MAAM,CAuBR;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,oBAAoB,EAAE,qBAAqB,GAC1C,uBAAuB,CA2CzB"}

package/dist/display/displayFields.js

@@ -0,0 +1,136 @@
+import { credentialName } from './credentialName.js';
+import { getSubject, extractIssuedTo } from './subject.js';
+import { getExpirationDate } from './validity.js';
+import { achievementsList, skillsList, getSkillImage, getEvidenceImage, getAchievementImage, getAchievementType } from './obv3.js';
+import { normalizeAlignments } from './alignment.js';
+import { asRecord, getTrimmedString } from './text.js';
+/**
+ * Joins achievement descriptions, skill narratives / durations, and various
+ * subject description fields into a single paragraph-separated string.
+ *
+ * @param subject {Record<string, unknown>}
+ * @param achievements {Record<string, unknown>[]}
+ * @returns {string}
+ */
+export function buildCredentialDescription(subject, achievements) {
+    const descriptionParts = [];
+    for (const achievement of achievements) {
+        const achievementDescription = getTrimmedString(achievement.description);
+        if (achievementDescription) {
+            descriptionParts.push(achievementDescription);
+        }
+    }
+    for (const skill of skillsList(subject)) {
+        const narrative = getTrimmedString(skill.narrative);
+        if (narrative) {
+            descriptionParts.push(narrative);
+        }
+        const skillDuration = getTrimmedString(skill.durationPerformed);
+        if (skillDuration) {
+            descriptionParts.push(`Duration: ${skillDuration}`);
+        }
+    }
+    const subjectNarrative = getTrimmedString(subject.narrative);
+    if (subjectNarrative) {
+        descriptionParts.push(subjectNarrative);
+    }
+    const evidenceDescription = getTrimmedString(subject.evidenceDescription);
+    if (evidenceDescription) {
+        descriptionParts.push(evidenceDescription);
+    }
+    const duration = getTrimmedString(subject.duration);
+    if (duration) {
+        descriptionParts.push(`Duration: ${duration}`);
+    }
+    const evidenceLink = getTrimmedString(subject.evidenceLink);
+    if (evidenceLink) {
+        descriptionParts.push(`Evidence: ${evidenceLink}`);
+    }
+    const subjectDescription = getTrimmedString(subject.description);
+    if (subjectDescription) {
+        descriptionParts.push(subjectDescription);
+    }
+    const hasCredential = asRecord(subject.hasCredential);
+    const hasCredentialDescription = getTrimmedString(hasCredential?.description);
+    if (hasCredentialDescription) {
+        descriptionParts.push(hasCredentialDescription);
+    }
+    return descriptionParts.join('\n\n');
+}
+/**
+ * Builds the criteria text from the achievements' criteria narratives (labeled
+ * with the achievement name when there is more than one), falling back to the
+ * subject's `hasCredential.competencyRequired`.
+ *
+ * @param subject {Record<string, unknown>}
+ * @param achievements {Record<string, unknown>[]}
+ * @returns {string}
+ */
+export function buildCriteria(subject, achievements) {
+    const criteriaBlocks = achievements
+        .map(achievement => {
+        const criteria = asRecord(achievement.criteria);
+        const narrative = getTrimmedString(criteria?.narrative);
+        if (!narrative) {
+            return '';
+        }
+        const achievementName = getTrimmedString(achievement.name);
+        if (achievements.length > 1 && achievementName) {
+            return `**${achievementName}**\n\n${narrative}`;
+        }
+        return narrative;
+    })
+        .filter((criteriaBlock) => Boolean(criteriaBlock));
+    const criteriaText = criteriaBlocks.join('\n\n');
+    if (criteriaText) {
+        return criteriaText;
+    }
+    const hasCredential = asRecord(subject.hasCredential);
+    return getTrimmedString(hasCredential?.competencyRequired);
+}
+/**
+ * Projects a VC to its flat display field set. The title uses the merged
+ * {@link credentialName}; `expirationDate` is a raw ISO string.
+ *
+ * @param verifiableCredential {IVerifiableCredential}
+ * @returns {CredentialDisplayFields}
+ */
+export function getDisplayFields(verifiableCredential) {
+    const commonFields = {
+        credentialName: credentialName(verifiableCredential),
+        issuedTo: extractIssuedTo(verifiableCredential),
+        expirationDate: getExpirationDate(verifiableCredential) ?? ''
+    };
+    const subject = asRecord(getSubject(verifiableCredential));
+    if (!subject) {
+        return {
+            ...commonFields,
+            credentialDescription: '',
+            criteria: '',
+            achievementImage: '',
+            achievementType: '',
+            alignments: []
+        };
+    }
+    const achievements = achievementsList(subject);
+    const primaryAchievement = achievements[0];
+    const skills = skillsList(subject);
+    const alignments = achievements.flatMap(achievement => normalizeAlignments(achievement.alignment));
+    const evidenceRaw = verifiableCredential.evidence;
+    const evidence = Array.isArray(evidenceRaw)
+        ? evidenceRaw
+        : evidenceRaw
+            ? [evidenceRaw]
+            : [];
+    return {
+        ...commonFields,
+        credentialDescription: buildCredentialDescription(subject, achievements),
+        criteria: buildCriteria(subject, achievements),
+        achievementImage: getAchievementImage(primaryAchievement) ||
+            getSkillImage(skills) ||
+            getEvidenceImage(evidence),
+        achievementType: getAchievementType(primaryAchievement),
+        alignments
+    };
+}
+//# sourceMappingURL=displayFields.js.map

package/dist/display/displayFields.js.map

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

package/dist/display/evidence.d.ts

@@ -0,0 +1,44 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * Portfolio-evidence extraction (from DCW; no Freewallet equivalent beyond the
+ * image helper in `obv3.ts`). Turns a credential's `evidence` array (or a
+ * subject `portfolio`) into a flat list of `{ name, url }` links, coercing the
+ * many shapes evidence appears in (string URL, `{ url }`, `{ id }`) and dropping
+ * anything without a usable URL.
+ */
+/** A resolved evidence link. */
+export type PortfolioEvidenceItem = {
+    name: string;
+    url: string;
+};
+/** Evidence item from a W3C VC evidence array: `{ id, type, name }`. */
+export type VCEvidenceItem = {
+    id: string;
+    type?: string;
+    name?: string;
+};
+/** A VC carrying a top-level `evidence` array (W3C / IMS OB spec). */
+export type VCWithEvidence = {
+    evidence?: unknown;
+    credentialSubject?: unknown;
+};
+/**
+ * Extracts evidence links from a raw array/object/string, dropping items with
+ * no usable URL.
+ *
+ * @param raw {unknown}
+ * @returns {PortfolioEvidenceItem[]}
+ */
+export declare function portfolioEvidenceFrom(raw: unknown): PortfolioEvidenceItem[];
+/**
+ * Extracts evidence from a credential: prefers the credential's top-level
+ * `evidence` array, else falls back to the subject's `portfolio`.
+ *
+ * @param credential {VCWithEvidence}
+ * @param subject {unknown} optional pre-resolved subject
+ * @returns {PortfolioEvidenceItem[]}
+ */
+export declare function evidenceFromCredential(credential: VCWithEvidence, subject?: unknown): PortfolioEvidenceItem[];
+//# sourceMappingURL=evidence.d.ts.map

package/dist/display/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/display/evidence.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;GAMG;AAEH,gCAAgC;AAChC,MAAM,MAAM,qBAAqB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjE,wEAAwE;AACxE,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,sEAAsE;AACtE,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AA8BD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,EAAE,CAG3E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,cAAc,EAC1B,OAAO,CAAC,EAAE,OAAO,GAChB,qBAAqB,EAAE,CAazB"}