@onsvisual/svelte-components 0.0.2 → 0.0.4

package/dist/decorators/Blockquote/Blockquote.svelte

@@ -0,0 +1,27 @@
+<script>
+  /**
+   * (Optional) attribution for the quote. If you leave this blank, you will just get an indented text block.
+   * @type {string}
+   */
+  export let attribution = "";
+</script>
+
+<blockquote class="ons-quote">
+  {#if attribution}
+    <svg
+      class="ons-svg-icon"
+      viewBox="0 0 14 10"
+      xmlns="http://www.w3.org/2000/svg"
+      focusable="false"
+      fill="currentColor"
+    >
+      <path
+        d="M13.44.77h-3l-2 4v6h6v-6h-3l2-4zm-8 0h-3l-2 4v6h6v-6h-3l2-4z"
+        transform="translate(-0.44 -0.77)"></path>
+    </svg>
+    <span class="ons-quote__text ons-u-fs-l"><slot /></span>
+    <span class="ons-quote__ref">&mdash; {attribution}</span>
+  {:else}
+    <span class="ons-quote__text ons-u-fs-l"><slot /></span>
+  {/if}
+</blockquote>

package/dist/index.js

@@ -1,15 +1,17 @@
+// Wrappers
+export { default as Theme } from "./wrappers/Theme/Theme.svelte";
+export { default as Container } from "./wrappers/Container/Container.svelte";
+
 // Layout
-export { default as Accordion } from "./components/layout/Accordion/Accordion.svelte";
-export { default as Container } from "./components/layout/Container/Container.svelte";
-export { default as Footer } from "./components/layout/Footer/Footer.svelte";
-export { default as Header } from "./components/layout/Header/Header.svelte";
-export { default as Theme } from "./components/layout/Theme/Theme.svelte";
-export { default as Twisty } from "./components/layout/Twisty/Twisty.svelte";
+export { default as Accordion } from "./layout/Accordion/Accordion.svelte";
+export { default as Footer } from "./layout/Footer/Footer.svelte";
+export { default as Header } from "./layout/Header/Header.svelte";
+export { default as Twisty } from "./layout/Twisty/Twisty.svelte";
 
-// UI
-export { default as Button } from "./components/ui/Button/Button.svelte";
-export { default as Dropdown } from "./components/ui/Dropdown/Dropdown.svelte";
-export { default as Em } from "./components/ui/Em/Em.svelte";
-export { default as Input } from "./components/ui/Input/Input.svelte";
-export { default as Select } from "./components/ui/Select/Select.svelte";
-export { default as Textarea } from "./components/ui/Textarea/Textarea.svelte";
+// Inputs
+export { default as Button } from "./inputs/Button/Button.svelte";
+export { default as Dropdown } from "./inputs/Dropdown/Dropdown.svelte";
+export { default as Em } from "./decorators/Em/Em.svelte";
+export { default as Input } from "./inputs/Input/Input.svelte";
+export { default as Select } from "./inputs/Select/Select.svelte";
+export { default as Textarea } from "./inputs/Textarea/Textarea.svelte";

package/dist/js/docsPage.js

@@ -0,0 +1,13 @@
+export const parameters = {
+  viewMode: "docs",
+  previewTabs: {
+    canvas: { hidden: true },
+  },
+  toolbar: {
+    zoom: { hidden: true },
+    eject: { hidden: true },
+    fullscreen: { hidden: true },
+    "storybook/background": { hidden: true },
+    "storybook/outline": { hidden: true },
+  },
+};

package/dist/js/utils.js

@@ -15,7 +15,9 @@ export const slugify = (str, suffix = true) =>
 // .concat(suffix ? `-${randomString()}` : "");
 
 export const validDate = (str) => {
+  if (!str) return false;
   const date = new Date(str);
+  // @ts-ignore
   return !isNaN(date);
 };
 
@@ -25,6 +27,7 @@ export const formatDate = (
   opts = { year: "numeric", month: "long", day: "2-digit" }
 ) => {
   const date = new Date(str);
+  // @ts-ignore
   return date.toLocaleDateString(locale, opts);
 };
 

package/dist/js/withParams.js

@@ -0,0 +1,46 @@
+/**
+ * Use custom source code in the "Show code" pull down.
+ * @param {object} source Source code object, where key is the language of the source code and value is the code string.
+ * @param {object} otherOptions Other props object options, allowing chaining with other methods like withStoryDocs
+ * @returns props object including parameters
+ */
+export const withSource = (source, otherOptions = {}) => {
+  const language = Object.keys(source)[0];
+  const code = source[language];
+  const docs = {
+    ...otherOptions?.parameters?.docs,
+    source: { code, language },
+  };
+  const parameters = { docs };
+  return { parameters };
+};
+
+/**
+ * Add custom documentation to a story.
+ * @param {string} storyDocs Markdown string of docs
+ * @param {object} otherOptions Other props object options, allowing chaining with other methods like withSource
+ * @returns props object including parameters
+ */
+export const withStoryDocs = (storyDocs, otherOptions = {}) => {
+  const docs = {
+    ...otherOptions?.parameters?.docs,
+    description: { story: storyDocs },
+  };
+  const parameters = { docs };
+  return { parameters };
+};
+
+/**
+ * Add custom documentation to the top of the component docs page.
+ * @param {string} componentDocs Markdown string of docs
+ * @param {object} otherOptions Other props object options, allowing chaining with other methods like withSource
+ * @returns props object including parameters
+ */
+export const withComponentDocs = (componentDocs, otherOptions = {}) => {
+  const docs = {
+    ...otherOptions?.parameters?.docs,
+    description: { component: componentDocs },
+  };
+  const parameters = { docs };
+  return { parameters };
+};

package/dist/{components/layout → layout}/Accordion/AccordionItem.svelte

@@ -1,6 +1,6 @@
 <script>
   import { onMount, getContext } from "svelte";
-  import { slugify } from "../../../js/utils";
+  import { slugify } from "$lib/js/utils.js";
 
   /**
    * A title for the element

package/dist/layout/Divider/Divider.svelte

@@ -0,0 +1,53 @@
+<script>
+  import Container from "$lib/wrappers/Container/Container.svelte";
+
+  /**
+   * (Optional) Include a horizontal rule
+   * @type {boolean}
+   */
+  export let hr = true;
+  /**
+   * Sets the width of the container
+   * @type {"narrow"|"medium"|"wide"|"full"}
+   */
+  export let width = "medium";
+  /**
+   * Sets a predefined theme
+   * @type {"light"|"dark"|"lightblue"}
+   */
+  export let theme = null;
+  /**
+   * Define additional props to override the base theme
+   * @type {object}
+   */
+  export let themeOverrides = null;
+  /**
+   * Optional margin above section
+   * @type {boolean}
+   */
+  export let marginTop = false;
+  /**
+   * Optional margin below section
+   * @type {boolean}
+   */
+  export let marginBottom = true;
+</script>
+
+<Container
+  theme="{theme}"
+  themeOverrides="{themeOverrides}"
+  width="{width}"
+  marginTop="{marginTop}"
+  marginBottom="{marginBottom}"
+>
+  <hr style:border="{hr ? null : "none"}" />
+</Container>
+
+<style>
+  hr {
+    width: 75px;
+    border: none;
+    border-top: 2px solid;
+    margin: -10px auto 0;
+    color: var(--muted, #777);
+  }</style>

package/dist/layout/Filler/Filler.svelte

@@ -0,0 +1,66 @@
+<script>
+  import Container from "$lib/wrappers/Container/Container.svelte";
+
+  /**
+   * (Optional) Sets the unique ID of the section
+   * @type {string}
+   */
+  export let id = null;
+  /**
+   * Sets the width of the section
+   * @type {"narrow"|"medium"|"wide"|"full"}
+   */
+  export let width = "narrow";
+  /**
+   * Sets the minimum height of the section
+   * @type {"auto"|"tall"|"full"}
+   */
+  export let height = "tall";
+  /**
+   * Sets a predefined theme
+   * @type {"light"|"dark"|"lightblue"}
+   */
+  export let theme = "lightblue";
+  /**
+   * Define additional props to override the base theme
+   * @type {object}
+   */
+  export let themeOverrides = null;
+  /**
+   * Overrides the background CSS for the section
+   * @type {string}
+   */
+  export let background = null;
+  /**
+   * Optional margin above section
+   * @type {boolean}
+   */
+  export let marginTop = false;
+  /**
+   * Optional margin below section
+   * @type {boolean}
+   */
+  export let marginBottom = true;
+</script>
+
+<Container
+  theme="{theme}"
+  themeOverrides="{themeOverrides}"
+  width="{width}"
+  background="{background}"
+  marginTop="{marginTop}"
+  marginBottom="{marginBottom}"
+  height="{height}"
+>
+  <section
+    class="ons-hero__details ons-feature__filler ons-u-fs-l ons-font-weight__normal"
+    id="{id}"
+  >
+    <slot />
+  </section>
+</Container>
+
+<style>
+  :global(.ons-feature__filler > p + p) {
+    margin-top: 30px;
+  }</style>

package/dist/{components/layout → layout}/Footer/Footer.svelte

@@ -1,6 +1,6 @@
 <script>
   import { onMount, getContext } from "svelte";
-  import Theme from "../Theme/Theme.svelte";
+  import Theme from "$lib/wrappers/Theme/Theme.svelte";
 
   const page = getContext("page");
 

package/dist/layout/Grid/Grid.svelte

@@ -0,0 +1,111 @@
+<script>
+  import Container from "$lib/wrappers/Container/Container.svelte";
+
+  /**
+   * (Optional) Sets the unique ID of the section
+   * @type {string}
+   */
+  export let id = null;
+  /**
+   * Sets the width of the section
+   * @type {"narrow"|"medium"|"wide"|"full"}
+   */
+  export let width = "medium";
+  /**
+   * Sets a predefined theme
+   * @type {"light"|"dark"|"lightblue"}
+   */
+  export let theme = null;
+  /**
+   * Define additional props to override the base theme
+   * @type {object}
+   */
+  export let themeOverrides = null;
+  /**
+   * Optional margin above section
+   * @type {boolean}
+   */
+  export let marginTop = false;
+  /**
+   * Optional margin below section
+   * @type {boolean}
+   */
+  export let marginBottom = true;
+  /**
+   * Sets the width of the section
+   * @type {"narrow"|"medium"|"wide"|"full"}
+   */
+  export let colwidth = "medium"; // narrow | medium | wide | full
+  /**
+   * (Optional) caption below the grid
+   * @type {string}
+   */
+  export let caption = "";
+  /**
+   * Set the minimum height of a grid row (can be a number in pixels, or a valid CSS height, like "100vh")
+   * @type {number|string}
+   */
+  export let height = 200; // pixel height or "full" for 100vh
+  /**
+   * Set the grid gap, in pixels
+   * @type {number}
+   */
+  export let gap = 12;
+
+  let gridClass = !colwidth || colwidth === "full" ? "" : `grid-${colwidth}`;
+  let rowHeight = height === "full" ? "100vh" : !Number.isNaN(height) ? height + "px" : height;
+  let gridGap = !Number.isNaN(gap) ? gap + "px" : gap;
+</script>
+
+<figure id="{id}" aria-label="{caption}">
+  <Container
+    theme="{theme}"
+    themeOverrides="{themeOverrides}"
+    width="{width}"
+    height="{['tall', 'full'].includes(height) ? height : 'auto'}"
+    marginTop="{marginTop}"
+    marginBottom="{!caption ? marginBottom : false}"
+  >
+    <div class="grid {gridClass}" style:grid-gap="{gridGap}" style:min-height="{rowHeight}">
+      <slot />
+    </div>
+  </Container>
+  {#if caption}
+    <figcaption>
+      <Container
+        theme="{theme}"
+        themeOverrides="{themeOverrides}"
+        width="narrow"
+        marginBottom="{marginBottom}"
+      >
+        <span class="ons-figure__caption">{@html caption}</span>
+      </Container>
+    </figcaption>
+  {/if}
+</figure>
+
+<style>
+  figure,
+  figcaption {
+    display: block;
+    margin: 0;
+    padding: 0;
+  }
+  .grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, 100%);
+    width: 100%;
+    margin: 0;
+  }
+  .grid-narrow {
+    grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)) !important;
+  }
+  .grid-medium {
+    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)) !important;
+  }
+  .grid-wide {
+    grid-template-columns: repeat(auto-fit, minmax(460px, 1fr)) !important;
+  }
+  :global(.grid > div) {
+    min-height: inherit;
+  }</style>

