@kiva/kv-components 3.106.0 → 3.107.1

package/dist/components/stories/KvCommentsContainer.stories.js

@@ -0,0 +1,42 @@
+import KvCommentsContainer from '../KvCommentsContainer.vue';
+import { publicLenderId, comments } from '../../tests/fixtures/mockCommentsData';
+
+export default {
+	title: 'KvCommentsContainer',
+	component: KvCommentsContainer,
+};
+
+const TEST_USER_NAME = 'Jess';
+const TEST_USER_IMAGE = 'https://www-0.development.kiva.org/img/s100/6b1a24092be3aaa22216874e644a4acf.jpg';
+
+const story = (args) => {
+	const template = (templateArgs, { argTypes }) => ({
+		props: Object.keys(argTypes),
+		components: { KvCommentsContainer },
+		setup() { return { args: templateArgs }; },
+		provide: {
+			fetchLenderInfo: () => Promise.resolve({
+				name: TEST_USER_NAME,
+				image: { url: TEST_USER_IMAGE },
+			}),
+		},
+		template: `
+			<div style="max-width: 800px;">
+				<KvCommentsContainer v-bind="args" />
+			</div>
+		`,
+	});
+	template.args = args;
+	return template;
+};
+
+export const Default = story({ comments });
+
+export const UserData = story(
+	{
+		comments,
+		userDisplayName: TEST_USER_NAME,
+		userImageUrl: TEST_USER_IMAGE,
+		userPublicId: publicLenderId,
+	},
+);

package/dist/components/stories/KvCommentsHeartButton.stories.js

@@ -0,0 +1,25 @@
+import KvCommentsHeartButton from '../KvCommentsHeartButton.vue';
+
+export default {
+	title: 'KvCommentsHeartButton',
+	component: KvCommentsHeartButton,
+};
+
+const story = (args) => {
+	const template = (templateArgs, { argTypes }) => ({
+		props: Object.keys(argTypes),
+		components: { KvCommentsHeartButton },
+		setup() { return { args: templateArgs }; },
+		template: `
+				<KvCommentsHeartButton v-bind="args" />
+		`,
+	});
+	template.args = args;
+	return template;
+};
+
+export const Default = story({});
+
+export const IsSmall = story({ isSmall: true });
+
+export const IsLiked = story({ isLiked: true });

package/dist/components/stories/KvCommentsList.stories.js

@@ -0,0 +1,39 @@
+import KvCommentsList from '../KvCommentsList.vue';
+import { publicLenderId, comments } from '../../tests/fixtures/mockCommentsData';
+
+export default {
+	title: 'KvCommentsList',
+	component: KvCommentsList,
+};
+const TEST_USER_NAME = 'Jess';
+const TEST_USER_IMAGE = 'https://www-0.development.kiva.org/img/s100/6b1a24092be3aaa22216874e644a4acf.jpg';
+
+const story = (args) => {
+	const template = (templateArgs, { argTypes }) => ({
+		props: Object.keys(argTypes),
+		components: { KvCommentsList },
+		setup() { return { args: templateArgs }; },
+		provide: {
+			fetchLenderInfo: () => Promise.resolve({
+				name: TEST_USER_NAME,
+				image: { url: TEST_USER_IMAGE },
+			}),
+		},
+		template: `
+			<KvCommentsList v-bind="args" />
+		`,
+	});
+	template.args = args;
+	return template;
+};
+
+export const Default = story({ comments });
+
+export const UserData = story(
+	{
+		comments,
+		userDisplayName: TEST_USER_NAME,
+		userImageUrl: TEST_USER_IMAGE,
+		userPublicId: publicLenderId,
+	},
+);

package/dist/components/stories/KvCommentsListItem.stories.js

