From 529168554359b7806822599d9ef363c07542b3ca Mon Sep 17 00:00:00 2001
From: Rachel Marconi <dec11rll@gmail.com>
Date: Fri, 26 Jul 2024 18:27:06 -0400
Subject: [PATCH] add IconLibrary docs and components

---
 src/lib/IconLibrary/IconClose.svelte          | 28 ++++++
 src/lib/IconLibrary/IconLibrary.docs.mdx      | 85 +++++++++++++++++++
 .../IconLibrary/IconLibrary.stories.svelte    | 59 +++++++++++++
 src/lib/IconLibrary/IconMinus.svelte          | 25 ++++++
 src/lib/IconLibrary/IconPlus.svelte           | 25 ++++++
 src/lib/IconLibrary/IconPlusMinus.svelte      | 63 ++++++++++++++
 src/lib/IconLibrary/IconSearch.svelte         | 28 ++++++
 7 files changed, 313 insertions(+)
 create mode 100644 src/lib/IconLibrary/IconClose.svelte
 create mode 100644 src/lib/IconLibrary/IconLibrary.docs.mdx
 create mode 100644 src/lib/IconLibrary/IconLibrary.stories.svelte
 create mode 100644 src/lib/IconLibrary/IconMinus.svelte
 create mode 100644 src/lib/IconLibrary/IconPlus.svelte
 create mode 100644 src/lib/IconLibrary/IconPlusMinus.svelte
 create mode 100644 src/lib/IconLibrary/IconSearch.svelte

