@kiva/kv-components 3.107.0 → 3.107.2

package/dist/components/KvVotingCardV2.vue

@@ -0,0 +1,154 @@
+<template>
+	<div
+		class="vote_card tw-flex tw-flex-col tw-justify-end"
+		:style="cssProps"
+	>
+		<div
+			class="tw-flex-grow-0 tw-text-white"
+		>
+			<h2 class="tw-italic tw-pb-1">
+				{{ title }}
+			</h2>
+			<p class="tw-pb-1.5">
+				{{ truncatedDescription }}
+				<a
+					v-if="isTruncated"
+					class="tw-underline tw-pl-1 tw-text-white tw-cursor-pointer"
+					@click="isLightboxOpen = true"
+				>read more</a>
+			</p>
+			<div class="tw-block md:tw-flex tw-justify-between">
+				<div
+					v-if="showPercentage"
+					class="tw-flex tw-items-center tw-w-full tw-max-w-16"
+				>
+					<kv-progress-bar
+						class="tw-flex-grow"
+						:aria-label="'Percent of votes for ' + description"
+						:value="percentage"
+					/>
+					<div class="tw-ml-2">
+						{{ percentage }}%
+					</div>
+				</div>
+				<kv-button
+					v-if="showVoteButton"
+					variant="secondary"
+					class="tw-flex-grow-0 tw-min-w-16 tw-mt-2"
+					@click="castVote"
+				>
+					Vote
+				</kv-button>
+			</div>
+		</div>
+		<KvLightbox
+			:title="title"
+			:visible="isLightboxOpen"
+			@lightbox-closed="isLightboxOpen = false"
+		>
+			<template #header>
+				<h3>
+					{{ title }}
+				</h3>
+			</template>
+			<p class="tw-pb-1.5">
+				{{ description }}
+			</p>
+		</KvLightbox>
+	</div>
+</template>
+
+<script>
+import {
+	computed,
+	ref,
+	toRefs,
+} from 'vue-demi';
+import KvProgressBar from './KvProgressBar.vue';
+import KvButton from './KvButton.vue';
+import KvLightbox from './KvLightbox.vue';
+
+export default {
+	name: 'KvVotingCard',
+	components: {
+		KvButton,
+		KvLightbox,
+		KvProgressBar,
+	},
+	props: {
+		title: {
+			type: String,
+			default: '',
+		},
+		description: {
+			type: String,
+			default: '',
+		},
+		backgroundImageUrl: {
+			type: String,
+			default: '',
+		},
+		percentage: {
+			type: Number,
+			default: 0,
+		},
+		showVoteButton: {
+			type: Boolean,
+			default: true,
+		},
+		showPercentage: {
+			type: Boolean,
+			default: true,
+		},
+	},
+	emits: [
+		'vote',
+	],
+	setup(props, { emit }) {
+		const isLightboxOpen = ref(false);
+
+		const TRUNCATION_LIMIT = 110;
+
+		const {
+			backgroundImageUrl,
+			description,
+		} = toRefs(props);
+
+		const cssProps = computed(() => {
+			return {
+				'--background-image-voting-card': `url(${backgroundImageUrl.value})`,
+			};
+		});
+
+		const isTruncated = computed(() => {
+			return description?.value && (description?.value.length > TRUNCATION_LIMIT);
+		});
+
+		const truncatedDescription = computed(() => {
+			if (isTruncated.value) {
+				return `${description.value.substring(0, TRUNCATION_LIMIT)}...`;
+			}
+			return description.value;
+		});
+		return {
+			cssProps,
+			castVote() {
+				emit('vote');
+			},
+			isLightboxOpen,
+			isTruncated,
+			truncatedDescription,
+		};
+	},
+};
+</script>
+
+<style lang="postcss">
+.vote_card {
+	background-image:
+    linear-gradient(180deg, rgba(0, 0, 0, 0) 50%, rgba(0, 0, 0, 1) 100%),
+    var(--background-image-voting-card);
+	background-size: cover;
+	@apply tw-rounded tw-px-4 tw-pb-4;
+}
+</style>

package/dist/components/KvWideLoanCard.vue