@@ -0,0 +1,45 @@
+import KvCommentsListItem from '../KvCommentsListItem.vue';
+import { publicLenderId, comments } from '../../tests/fixtures/mockCommentsData';
+
+export default {
+	title: 'KvCommentsListItem',
+	component: KvCommentsListItem,
+};
+
+const TEST_USER_NAME = 'Jess';
+const TEST_USER_IMAGE = 'https://www-0.development.kiva.org/img/s100/6b1a24092be3aaa22216874e644a4acf.jpg';
+
+const story = (args) => {
+	const template = (templateArgs, { argTypes }) => ({
+		props: Object.keys(argTypes),
+		components: { KvCommentsListItem },
+		setup() { return { args: templateArgs }; },
+		provide: {
+			fetchLenderInfo: () => Promise.resolve({
+				name: TEST_USER_NAME,
+				image: { url: TEST_USER_IMAGE },
+			}),
+		},
+		template: `
+			<KvCommentsListItem v-bind="args" />
+		`,
+	});
+	template.args = args;
+	return template;
+};
+
+const comment = comments[0];
+const childComments = comments[0];
+
+export const Default = story({ comment });
+
+export const ChildComments = story({ comment: childComments });
+
+export const UserData = story(
+	{
+		comment: childComments,
+		userDisplayName: TEST_USER_NAME,
+		userImageUrl: TEST_USER_IMAGE,
+		userPublicId: publicLenderId,
+	},
+);

package/dist/components/stories/KvCommentsReplyButton.stories.js

@@ -0,0 +1,21 @@
+import KvCommentsReplyButton from '../KvCommentsReplyButton.vue';
+
+export default {
+	title: 'KvCommentsReplyButton',
+	component: KvCommentsReplyButton,
+};
+
+const story = (args) => {
+	const template = (templateArgs, { argTypes }) => ({
+		props: Object.keys(argTypes),
+		components: { KvCommentsReplyButton },
+		setup() { return { args: templateArgs }; },
+		template: `
+				<KvCommentsReplyButton v-bind="args" />
+		`,
+	});
+	template.args = args;
+	return template;
+};
+
+export const Default = story({});

package/dist/components/stories/KvContentfulImg.stories.js