diff --git a/src/lib/IconLibrary/IconClose.svelte b/src/lib/IconLibrary/IconClose.svelte
new file mode 100644
index 00000000..35c81cdb
--- /dev/null
+++ b/src/lib/IconLibrary/IconClose.svelte
@@ -0,0 +1,28 @@
+<script>
+  /**
+   * The width and height dimension for the icon
+   * @type {number} [size = 40]
+   */
+  export let size = 40;
+
+  /**
+   * The color to fill the icon
+   * @type {string} [fill = "#000"]
+   */
+  export let fill = "#000";
+</script>
+
+<svg
+  width={size}
+  height={size}
+  viewBox="0 0 48 48"
+  fill="none"
+  xmlns="http://www.w3.org/2000/svg"
+  role="img"
+  aria-label="Close icon"
+>
+  <path
+    d="M29.5351 24L47.5624 42.0273C47.8469 42.3993 47.9781 42.815 47.9781 43.2744C47.9781 43.7338 47.8469 44.1057 47.5624 44.3902L44.3683 47.5843C44.0839 47.8687 43.7119 48 43.2525 48C42.7931 48 42.3774 47.8687 42.0055 47.5843L23.9781 29.557L5.95078 47.5843C5.57885 47.8687 5.16317 48 4.70374 48C4.2443 48 3.87238 47.8687 3.58797 47.5843L0.393801 44.3902C0.131267 44.1057 0 43.7338 0 43.2744C0 42.815 0.131267 42.3993 0.415679 42.0273L18.443 24L0.415679 5.97265C0.131267 5.60073 0 5.18505 0 4.72562C0 4.26618 0.131267 3.89426 0.415679 3.60985L3.60985 0.415679C3.89426 0.131267 4.2443 0 4.72562 0C5.20693 0 5.60073 0.131267 5.97265 0.415679L24 18.443L42.0273 0.415679C42.3993 0.131267 42.815 0 43.2744 0C43.7338 0 44.1057 0.131267 44.3902 0.415679L47.5843 3.60985C47.8687 3.89426 48 4.26618 48 4.72562C48 5.18505 47.8687 5.60073 47.5843 5.97265L29.5351 24Z"
+    {fill}
+  />
+</svg>
diff --git a/src/lib/IconLibrary/IconLibrary.docs.mdx b/src/lib/IconLibrary/IconLibrary.docs.mdx
new file mode 100644
index 00000000..b58fca2e
--- /dev/null
+++ b/src/lib/IconLibrary/IconLibrary.docs.mdx
@@ -0,0 +1,85 @@
+import * as IconStories from "./IconLibrary.stories.svelte";
+import { Meta, Title, Canvas, Controls, IconGallery, IconItem } from "@storybook/blocks";
+
+<Meta title="Components/IconLibrary" of={IconStories} />
+
+# Icons
+
+Any of these icons can be pulled in as standalone components. They are intended as decorations, and do not include `onClick` parameters.
+
+## Options
+
+<IconGallery>
+  <IconItem name="<IconPlus/>">
+    <svg
+      width="40"
+      height="40"
+      viewBox="0 0 48 48"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+      role="img"
+      aria-label="Plus icon"
+    >
+      <path d="M0 27V21H48V27H0Z M28 48H22L22 2.62268e-07L28 0L28 48Z" fill="#000" />
+    </svg>
+  </IconItem>
+  <IconItem name="<IconMinus/>">
+    <svg
+      width="40"
+      height="40"
+      viewBox="0 0 48 48"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+      role="img"
+      aria-label="Minus icon"
+    >
+      <path d="M0 27V21H48V27H0Z" fill="#000" />
+    </svg>
+  </IconItem>
+  <IconItem name="<IconClose/>">
+    <svg
+      width="40"
+      height="40"
+      viewBox="0 0 48 48"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+      role="img"
+      aria-label="Close icon"
+    >
+      <path
+        d="M29.5351 24L47.5624 42.0273C47.8469 42.3993 47.9781 42.815 47.9781 43.2744C47.9781 43.7338 47.8469 44.1057 47.5624 44.3902L44.3683 47.5843C44.0839 47.8687 43.7119 48 43.2525 48C42.7931 48 42.3774 47.8687 42.0055 47.5843L23.9781 29.557L5.95078 47.5843C5.57885 47.8687 5.16317 48 4.70374 48C4.2443 48 3.87238 47.8687 3.58797 47.5843L0.393801 44.3902C0.131267 44.1057 0 43.7338 0 43.2744C0 42.815 0.131267 42.3993 0.415679 42.0273L18.443 24L0.415679 5.97265C0.131267 5.60073 0 5.18505 0 4.72562C0 4.26618 0.131267 3.89426 0.415679 3.60985L3.60985 0.415679C3.89426 0.131267 4.2443 0 4.72562 0C5.20693 0 5.60073 0.131267 5.97265 0.415679L24 18.443L42.0273 0.415679C42.3993 0.131267 42.815 0 43.2744 0C43.7338 0 44.1057 0.131267 44.3902 0.415679L47.5843 3.60985C47.8687 3.89426 48 4.26618 48 4.72562C48 5.18505 47.8687 5.60073 47.5843 5.97265L29.5351 24Z"
+        fill="#000"
+      />
+    </svg>
+  </IconItem>
+  <IconItem name="<IconSearch/>">
+    <svg
+      width="40"
+      height="40"
+      viewBox="0 0 48 48"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+      role="img"
+      aria-label="Search icon"
+    >
+      <path
+        d="M47.719 43.963C47.9113 44.1553 48 44.4067 48 44.7172C48 45.0277 47.9113 45.3087 47.719 45.5601L45.5601 47.6303C45.3087 47.8817 45.0277 48 44.7172 48C44.4067 48 44.1553 47.8817 43.963 47.6303L32.5323 36.2884C32.3401 36.037 32.2514 35.7856 32.2514 35.5342V34.2181C30.5065 35.7116 28.5397 36.8946 26.3512 37.7375C24.1627 38.5804 21.8854 39.0092 19.5046 39.0092C15.9408 39.0092 12.6728 38.1368 9.70055 36.3771C6.72828 34.6322 4.37708 32.2662 2.61738 29.2939C0.872458 26.3216 0 23.0684 0 19.5046C0 15.9408 0.872458 12.6728 2.63216 9.71534C4.37708 6.74307 6.74307 4.39187 9.71534 2.63216C12.6728 0.872458 15.9408 0 19.5046 0C23.0684 0 26.3364 0.872458 29.2939 2.63216C32.2662 4.37708 34.6174 6.74307 36.3771 9.71534C38.122 12.6876 39.0092 15.9556 39.0092 19.5046C39.0092 21.8854 38.5804 24.1627 37.7375 26.3512C36.8946 28.5397 35.7264 30.5065 34.2181 32.2514H35.5342C35.8447 32.2514 36.0961 32.3401 36.2884 32.5323L47.719 43.963ZM19.5046 34.4991C22.1959 34.4991 24.695 33.8336 27.0018 32.488C29.3087 31.1423 31.1423 29.3087 32.488 27.0018C33.8336 24.695 34.4991 22.1959 34.4991 19.5046C34.4991 16.8133 33.8336 14.3142 32.488 12.0074C31.1423 9.70055 29.3087 7.86691 27.0018 6.52126C24.695 5.1756 22.1811 4.49538 19.5046 4.49538C16.8133 4.49538 14.3142 5.16081 12.0074 6.50647C9.70055 7.85213 7.86691 9.68577 6.52126 11.9926C5.1756 14.2994 4.51017 16.7985 4.51017 19.4898C4.51017 22.1811 5.1756 24.6802 6.52126 26.9871C7.86691 29.2939 9.70055 31.1275 12.0074 32.4732C14.3142 33.8189 16.8133 34.4991 19.5046 34.4991Z"
+        fill="#000"
+      />
+    </svg>
+  </IconItem>
+</IconGallery>
+
+## Default
+
+<Canvas of={IconStories.Default} />
+
+<Controls />
+
+## With color change
+
+<Canvas of={IconStories.WithColor} />
+
+## With size change
+
+<Canvas of={IconStories.ChangingSize} />
diff --git a/src/lib/IconLibrary/IconLibrary.stories.svelte b/src/lib/IconLibrary/IconLibrary.stories.svelte
new file mode 100644
index 00000000..648af31a
--- /dev/null
+++ b/src/lib/IconLibrary/IconLibrary.stories.svelte
@@ -0,0 +1,59 @@
+<script context="module">
+  import IconPlus from "./IconPlus.svelte";
+
+  export const meta = {
+    title: "Components/IconLibrary",
+    description:
+      "Any of these icons can be pulled in as standalone components. They are intended as decorations, and do not include `onClick` parameters. ",
+    component: IconPlus,
+    //tags: ["autodocs"],
+    argTypes: {
+      size: {
+        default: 40
+      },
+      fill: {
+        control: {
+          type: "color",
+          presetColors: ["#000", "#1696D2", "#fbdf11"]
+        }
+      }
+    },
+    parameters: {
+      backgrounds: {
+        default: "light",
+        values: [
+          { name: "light", value: "#ffffff" },
+          { name: "dark", value: "#0A4C6A" }
+        ]
+      },
+      docs: {
+        description: {
+          component:
+            "Any of these icons can be pulled in as standalone components. They are intended as decorations, and do not include `onClick` parameters. "
+        }
+      },
+      githubLink: {
+        url: "/IconLibrary/IconPlus.svelte"
+      }
+    }
+  };
+</script>
+
+<script>
+  import { Story, Template } from "@storybook/addon-svelte-csf";
+  import urbanColors from "$lib/utils/urbanColors.js";
+</script>
+
+<Template let:args>
+  <IconPlus {...args} />
+</Template>
+
+<Story name="Default" />
+
+<Story name="WithColor">
+  <IconPlus fill={urbanColors.blue} />
+</Story>
+
+<Story name="ChangingSize">
+  <IconPlus size={65} />
+</Story>
diff --git a/src/lib/IconLibrary/IconMinus.svelte b/src/lib/IconLibrary/IconMinus.svelte
new file mode 100644
index 00000000..e4e8e367
--- /dev/null
+++ b/src/lib/IconLibrary/IconMinus.svelte
@@ -0,0 +1,25 @@
+<script>
+  /**
+   * The width and height dimension for the icon
+   * @type {number} [size = 40]
+   */
+  export let size = 40;
+
+  /**
+   * The color to fill the icon
+   * @type {string} [fill = "#000"]
+   */
+  export let fill = "#000";
+</script>
+
+<svg
+  width={size}
+  height={size}
+  viewBox="0 0 48 48"
+  fill="none"
+  xmlns="http://www.w3.org/2000/svg"
+  role="img"
+  aria-label="Minus icon"
+>
+  <path d="M0 27V21H48V27H0Z" {fill} />
+</svg>
diff --git a/src/lib/IconLibrary/IconPlus.svelte b/src/lib/IconLibrary/IconPlus.svelte
new file mode 100644
index 00000000..fec82abe
--- /dev/null
+++ b/src/lib/IconLibrary/IconPlus.svelte
@@ -0,0 +1,25 @@
+<script>
+  /**
+   * The width and height dimension for the icon
+   * @type {number} [size = 40]
+   */
+  export let size = 40;
+
+  /**
+   * The color to fill the icon
+   * @type {string} [fill = "#000"]
+   */
+  export let fill = "#000";
+</script>
+
+<svg
+  width={size}
+  height={size}
+  viewBox="0 0 48 48"
+  fill="none"
+  xmlns="http://www.w3.org/2000/svg"
+  role="img"
+  aria-label="Plus icon"
+>
+  <path d="M0 27V21H48V27H0Z M28 48H22L22 2.62268e-07L28 0L28 48Z" {fill} />
+</svg>
diff --git a/src/lib/IconLibrary/IconPlusMinus.svelte b/src/lib/IconLibrary/IconPlusMinus.svelte
new file mode 100644
index 00000000..1ab71e55
--- /dev/null
+++ b/src/lib/IconLibrary/IconPlusMinus.svelte
@@ -0,0 +1,63 @@
+<script>
+  /**
+   * True if the icon displays as a plus, for example if content is collapsed
+   * @type {boolean} [plusModeActivated = true]
+   */
+  export let plusModeActivated = true;
+
+  /**
+   * An optional custom click handler to be called when any share button is clicked
+   * If set externally, toggle plusModeActivated
+   * @param {import("svelte").ComponentEvents<This>} evt - A Svelte component event
+   * @returns {void}
+   */
+  export let onClick = function (evt) {
+    plusModeActivated = !plusModeActivated;
+  };
+
+  /**
+   * The height and width dimensions of the activated plus
+   * @type {number} [size = 40]
+   */
+  export let size = 40;
+
+  /**
+   * How wide each bar of the plus is
+   * @type {number} [barWidth = 5]
+   */
+  let barWidth = 5;
+
+  $: width = size;
+  $: height = size;
+</script>
+
+<button
+  class="container"
+  style="width: {width}px; height: {height}px; --bar-width: {barWidth}px;"
+  on:click={(evt) => onClick(evt)}
+>
+  <div class="bar {plusModeActivated ? 'upright' : ''}" />
+  <div class="bar" />
+</button>
+
+<style>
+  .container {
+    position: relative;
+    background-color: var(--color-white);
+    border: none;
+    margin: 0;
+    padding: 0;
+  }
+  .bar {
+    position: absolute;
+    width: 100%;
+    height: var(--bar-width);
+    background-color: var(--color-black);
+    left: 0;
+    top: calc(50% - calc(var(--bar-width) / 2));
+    transition: 300ms;
+  }
+  .upright {
+    transform: rotate(-90deg);
+  }
+</style>
diff --git a/src/lib/IconLibrary/IconSearch.svelte b/src/lib/IconLibrary/IconSearch.svelte
new file mode 100644
index 00000000..c6f3872d
--- /dev/null
+++ b/src/lib/IconLibrary/IconSearch.svelte
@@ -0,0 +1,28 @@
+<script>
+  /**
+   * The width and height dimension for the icon
+   * @type {number} [size = 40]
+   */
+  export let size = 40;
+
+  /**
+   * The color to fill the icon
+   * @type {string} [fill = "#000"]
+   */
+  export let fill = "#000";
+</script>
+
+<svg
+  width={size}
+  height={size}
+  viewBox="0 0 48 48"
+  fill="none"
+  xmlns="http://www.w3.org/2000/svg"
+  role="img"
+  aria-label="Search icon"
+>
+  <path
+    d="M47.719 43.963C47.9113 44.1553 48 44.4067 48 44.7172C48 45.0277 47.9113 45.3087 47.719 45.5601L45.5601 47.6303C45.3087 47.8817 45.0277 48 44.7172 48C44.4067 48 44.1553 47.8817 43.963 47.6303L32.5323 36.2884C32.3401 36.037 32.2514 35.7856 32.2514 35.5342V34.2181C30.5065 35.7116 28.5397 36.8946 26.3512 37.7375C24.1627 38.5804 21.8854 39.0092 19.5046 39.0092C15.9408 39.0092 12.6728 38.1368 9.70055 36.3771C6.72828 34.6322 4.37708 32.2662 2.61738 29.2939C0.872458 26.3216 0 23.0684 0 19.5046C0 15.9408 0.872458 12.6728 2.63216 9.71534C4.37708 6.74307 6.74307 4.39187 9.71534 2.63216C12.6728 0.872458 15.9408 0 19.5046 0C23.0684 0 26.3364 0.872458 29.2939 2.63216C32.2662 4.37708 34.6174 6.74307 36.3771 9.71534C38.122 12.6876 39.0092 15.9556 39.0092 19.5046C39.0092 21.8854 38.5804 24.1627 37.7375 26.3512C36.8946 28.5397 35.7264 30.5065 34.2181 32.2514H35.5342C35.8447 32.2514 36.0961 32.3401 36.2884 32.5323L47.719 43.963ZM19.5046 34.4991C22.1959 34.4991 24.695 33.8336 27.0018 32.488C29.3087 31.1423 31.1423 29.3087 32.488 27.0018C33.8336 24.695 34.4991 22.1959 34.4991 19.5046C34.4991 16.8133 33.8336 14.3142 32.488 12.0074C31.1423 9.70055 29.3087 7.86691 27.0018 6.52126C24.695 5.1756 22.1811 4.49538 19.5046 4.49538C16.8133 4.49538 14.3142 5.16081 12.0074 6.50647C9.70055 7.85213 7.86691 9.68577 6.52126 11.9926C5.1756 14.2994 4.51017 16.7985 4.51017 19.4898C4.51017 22.1811 5.1756 24.6802 6.52126 26.9871C7.86691 29.2939 9.70055 31.1275 12.0074 32.4732C14.3142 33.8189 16.8133 34.4991 19.5046 34.4991Z"
+    {fill}
+  />
+</svg>