package/dist/{components/layout → layout}/Header/Header.svelte

@@ -1,6 +1,6 @@
 <script>
   import { onMount, getContext } from "svelte";
-  import Theme from "../Theme/Theme.svelte";
+  import Theme from "$lib/wrappers/Theme/Theme.svelte";
   import ONSLogo from "./ONSLogo.svelte";
 
   const page = getContext("page");

package/dist/layout/Hero/Hero.svelte

@@ -0,0 +1,74 @@
+<script>
+  import { validDate, formatDate } from "$lib/js/utils.js";
+  import Container from "$lib/wrappers/Container/Container.svelte";
+
+  /**
+   * (Optional) Sets the unique ID of the section
+   * @type {string}
+   */
+  export let id = null;
+  /**
+   * Sets the width of the section
+   * @type {"narrow"|"medium"|"wide"|"full"}
+   */
+  export let width = "medium";
+  /**
+   * Sets the minimum height of the section
+   * @type {"auto"|"tall"|"full"}
+   */
+  export let height = "tall";
+  /**
+   * Sets the title/headline
+   * @type {string}
+   */
+  export let title = "Page headline";
+  /**
+   * Sets the lede (short intro text)
+   * @type {string}
+   */
+  export let lede = "";
+  /**
+   * (Optional) Sets the date, using the format "yyyy-mm-dd"
+   * @type {string}
+   */
+  export let date = null;
+  /**
+   * Sets a predefined theme
+   * @type {"light"|"dark"|"lightblue"}
+   */
+  export let theme = "dark";
+  /**
+   * Define additional props to override the base theme
+   * @type {object}
+   */
+  export let themeOverrides = null;
+  /**
+   * Overrides the background CSS for the section
+   * @type {string}
+   */
+  export let background = "rgb(32, 96, 149)";
+</script>
+
+<Container
+  theme="{theme}"
+  themeOverrides="{themeOverrides}"
+  width="{width}"
+  background="{background}"
+  height="{height}"
+>
+  <div id="{id}" class="ons-hero__details ons-grid__col ons-col-8@m ons-col-10@s@m">
+    {#if title}
+      <header>
+        <h1 class="ons-hero__title ons-u-fs-xxxl">{title}</h1>
+      </header>
+    {/if}
+    {#if lede}<p class="ons-hero__text ons-u-fs-l ons-font-weight__normal">{lede}</p>{/if}
+    {#if validDate(date)}<p class="ons-hero__text">{formatDate(date)}</p>{/if}
+    <slot />
+  </div>
+</Container>
+
+<style>
+  .ons-hero__details {
+    padding-left: 0;
+  }</style>