@@ -0,0 +1,196 @@
+import KvContentfulImg from '../KvContentfulImg.vue';
+
+export default {
+	title: 'KvContentfulImg',
+	component: KvContentfulImg,
+	args: {
+		contentfulSrc: 'https://images.ctfassets.net/j0p9a6ql0rn7/35lkLRfbLxzFPlDVgA4aKI/c435630d811f9ad35ddfc88eaea22b08/Blog-import-1082518_us_shawn_16.jpg',
+		fallbackFormat: 'jpg',
+		width: 200,
+		height: null,
+		alt: null,
+		loading: 'lazy',
+		sourceSizes: null,
+	},
+	argTypes: {
+		fallbackFormat: {
+			control: {
+				type: 'select',
+				options: ['jpg', 'png', 'webp'],
+			},
+		},
+		loading: {
+			control: {
+				type: 'select',
+				options: ['lazy', 'eager'],
+			},
+		},
+		fit: {
+			control: {
+				type: 'select',
+				options: ['pad', 'fill', 'scale', 'crop', 'thumb'],
+			},
+		},
+		focus: {
+			control: {
+				type: 'select',
+				options: ['center', 'top', 'right', 'left', 'bottom', 'top_right', 'top_left', 'bottom_right', 'bottom_left', 'face', 'faces'],
+			},
+		},
+	},
+};
+
+export const Default = (args, { argTypes }) => ({
+	props: Object.keys(argTypes),
+	components: {
+		KvContentfulImg,
+	},
+	template: `
+		<kv-contentful-img
+			:contentful-src="contentfulSrc"
+			:fallback-format="fallbackFormat"
+			:width="width"
+			:height="height"
+			alt="Descriptive alt text"
+			:loading="loading"
+			:fit="fit"
+			:focus="focus"
+		/>
+	`,
+});
+
+export const ResponsiveImageSet = (args, { argTypes }) => ({
+	props: Object.keys(argTypes),
+	components: {
+		KvContentfulImg,
+	},
+	template: `
+		<kv-contentful-img
+			:contentful-src="contentfulSrc"
+			:fallback-format="fallbackFormat"
+			:alt="alt"
+			:loading="loading"
+			:height="540"
+			:source-sizes="sourceSizes"
+			:fit="fit"
+			:focus="focus"
+		/>
+	`,
+});
+
+ResponsiveImageSet.args = {
+	fit: 'fill',
+	focus: 'face',
+	sourceSizes: [
+		{
+			width: 1920,
+			height: 650,
+			media: 'min-width: 1441px',
+		},
+		{
+			width: 1440,
+			height: 620,
+			media: 'min-width: 1025px',
+		},
+		{
+			width: 1024,
+			height: 441,
+			media: 'min-width: 681px',
+		},
+		{
+			width: 680,
+			height: 372,
+			media: 'min-width: 481px',
+		},
+		{
+			width: 480,
+			height: 540,
+			media: 'min-width: 0px',
+		},
+	],
+	contentfulSrc: 'https://images.ctfassets.net/j0p9a6ql0rn7/7mY5ZujL9UfbluRkVkHgkX/5ec83a74e7c1dc387f3fa35af34f5243/mg-hppromo-1-wxga-retina.jpg',
+};
+
+export const AdaptiveImageSet = (args, { argTypes }) => ({
+	props: Object.keys(argTypes),
+	components: {
+		KvContentfulImg,
+	},
+	template: `
+		<kv-contentful-img
+			:contentful-src="contentfulSrc"
+			:fallback-format="fallbackFormat"
+			:alt="alt"
+			:loading="loading"
+			:height="540"
+			:source-sizes="sourceSizes"
+		/>
+	`,
+});
+AdaptiveImageSet.args = {
+	sourceSizes: [
+		{
+			width: 1186,
+			height: 948,
+			media: 'min-width: 1025px',
+			url: '//images.ctfassets.net/j0p9a6ql0rn7/V0FQ3TmvSVVX5zXCX9l9A/363cf644709b838f2e3478facd0a6959/wrd2021-hero-lg-2x.jpg',
+		},
+		{
+			width: 670,
+			height: 915,
+			media: 'min-width: 735px',
+			url: '//images.ctfassets.net/j0p9a6ql0rn7/2co41o2KujCSIIAIFc63DH/4fe9fe22b521a590911704e2c42a6cfc/wrd2021-hero-med-2x.jpg',
+		},
+		{
+			width: 670,
+			height: 914,
+			media: 'min-width: 0px',
+			url: '//images.ctfassets.net/j0p9a6ql0rn7/28iKvNatAphyTreO5XQM8V/70246776d7b24ddcc638af696ca10bad/wrd2021-hero-sm-2x.jpg',
+		},
+	],
+	contentfulSrc: '//images.ctfassets.net/j0p9a6ql0rn7/V0FQ3TmvSVVX5zXCX9l9A/363cf644709b838f2e3478facd0a6959/wrd2021-hero-lg-2x.jpg',
+};
+
+export const WithCaption = (args, { argTypes }) => ({
+	props: Object.keys(argTypes),
+	components: {
+		KvContentfulImg,
+	},
+	template: `
+		<kv-contentful-img
+			:contentful-src="contentfulSrc"
+			:fallback-format="fallbackFormat"
+			:width="width"
+			:height="height"
+			alt="^ A descriptive caption"
+			:loading="loading"
+			:fit="fit"
+			:focus="focus"
+		/>
+	`,
+});
+
+export const GiantImage = (args, { argTypes }) => ({
+	props: Object.keys(argTypes),
+	components: {
+		KvContentfulImg,
+	},
+	template: `
+		<kv-contentful-img
+			:contentful-src="contentfulSrc"
+			:fallback-format="fallbackFormat"
+			:width="width"
+			:height="height"
+			alt="Descriptive alt text"
+			:loading="loading"
+			:fit="fit"
+			:focus="focus"
+		/>
+	`,
+});
+
+GiantImage.args = {
+	contentfulSrc: 'https://images.ctfassets.net/j0p9a6ql0rn7/7dVINOyAxRaXM8p6aq7p5s/9213f63ff10dec57c5f740c056afe8a8/gradient-hero-bg__1_.jpg',
+	width: 4000,
+	height: 2000,
+};

package/dist/components/stories/KvCountdownTimer.stories.js