@@ -0,0 +1,432 @@
+<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 }"
+		data-testid="loan-card"
+		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"
+			>
+				<component
+					:is="tag"
+					:to="readMorePath"
+					:href="readMorePath"
+					class="tw-flex"
+					aria-label="Borrower image"
+					@click.native="clickReadMore('Photo', $event)"
+				>
+					<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.native="clickReadMore('Tag', $event)"
+			>
+				<kv-loan-tag
+					v-if="showTags && !isLoading"
+					:loan="loan"
+				/>
+			</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.native="clickReadMore('Progress', $event)"
+				>
+					<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"
+					:enable-huge-amount="enableHugeAmount"
+					:is-visitor="isVisitor"
+					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', $event)"
+				/>
+			</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: () => ([]),
+		},
+		enableHugeAmount: {
+			type: Boolean,
+			default: false,
+		},
+	},
+	setup(props, { emit }) {
+		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,
+		} = loanCardMethods(props, emit);
+
+		return {
+			allDataLoaded,
+			borrowerName,
+			city,
+			countryName,
+			distributionModel,
+			formattedLocation,
+			fundraisingPercent,
+			hasProgressData,
+			imageHash,
+			isLoading,
+			loanAmount,
+			loanBorrowerCount,
+			loanCallouts,
+			loanStatus,
+			loanUse,
+			mdiMapMarker,
+			readMorePath,
+			state,
+			tag,
+			unreservedAmount,
+			clickReadMore,
+		};
+	},
+	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/dist/components/stories/Forms.stories.js

@@ -0,0 +1,62 @@
+import KvCheckbox from '../KvCheckbox.vue';
+import KvRadio from '../KvRadio.vue';
+import KvSelect from '../KvSelect.vue';
+import KvSwitch from '../KvSwitch.vue';
+import KvTextInput from '../KvTextInput.vue';
+
+import { Multiple as CheckboxDefault } from './KvCheckbox.stories';
+import { Default as RadioDefault } from './KvRadio.stories';
+import { Default as SelectDefault } from './KvSelect.stories';
+import { Default as SwitchDefault } from './KvSwitch.stories';
+import { Default as TextInputDefault } from './KvTextInput.stories';
+
+export default {
+	title: 'Forms',
+	args: {
+		checked: false,
+		disabled: false,
+		placeholder: '',
+		valid: true,
+		icon: null,
+		type: 'text',
+		canClear: false,
+		value: '',
+	},
+};
+
+const Template = (args, {
+	argTypes,
+}) => ({
+	props: Object.keys(argTypes),
+	components: {
+		KvCheckbox,
+		KvRadio,
+		KvSelect,
+		KvSwitch,
+		KvTextInput,
+	},
+	data: () => ({
+		...CheckboxDefault(args, { argTypes }).data(),
+		...RadioDefault(args, { argTypes }).data(),
+		...SwitchDefault(args, { argTypes }).data(),
+		...SelectDefault(args, { argTypes }).data(),
+		...TextInputDefault(args, { argTypes }).data(),
+	}),
+	methods: {
+		...CheckboxDefault(args, { argTypes }).methods,
+		...RadioDefault(args, { argTypes }).methods,
+		...SwitchDefault(args, { argTypes }).methods,
+		...SelectDefault(args, { argTypes }).methods,
+		...TextInputDefault(args, { argTypes }).methods,
+	},
+	template: `
+		<div>
+			${CheckboxDefault(args, { argTypes }).template}<br /><br />
+			${RadioDefault(args, { argTypes }).template}<br /><br />
+			${SwitchDefault(args, { argTypes }).template}<br /><br />
+			${SelectDefault(args, { argTypes }).template}<br /><br />
+			${TextInputDefault(args, { argTypes }).template}<br /><br />
+		</div>`,
+});
+
+export const KitchenSink = Template.bind({});

package/dist/components/stories/KvAccordionItem.stories.js

@@ -0,0 +1,24 @@
+import KvAccordionItem from '../KvAccordionItem.vue';
+
+export default {
+	title: 'KvAccordionItem',
+	component: KvAccordionItem,
+};
+
+const DefaultTemplate = () => ({
+	components: { KvAccordionItem },
+	template: `
+		<div style="padding: 20px;">
+			<kv-accordion-item id="accordian-test">
+				<template #header>
+					<h2>Accordion</h2>
+				</template>
+				<p>
+					"Hello, KvAccordion Contents!"
+				</p>
+			</kv-accordion-item>
+		</div>
+	`,
+});
+
+export const Default = DefaultTemplate.bind({});

package/dist/components/stories/KvActivityRow.stories.js

@@ -0,0 +1,25 @@
+import KvActivityRow from '../KvActivityRow.vue';
+
+export default {
+	title: 'KvActivityRow',
+	component: KvActivityRow,
+};
+
+const activity = {
+	lenderName: 'Stephanie',
+	lenderImage: 'https://www.development.kiva.org/img/s100/26e15431f51b540f31cd9f011cc54f31.jpg',
+	text: 'Stephanie lent $25',
+};
+
+const story = (args) => {
+	const template = (_args, { argTypes }) => ({
+		props: Object.keys(argTypes),
+		components: { KvActivityRow },
+		template: `<KvActivityRow
+			:activity="activity" />`,
+	});
+	template.args = args;
+	return template;
+};
+
+export const Default = story({ activity });