@kiva/kv-components 3.48.0 → 3.48.1

package/vue/KvClassicLoanCard.vue

@@ -181,7 +181,7 @@
 			>
 				<kv-loan-progress-group
 					id="loanProgress"
-					:money-left="unreservedAmount"
+					:money-left="`${unreservedAmount}`"
 					:progress-percent="fundraisingPercent"
 					class="tw-text-black"
 				/>
@@ -220,7 +220,8 @@
 </template>
 
 <script>
-import { mdiMapMarker } from '@mdi/js';
+import { loanCardComputedProperties, loanCardMethods } from '../utils/loanCard';
+
 import KvLoanUse from './KvLoanUse.vue';
 import KvBorrowerImage from './KvBorrowerImage.vue';
 import KvLoanProgressGroup from './KvLoanProgressGroup.vue';
@@ -231,12 +232,6 @@ import KvLoanTag from './KvLoanTag.vue';
 import KvMaterialIcon from './KvMaterialIcon.vue';
 import KvLoadingPlaceholder from './KvLoadingPlaceholder.vue';
 
-const LSE_LOAN_KEY = 'N/A';
-const ECO_FRIENDLY_KEY = 'ECO-FRIENDLY';
-const SUSTAINABLE_AG_KEY = 'SUSTAINABLE AG';
-const SINGLE_PARENT_KEY = 'SINGLE PARENT';
-const REFUGEE_KEY = 'REFUGEES/DISPLACED';
-
 export default {
 	name: 'KvClassicLoanCard',
 	components: {
@@ -263,10 +258,6 @@ export default {
 			type: Boolean,
 			default: false,
 		},
-		useFullWidth: {
-			type: Boolean,
-			default: false,
-		},
 		showTags: {
 			type: Boolean,
 			default: false,
@@ -279,10 +270,6 @@ export default {
 			type: Boolean,
 			default: false,
 		},
-		largeCard: {
-			type: Boolean,
-			default: false,
-		},
 		isAdding: {
 			type: Boolean,
 			default: false,
@@ -335,80 +322,77 @@ export default {
 			type: Boolean,
 			default: false,
 		},
+		customCallouts: {
+			type: Array,
+			default: () => ([]),
+		},
+		useFullWidth: {
+			type: Boolean,
+			default: false,
+		},
+		largeCard: {
+			type: Boolean,
+			default: false,
+		},
 	},
-	data() {
+	setup(props) {
+		const {
+			allDataLoaded,
+			borrowerName,
+			city,
+			countryName,
+			distributionModel,
+			formattedLocation,
+			fundraisingPercent,
+			hasProgressData,
+			imageHash,
+			isLoading,
+			loanAmount,
+			loanBorrowerCount,
+			loanCallouts,
+			loanStatus,
+			loanUse,
+			mdiMapMarker,
+			readMorePath,
+			state,
+			tag,
+			unreservedAmount,
+		} = loanCardComputedProperties(props);
+
+		const {
+			clickReadMore,
+			showLoanDetails,
+		} = loanCardMethods(props);
+
 		return {
+			allDataLoaded,
+			borrowerName,
+			city,
+			countryName,
+			distributionModel,
+			formattedLocation,
+			fundraisingPercent,
+			hasProgressData,
+			imageHash,
+			isLoading,
+			loanAmount,
+			loanBorrowerCount,
+			loanCallouts,
+			loanStatus,
+			loanUse,
 			mdiMapMarker,
+			readMorePath,
+			state,
+			tag,
+			unreservedAmount,
+			clickReadMore,
+			showLoanDetails,
 		};
 	},
 	computed: {
-		tag() {
-			return this.externalLinks ? 'a' : 'router-link';
-		},
-		readMorePath() {
-			return this.customLoanDetails ? '' : `/lend/${this.loanId}`;
-		},
-		isLoading() {
-			return !this.loanId || !this.loan;
-		},
 		cardWidth() {
 			return this.useFullWidth ? '100%' : '374px';
 		},
-		borrowerName() {
-			return this.loan?.name || '';
-		},
-		countryName() {
-			return this.loan?.geocode?.country?.name || '';
-		},
-		city() {
-			return this.loan?.geocode?.city || '';
-		},
-		state() {
-			return this.loan?.geocode?.state || '';
-		},
-		distributionModel() {
-			return this.loan?.distributionModel || '';
-		},
-		imageHash() {
-			return this.loan?.image?.hash ?? '';
-		},
-		hasProgressData() {
-			// Local resolver values for the progress bar load client-side
-			return typeof this.loan?.unreservedAmount !== 'undefined'
-				&& typeof this.loan?.fundraisingPercent !== 'undefined';
-		},
-		allDataLoaded() {
-			return !this.isLoading && this.hasProgressData;
-		},
-		fundraisingPercent() {
-			return this.loan?.fundraisingPercent ?? 0;
-		},
-		unreservedAmount() {
-			return this.loan?.unreservedAmount ?? '0';
-		},
-		formattedLocation() {
-			if (this.distributionModel === 'direct') {
-				const formattedString = `${this.city}, ${this.state}, ${this.countryName}`;
-				return formattedString;
-			}
-			if (this.countryName === 'Puerto Rico') {
-				const formattedString = `${this.city}, PR`;
-				return formattedString;
-			}
-			return this.countryName;
-		},
-		loanUse() {
-			return this.loan?.use ?? '';
-		},
-		loanStatus() {
-			return this.loan?.status ?? '';
-		},
-		loanAmount() {
-			return this.loan?.loanAmount ?? '0';
-		},
-		loanBorrowerCount() {
-			return this.loan?.borrowerCount ?? 0;
-		},
 		imageAspectRatio() {
 			if (this.largeCard) {
 				return 5 / 8;
@@ -430,95 +414,12 @@ export default {
 				{ width: 335, viewSize: 375 },
 			];
 		},
-		loanCallouts() {
-			const callouts = [];
-			const activityName = this.loan?.activity?.name ?? '';
-			const sectorName = this.loan?.sector?.name ?? '';
-			const tags = this.loan?.tags?.filter((tag) => tag.charAt(0) === '#')
-				.map((tag) => tag.substring(1)) ?? [];
-			const themes = this.loan?.themes ?? [];
-			const categories = {
-				ecoFriendly: !!tags // eslint-disable-next-line max-len
-					.filter((t) => t.toUpperCase() === ECO_FRIENDLY_KEY || t.toUpperCase() === SUSTAINABLE_AG_KEY).length,
-				refugeesIdps: !!themes.filter((t) => t.toUpperCase() === REFUGEE_KEY).length,
-				singleParents: !!tags.filter((t) => t.toUpperCase() === SINGLE_PARENT_KEY).length,
-			};
-
-			const isLseLoan = this.loan?.partnerName?.toUpperCase().includes(LSE_LOAN_KEY);
-
-			// P1 Category
-			// Exp limited to: Eco-friendly, Refugees and IDPs, Single Parents
-			// Tag as first option for LSE loans
-			if (isLseLoan && tags.length) {
-				const position = Math.floor(Math.random() * tags.length);
-				const tag = tags[position];
-				callouts.push(tag);
-			}
-
-			if (!this.categoryPageName) {
-				if (categories.ecoFriendly // eslint-disable-next-line max-len
-					&& !callouts.find((c) => c.toUpperCase() === ECO_FRIENDLY_KEY || c.toUpperCase() === SUSTAINABLE_AG_KEY)) {
-					callouts.push('Eco-friendly');
-				} else if (categories.refugeesIdps) {
-					callouts.push('Refugees and IDPs');
-				} else if (categories.singleParents
-					&& !callouts.find((c) => c.toUpperCase() === SINGLE_PARENT_KEY)) {
-					callouts.push('Single Parent');
-				}
-			}
-
-			// P2 Activity
-			if (activityName && this.categoryPageName?.toUpperCase() !== activityName.toUpperCase()) {
-				callouts.push(activityName);
-			}
-
-			// P3 Sector
-			if (sectorName
-				&& (activityName.toUpperCase() !== sectorName.toUpperCase())
-				&& (sectorName.toUpperCase() !== this.categoryPageName?.toUpperCase())
-				&& callouts.length < 2) {
-				callouts.push(sectorName);
-			}
-
-			// P4 Tag
-			if (!!tags.length && callouts.length < 2) {
-				const position = Math.floor(Math.random() * tags.length);
-				const tag = tags[position];
-				if (!callouts.filter((c) => c.toUpperCase() === tag.toUpperCase()).length) {
-					callouts.push(tag);
-				}
-			}
-
-			// P5 Theme
-			if (!!themes.length && callouts.length < 2) {
-				const position = Math.floor(Math.random() * themes.length);
-				const theme = themes[position];
-				if (!callouts.filter((c) => c.toUpperCase() === theme.toUpperCase()).length
-					&& theme.toUpperCase() !== this.categoryPageName?.toUpperCase()) {
-					callouts.push(theme);
-				}
-			}
-
-			// Only show one callout for LSE loans
-			if (isLseLoan && callouts.length > 1) return [callouts.shift()];
-			return callouts;
-		},
-	},
-	methods: {
-		showLoanDetails(e) {
-			if (this.customLoanDetails) {
-				e.preventDefault();
-				this.$emit('show-loan-details');
-			}
-		},
-		clickReadMore(target) {
-			this.kvTrackFunction('Lending', 'click-Read more', target, this.loanId);
-		},
 	},
 };
 </script>
 
 <style lang="postcss" scoped>
+/** Shared with KvWideLoanCard */
 .loan-card-use:hover,
 .loan-card-use:focus {
 	@apply tw-text-primary;

package/vue/KvWideLoanCard.vue

@@ -0,0 +1,429 @@
+<template>
+	<div
+		class="
+			tw-flex
+			tw-flex-row
+			tw-flex-wrap
+			tw-bg-white
+			tw-rounded
+			tw-w-full
+			tw-pb-1
+			tw-p-1
+			tw-gap-1
+			tw-items-center
+		"
+		:class="{'tw-pointer-events-none' : isLoading }"
+		style="box-shadow: 0 4px 12px rgba(0, 0, 0, 0.08);"
+	>
+		<div
+			class="loan-card-active-hover tw-flex-1 tw-min-w-[275px] md:tw-min-w-[320px] md:tw-max-w-[320px]"
+		>
+			<!-- Borrower image -->
+			<kv-loading-placeholder
+				v-if="isLoading"
+				class="tw-mb-1 tw-w-full tw-rounded"
+				:style="{ height: '15rem' }"
+			/>
+			<div
+				v-else
+				class="tw-relative tw-w-full"
+				@click="showLoanDetails"
+			>
+				<component
+					:is="tag"
+					:to="readMorePath"
+					:href="readMorePath"
+					class="tw-flex"
+					aria-label="Borrower image"
+					@click="clickReadMore('Photo')"
+				>
+					<kv-borrower-image
+						class="
+								tw-relative
+								tw-w-full
+								tw-bg-black
+								tw-rounded
+							"
+						:alt="`Photo of ${borrowerName}`"
+						:aspect-ratio="imageAspectRatio"
+						:default-image="{ width: imageDefaultWidth }"
+						:hash="imageHash"
+						:images="imageSizes"
+						:photo-path="photoPath"
+					/>
+
+					<div v-if="countryName">
+						<p
+							class="
+									tw-absolute
+									tw-bottom-1
+									tw-left-1
+									tw-text-primary
+									tw-bg-white
+									tw-rounded
+									tw-p-1
+									tw-mb-0
+									tw-mr-2
+									tw-text-h4
+									tw-inline-flex
+									tw-items-center"
+							style="padding: 2px 6px; text-transform: capitalize;"
+						>
+							<kv-material-icon
+								class="tw-h-2 tw-w-2"
+								:icon="mdiMapMarker"
+							/>
+							{{ formattedLocation }}
+						</p>
+					</div>
+				</component>
+				<kv-loan-bookmark
+					v-if="!isVisitor"
+					:loan-id="loanId"
+					:is-bookmarked="isBookmarked"
+					class="tw-absolute tw-right-1"
+					style="top: -6px;"
+					data-testid="loan-card-bookmark"
+					@toggle-bookmark="$emit('toggle-bookmark')"
+				/>
+			</div>
+		</div>
+
+		<div
+			class="tw-flex tw-flex-col tw-flex-1 tw-px-1"
+		>
+			<h3 class="tw-hidden md:tw-inline-block">
+				{{ borrowerName }}
+			</h3>
+			<!-- Loan tag -->
+			<component
+				:is="tag"
+				:to="readMorePath"
+				:href="readMorePath"
+				class="tw-flex hover:tw-no-underline focus:tw-no-underline"
+				aria-label="Loan tag"
+				@click="clickReadMore('Tag')"
+			>
+				<kv-loan-tag
+					v-if="showTags && !isLoading"
+					:loan="loan"
+					:kv-track-function="kvTrackFunction"
+				/>
+			</component>
+
+			<component
+				:is="tag"
+				:to="readMorePath"
+				:href="readMorePath"
+				class="loan-card-use tw-text-primary"
+				aria-label="Loan use"
+				@click="clickReadMore('Use')"
+			>
+				<!-- Loan use  -->
+				<div class="tw-pt-1">
+					<div
+						v-if="isLoading"
+						class="tw-w-full"
+						style="height: 5.5rem;"
+					>
+						<div
+							v-for="(_n, i) in [...Array(4)]"
+							:key="i"
+							class="tw-h-2 tw-mb-1"
+						>
+							<kv-loading-placeholder />
+						</div>
+					</div>
+					<div v-else>
+						<kv-loan-use
+							:use="loanUse"
+							:loan-amount="loanAmount"
+							:status="loanStatus"
+							:borrower-count="loanBorrowerCount"
+							:name="borrowerName"
+							:distribution-model="distributionModel"
+						/>
+					</div>
+				</div>
+			</component>
+			<!-- Loan call outs -->
+			<kv-loading-placeholder
+				v-if="isLoading || typeof loanCallouts === 'undefined'"
+				class="tw-mt-1.5 tw-mb-1"
+				:style="{ width: '60%', height: '1.75rem', 'border-radius': '500rem' }"
+			/>
+
+			<kv-loan-callouts
+				v-else
+				:callouts="loanCallouts"
+				class="loan-callouts tw-my-1.5"
+			/>
+
+			<div class="tw-flex tw-flex-row tw-justify-between tw-gap-1 md:tw-gap-3 ">
+				<!-- Fundraising -->
+				<div
+					v-if="!hasProgressData"
+					class="tw-w-full tw-pt-1 tw-pr-1"
+				>
+					<kv-loading-placeholder
+						class="tw-mb-0.5"
+						:style="{ width: '70%', height: '1.3rem' }"
+					/>
+
+					<kv-loading-placeholder
+						class="tw-rounded"
+						:style="{ width: '70%', height: '0.5rem' }"
+					/>
+				</div>
+				<component
+					:is="tag"
+					v-if="unreservedAmount > 0"
+					:to="readMorePath"
+					:href="readMorePath"
+					class="loan-card-progress tw-mt-1 tw-flex-grow"
+					aria-label="Loan progress"
+					@click="clickReadMore('Progress')"
+				>
+					<kv-loan-progress-group
+						id="loanProgress"
+						:money-left="`${unreservedAmount}`"
+						:progress-percent="fundraisingPercent"
+						class="tw-text-black"
+					/>
+				</component>
+
+				<!-- CTA Button -->
+				<kv-loading-placeholder
+					v-if="!allDataLoaded"
+					class="tw-rounded tw-self-start"
+					:style="{ width: '9rem', height: '3rem' }"
+				/>
+
+				<kv-lend-cta
+					v-else
+					:loan="loan"
+					:basket-items="basketItems"
+					:is-loading="isLoading"
+					:is-adding="isAdding"
+					:enable-five-dollars-notes="enableFiveDollarsNotes"
+					:five-dollars-selected="fiveDollarsSelected"
+					:kv-track-function="kvTrackFunction"
+					:show-view-loan="showViewLoan"
+					:custom-loan-details="customLoanDetails"
+					:external-links="externalLinks"
+					:route="route"
+					:user-balance="userBalance"
+					:get-cookie="getCookie"
+					:set-cookie="setCookie"
+					class="tw-mt-auto tw-self-end"
+					:class="{'tw-flex-grow' : unreservedAmount === 0, 'tw-flex-shrink-0' : unreservedAmount > 0}"
+					@add-to-basket="$emit('add-to-basket', $event)"
+					@show-loan-details="clickReadMore('ViewLoan')"
+				/>
+			</div>
+		</div>
+	</div>
+</template>
+
+<script>
+import { loanCardComputedProperties, loanCardMethods } from '../utils/loanCard';
+import KvLoanUse from './KvLoanUse.vue';
+import KvBorrowerImage from './KvBorrowerImage.vue';
+import KvLoanProgressGroup from './KvLoanProgressGroup.vue';
+import KvLoanCallouts from './KvLoanCallouts.vue';
+import KvLendCta from './KvLendCta.vue';
+import KvLoanBookmark from './KvLoanBookmark.vue';
+import KvLoanTag from './KvLoanTag.vue';
+import KvMaterialIcon from './KvMaterialIcon.vue';
+import KvLoadingPlaceholder from './KvLoadingPlaceholder.vue';
+
+export default {
+	name: 'KvWideLoanCard',
+	components: {
+		KvBorrowerImage,
+		KvLoadingPlaceholder,
+		KvLoanUse,
+		KvLoanProgressGroup,
+		KvMaterialIcon,
+		KvLendCta,
+		KvLoanTag,
+		KvLoanCallouts,
+		KvLoanBookmark,
+	},
+	props: {
+		loanId: {
+			type: Number,
+			default: undefined,
+		},
+		loan: {
+			type: Object,
+			default: null,
+		},
+		customLoanDetails: {
+			type: Boolean,
+			default: false,
+		},
+		showTags: {
+			type: Boolean,
+			default: false,
+		},
+		categoryPageName: {
+			type: String,
+			default: '',
+		},
+		enableFiveDollarsNotes: {
+			type: Boolean,
+			default: false,
+		},
+		isAdding: {
+			type: Boolean,
+			default: false,
+		},
+		isVisitor: {
+			type: Boolean,
+			default: true,
+		},
+		basketItems: {
+			type: Array,
+			default: () => ([]),
+		},
+		isBookmarked: {
+			type: Boolean,
+			default: false,
+		},
+		kvTrackFunction: {
+			type: Function,
+			required: true,
+		},
+		photoPath: {
+			type: String,
+			required: true,
+		},
+		showViewLoan: {
+			type: Boolean,
+			default: false,
+		},
+		externalLinks: {
+			type: Boolean,
+			default: false,
+		},
+		route: {
+			type: Object,
+			default: undefined,
+		},
+		userBalance: {
+			type: String,
+			default: undefined,
+		},
+		getCookie: {
+			type: Function,
+			default: undefined,
+		},
+		setCookie: {
+			type: Function,
+			default: undefined,
+		},
+		fiveDollarsSelected: {
+			type: Boolean,
+			default: false,
+		},
+		customCallouts: {
+			type: Array,
+			default: () => ([]),
+		},
+	},
+	setup(props) {
+		const {
+			allDataLoaded,
+			borrowerName,
+			city,
+			countryName,
+			distributionModel,
+			formattedLocation,
+			fundraisingPercent,
+			hasProgressData,
+			imageHash,
+			isLoading,
+			loanAmount,
+			loanBorrowerCount,
+			loanCallouts,
+			loanStatus,
+			loanUse,
+			mdiMapMarker,
+			readMorePath,
+			state,
+			tag,
+			unreservedAmount,
+		} = loanCardComputedProperties(props);
+
+		const {
+			clickReadMore,
+			showLoanDetails,
+		} = loanCardMethods(props);
+
+		return {
+			allDataLoaded,
+			borrowerName,
+			city,
+			countryName,
+			distributionModel,
+			formattedLocation,
+			fundraisingPercent,
+			hasProgressData,
+			imageHash,
+			isLoading,
+			loanAmount,
+			loanBorrowerCount,
+			loanCallouts,
+			loanStatus,
+			loanUse,
+			mdiMapMarker,
+			readMorePath,
+			state,
+			tag,
+			unreservedAmount,
+			clickReadMore,
+			showLoanDetails,
+		};
+	},
+	computed: {
+		cardWidth() {
+			return '374px';
+		},
+		imageAspectRatio() {
+			return 1;
+		},
+		imageDefaultWidth() {
+			return 320;
+		},
+		imageSizes() {
+			return [
+				{ width: this.imageDefaultWidth, viewSize: 1024 },
+				{ width: this.imageDefaultWidth, viewSize: 768 },
+				{ width: 416, viewSize: 480 },
+				{ width: 374, viewSize: 414 },
+				{ width: 335, viewSize: 375 },
+			];
+		},
+	},
+};
+</script>
+
+<style lang="postcss" scoped>
+/** Shared with KvClassicLoanCard */
+.loan-card-use:hover,
+.loan-card-use:focus {
+	@apply tw-text-primary;
+}
+.loan-card-active-hover:hover .loan-card-use {
+	@apply tw-underline;
+}
+.loan-card-progress:hover,
+.loan-card-progress:focus {
+	@apply tw-no-underline;
+}
+/** Unique to this loan card */
+.loan-callouts >>> div{
+	@apply tw-flex-wrap tw-h-auto;
+}
+</style>

package/vue/stories/KvBorrowerImage.stories.js

@@ -60,3 +60,9 @@ const props = {
 };
 
 export const Default = story(props);
+
+export const Square = story({
+	...props,
+	aspectRatio: 1,
+	defaultImage: { width: 300 },
+});