@@ -0,0 +1,30 @@
+import KvCountdownTimer from '../KvCountdownTimer.vue';
+
+export default {
+	title: 'KvCountdownTimer',
+	component: KvCountdownTimer,
+};
+
+const story = (args) => {
+	const template = (_args, { argTypes }) => ({
+		props: Object.keys(argTypes),
+		components: {
+			KvCountdownTimer,
+		},
+		template: `
+			<kv-countdown-timer
+				:ms-left="msLeft"
+			/>
+		`,
+	});
+	template.args = args;
+	return template;
+};
+
+export const Seconds = story({ msLeft: 1000 * 10 });
+
+export const Tomorrow = story({ msLeft: 1000 * 60 * 60 * 24 });
+
+export const Expired = story({ msLeft: 0 });
+
+export const Overmorrow = story({ msLeft: 1000 * 60 * 60 * 48 });

package/dist/components/stories/KvExpandableQuestion.stories.js

@@ -0,0 +1,129 @@
+import KvExpandableQuestion from '../KvExpandableQuestion.vue';
+
+export default {
+	title: 'KvExpandableQuestion',
+	component: KvExpandableQuestion,
+};
+
+const DefaultTemplate = () => ({
+	components: { KvExpandableQuestion },
+	template: `
+		<div style="padding: 20px;">
+			<kv-expandable-question
+			id="expandable-question-test"
+			title="expandable-question-title"
+			content="<p> Hello, KvAccordion Contents! </p>"
+			/>
+		</div>
+	`,
+});
+
+export const Default = DefaultTemplate.bind({});
+
+const expandableQuestions = [
+	{
+		title: 'expandable question one',
+		content: '<p> Hello, KvAccordion Contents! </p>',
+		id: 'expandable-question-test-1',
+	},
+	{
+		title: 'expandable question two',
+		content: '<p> Hello, KvAccordion Contents! </p>',
+		id: 'expandable-question-test-2',
+	},
+	{
+		title: 'expandable question three',
+		content: '<p> Hello, KvAccordion Contents! </p>',
+		id: 'expandable-question-test-3',
+	},
+];
+
+const GroupTemplate = () => ({
+	components: { KvExpandableQuestion },
+	data: () => ({
+		questions: expandableQuestions,
+	}),
+	methods: {
+		kvTrackMock(
+			category,
+			action,
+			label,
+		) {
+			console.log(category, action, label);
+		},
+	},
+	template: `
+		<div style="padding: 20px;">
+			<kv-expandable-question
+				v-for="(question, index) in questions"
+				:key="index"
+				:id="question.id"
+				:title="question.title"
+				:content="question.content"
+				:active="question.id === 'expandable-question-test-2'"
+				:kv-track-function="kvTrackMock"
+			/>
+		</div>
+	`,
+});
+
+export const ExpandableSet = GroupTemplate.bind({});
+
+const SlotContentTemplate = () => ({
+	components: { KvExpandableQuestion },
+	template: `
+		<div style="padding: 20px;">
+			<kv-expandable-question
+			id="expandable-question-test"
+			title="expandable question with slot content"
+			>
+				<p> A created slot! </p>
+			</kv-expandable-question>
+		</div>
+	`,
+});
+
+export const SlotContent = SlotContentTemplate.bind({});
+
+const ProseWrappedTemplate = () => ({
+	components: { KvExpandableQuestion },
+	template: `
+		<div class="rich-text-content tw-prose tw-whitespace-pre-wrap tw-mb-2 md:tw-mb-3" data-testid="rich-text-container">
+			<h4><!--[-->Our commitment<!--]--></h4>
+			<h2><!--[--><!--[-->100% of your loan goes toward <!--]--><!--[--><b><!--[-->supporting borrowers.<!--]--></b><!--]--><!--]--></h2>
+			<section class="tw-relative tw-w-full">
+				<div class="tw-pt-4 tw-pb-4 lg:tw-pt-8 lg:tw-pb-8 tw-relative tw-w-full tw-overflow-hidden tw-z-1 tw-top-0">
+					<div>
+						<div style="">
+							<div class="tw-divide-y tw-whitespace-normal">
+								<kv-expandable-question
+									id="expandable-question-test"
+									title="Why Lending?"
+								>
+									<p>If you needed to buy a delivery truck for your business, you probably wouldn’t ask for donations; you’d apply for a loan.</p><p>But what about the  billion people without access to traditional finance? That's where you—and Kiva—come in. Kiva loans give people the power and resources to build the life they choose. By crowdfunding smaller amounts—called microloans—we can help more borrowers get funded.</p><p>With Kiva, you can use the same dollars again and again, helping a new borrower each time your loan is repaid. Your same $25 could help someone open a salon, support a child’s education, invest in community solar panels, and so on!</p>
+								</kv-expandable-question>
+								<kv-expandable-question
+									id="expandable-question-test"
+									title="How does Kiva make money ?"
+								>
+									<p>We cover most of our operating costs through voluntary donations made by Kiva lenders. As a 501(c)3 U.S. nonprofit, the remainder of our costs are covered through grants and donations from foundations and supporters. Additionally, select lending partners contribute small platform fees as we continue building innovative technologies that help create a more financially inclusive world.</p>
+									<p>Kiva never takes a fee from lenders. 100% of funds lent on Kiva go to funding loans.</p>
+								</kv-expandable-question>
+								<kv-expandable-question
+									id="expandable-question-test"
+									title="Do Kiva borrowers pay any interest on their loans?"
+								>
+									<p>Kiva partners with microfinance institutions, nonprofits, and other organizations to disburse loans in the communities we serve.</p>
+									<p>Most borrowers do pay interest to these local lending partners to help cover their operation costs. We verify that these rates are appropriate for the region and we only choose partners who have fair, non-predatory lending practices and prioritize social good.</p>
+									<p>Some borrowers funded through Kiva do receive 0% interest loans, including most direct loans, which are loans not made through a local lending partner.</p>
+								</kv-expandable-question>
+							</div>
+						</div>
+					</div>
+				</div>
+			</section>
+		</div>
+	`,
+});
+
+export const ProseWrappedQuestion = ProseWrappedTemplate.bind({});

package/dist/components/stories/KvFlag.stories.js

@@ -0,0 +1,36 @@
+import KvFlag from '../KvFlag.vue';
+
+export default {
+	title: 'Components/KvFlag',
+	component: KvFlag,
+};
+
+const story = (args) => {
+	const template = (templateArgs, { argTypes }) => ({
+		props: Object.keys(argTypes),
+		components: { KvFlag },
+		setup() { return { args: templateArgs }; },
+		template: `
+			<div style="width: 100px; height: 100px;">
+				<KvFlag v-bind="args" />
+			</div>
+		`,
+	});
+	template.args = args;
+	return template;
+};
+
+// SVG based on the country code
+export const InlineSvg = story({ country: 'TO' });
+// SVG based on the country code with custom width
+export const InlineSvgCustomWidth = story({ country: 'DE', widthOverride: '40px' });
+
+// SVG Sqaure based on the country code
+export const SquareInlineSvg = story({ country: 'ME', aspectRatio: '1x1', showName: true });
+// SVG Sqaure based on the country code with custom width
+export const SquareInlineSvgCustomWidth = story({
+	country: 'SA',
+	inlineSvg: true,
+	widthOverride: '40px',
+	aspectRatio: '1x1',
+});

package/dist/components/stories/KvGrid.stories.js

@@ -0,0 +1,97 @@
+import KvGrid from '../KvGrid.vue';
+import KvPageContainer from '../KvPageContainer.vue';
+
+export default {
+	title: 'Layout/KvGrid',
+	component: KvGrid,
+	parameters: {
+		layout: 'fullscreen',
+	},
+};
+
+const TwelveColumnsTemplate = () => ({
+	components: { KvGrid, KvPageContainer },
+	template: `
+		<div class="demo">
+			<component is="style">
+				.demo * { outline: 1px solid red !important; }
+			</component>
+
+			<kv-page-container>
+				<h2 class="tw-mb-2">Twelve Even Columns</h2>
+				<kv-grid class="tw-grid-cols-12">
+					<div class="tw-bg-tertiary tw-h-16">1</div>
+					<div class="tw-bg-tertiary tw-h-16">2</div>
+					<div class="tw-bg-tertiary tw-h-16">3</div>
+					<div class="tw-bg-tertiary tw-h-16">4</div>
+					<div class="tw-bg-tertiary tw-h-16">5</div>
+					<div class="tw-bg-tertiary tw-h-16">6</div>
+					<div class="tw-bg-tertiary tw-h-16">7</div>
+					<div class="tw-bg-tertiary tw-h-16">8</div>
+					<div class="tw-bg-tertiary tw-h-16">9</div>
+					<div class="tw-bg-tertiary tw-h-16">10</div>
+					<div class="tw-bg-tertiary tw-h-16">11</div>
+					<div class="tw-bg-tertiary tw-h-16">12</div>
+				</kv-grid>
+			</kv-page-container>
+		</div>`,
+});
+
+const ResponsiveColumnsTemplate = () => ({
+	components: { KvGrid, KvPageContainer },
+	template: `
+		<div class="demo">
+			<component is="style">
+				.demo * { outline: 1px solid red !important; }
+			</component>
+
+			<kv-page-container>
+				<h2 class="tw-mb-2">Two on small, 3 on medium, 4 on large</h2>
+				<kv-grid class="tw-grid-cols-2 md:tw-grid-cols-3 lg:tw-grid-cols-4">
+					<div class="tw-bg-tertiary tw-h-16">1</div>
+					<div class="tw-bg-tertiary tw-h-16">2</div>
+					<div class="tw-bg-tertiary tw-h-16">3</div>
+					<div class="tw-bg-tertiary tw-h-16">4</div>
+					<div class="tw-bg-tertiary tw-h-16">5</div>
+					<div class="tw-bg-tertiary tw-h-16">6</div>
+					<div class="tw-bg-tertiary tw-h-16">7</div>
+					<div class="tw-bg-tertiary tw-h-16">8</div>
+					<div class="tw-bg-tertiary tw-h-16">9</div>
+					<div class="tw-bg-tertiary tw-h-16">10</div>
+					<div class="tw-bg-tertiary tw-h-16">11</div>
+					<div class="tw-bg-tertiary tw-h-16">12</div>
+				</kv-grid>
+			</kv-page-container>
+		</div>`,
+});
+
+const NestedTemplate = () => ({
+	components: { KvGrid, KvPageContainer },
+	template: `
+		<div class="demo">
+			<component is="style">
+				.demo * { outline: 1px solid red !important; }
+			</component>
+
+			<kv-page-container>
+				<h2 class="tw-mb-2">Nested</h2>
+				<kv-grid class="tw-grid-cols-2">
+					<div class="tw-bg-tertiary"><p>1</p></div>
+					<div class="tw-bg-tertiary">
+						<p>2</p>
+						<p>The grid below is inside a grid column</p>
+						<kv-grid class="tw-grid-cols-4">
+							<div class="tw-bg-tertiary tw-h-16">1</div>
+							<div class="tw-bg-tertiary tw-h-16">2</div>
+							<div class="tw-bg-tertiary tw-h-16">3</div>
+							<div class="tw-bg-tertiary tw-h-16">4</div>
+						</kv-grid>
+					</div>
+				</kv-grid>
+			</kv-page-container>
+		</div>`,
+});
+
+export const TwelveColumns = TwelveColumnsTemplate.bind({});
+export const ResponsiveColumns = ResponsiveColumnsTemplate.bind({});
+export const Nested = NestedTemplate.bind({});

package/dist/components/stories/KvImpactDashboardHeader.stories.js

@@ -0,0 +1,22 @@
+import KvImpactDashboardHeader from '../KvImpactDashboardHeader.vue';
+
+export default {
+	title: 'KvImpactDashboardHeader',
+	component: KvImpactDashboardHeader,
+};
+
+const story = (args) => {
+	const template = (_args, { argTypes }) => ({
+		props: Object.keys(argTypes),
+		components: { KvImpactDashboardHeader },
+		template: `
+			<div class="tw-bg-secondary tw-pb-7">
+				<kv-impact-dashboard-header />
+			</div>
+		`,
+	});
+	template.args = args;
+	return template;
+};
+
+export const Default = story();