@flightlesslabs/dodo-ui 0.7.1 → 0.8.0

package/src/lib/stories/Home.mdx

@@ -0,0 +1,59 @@
+import { Source } from '@storybook/blocks';
+import item from '../../../package.json?raw';
+
+<main style={{ textAlign: 'center' }}>
+
+<img src="dodo-circle-6.png" style={{ width: 200, height: 'auto' }} />
+
+# Dodo UI
+
+<h3 style={{ fontWeight: 500 }}>v{JSON.parse(item)?.version}</h3>
+
+<h3 style={{ fontWeight: 400 }}>An open-source, opinionated UI framework for Svelte.</h3>
+
+### [Github](https://github.com/flightlesslabs/dodo-ui) - [npm](https://www.npmjs.com/package/@flightlesslabs/dodo-ui)
+
+</main>
+
+<br />
+<br />
+
+## Install
+
+pnpm
+
+<Source
+  dark
+  language="bash"
+  code={`
+pnpm add @flightlesslabs/dodo-ui
+`}
+/>
+
+npm
+
+<Source
+  dark
+  language="bash"
+  code={`
+npm i @flightlesslabs/dodo-ui
+`}
+/>
+
+## Use it!
+
+Lets import [Button](?path=/docs/components-form-button--docs) component. Checkout documentation for [Button](?path=/docs/components-form-button--docs)
+
+<Source
+  dark
+  language="js"
+  code={`
+import { Button } '@flightlesslabs/dodo-ui';
+`}
+/>
+
+## Explore more
+
+- [Dark Theme](?path=/docs/developer-tools-philosophy-themes--docs#dark-theme)
+- [Colors](?path=/docs/developer-tools-philosophy-colors--docs)
+- [Adjust Color Opacity](?path=/docs/developer-tools-philosophy-colors--docs#adjusting-opacity)

package/src/lib/stories/components/Form/Button/Button.stories.svelte

@@ -0,0 +1,61 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Button, { buttonTypeArray } from './Button.svelte';
+  import type { StoryBookArgTypes } from '$lib/storybook-types.js';
+  import { componentRoundnessArray } from '$lib/types/roundness.js';
+  import { componentColorArray } from '$lib/types/colors.js';
+  import { componentWeightArray } from '$lib/types/weight.js';
+  import { componentSizeArray } from '$lib/types/size.js';
+
+  export const storyButtonArgTypes: StoryBookArgTypes = {
+    type: {
+      control: { type: 'select' },
+      options: buttonTypeArray,
+    },
+    color: {
+      control: { type: 'select' },
+      options: componentColorArray,
+    },
+    variant: {
+      control: { type: 'select' },
+      options: componentWeightArray,
+    },
+    roundness: {
+      control: { type: 'select' },
+      options: componentRoundnessArray,
+    },
+    size: {
+      control: { type: 'select' },
+      options: componentSizeArray,
+    },
+  };
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Button,
+    tags: ['autodocs'],
+    argTypes: storyButtonArgTypes,
+  });
+</script>
+
+<!-- Button with default style -->
+<Story name="Primary">Click me!</Story>
+
+<!-- Button with border around it -->
+<Story name="Outline" args={{ outline: true, variant: 'text' }}>Click me!</Story>
+
+<Story name="Disabled" args={{ disabled: true }}>Click me!</Story>
+
+<!-- Form submit button -->
+<Story name="Sumbit Button" args={{ type: 'submit' }}>Submit Form</Story>
+
+<!-- Form submit button -->
+<Story name="Full width Button" args={{ fullWidth: true }}>Click me!</Story>
+
+<!-- Anchor Link styled like a Button -->
+<Story
+  name="Link Button"
+  args={{ href: 'https://www.w3schools.com/tags/tag_a.asp', target: '_blank' }}
+>
+  Link
+</Story>

package/src/lib/stories/components/Form/Button/Color/Color.stories.svelte

@@ -0,0 +1,43 @@
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Button from '../Button.svelte';
+  import { storyButtonArgTypes } from '../Button.stories.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Button,
+    tags: ['autodocs'],
+    argTypes: storyButtonArgTypes,
+  });
+</script>
+
+<Story name="Primary">Click me!</Story>
+<Story name="Secondary" args={{ color: 'secondary' }}>Click me!</Story>
+<Story name="Neutral" args={{ color: 'neutral' }}>Click me!</Story>
+<Story name="Safe" args={{ color: 'safe' }}>Click me!</Story>
+<Story name="Warning" args={{ color: 'warning' }}>Click me!</Story>
+<Story name="Danger" args={{ color: 'danger' }}>Click me!</Story>
+
+<Story name="Primary Text" args={{ color: 'primary', variant: 'text' }}>Click me!</Story>
+<Story name="Secondary Text" args={{ color: 'secondary', variant: 'text' }}>Click me!</Story>
+<Story name="Neutral Text" args={{ color: 'neutral', variant: 'text' }}>Click me!</Story>
+<Story name="Safe Text" args={{ color: 'safe', variant: 'text' }}>Click me!</Story>
+<Story name="Warning Text" args={{ color: 'warning', variant: 'text' }}>Click me!</Story>
+<Story name="Danger Text" args={{ color: 'danger', variant: 'text' }}>Click me!</Story>
+
+<Story name="Primary Outline" args={{ variant: 'text', outline: true }}>Click me!</Story>
+<Story name="Secondary Outline" args={{ color: 'secondary', variant: 'text', outline: true }}>
+  Click me!
+</Story>
+<Story name="Neutral Outline" args={{ color: 'neutral', variant: 'text', outline: true }}>
+  Click me!
+</Story>
+<Story name="Safe Outline" args={{ color: 'safe', variant: 'text', outline: true }}>
+  Click me!
+</Story>
+<Story name="Warning Outline" args={{ color: 'warning', variant: 'text', outline: true }}>
+  Click me!
+</Story>
+<Story name="Danger Outline" args={{ color: 'danger', variant: 'text', outline: true }}>
+  Click me!
+</Story>

package/src/lib/stories/components/Form/Button/Events/Events.stories.svelte

@@ -0,0 +1,36 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Button from '../Button.svelte';
+  import { storyButtonArgTypes } from '../Button.stories.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Button,
+    tags: ['autodocs'],
+    argTypes: storyButtonArgTypes,
+  });
+</script>
+
+<Story
+  name="Click"
+  args={{
+    onclick: (e: Event) => {
+      const target = e.target as HTMLButtonElement;
+
+      alert('Button Clicked');
+      console.log('Button Clicked', target);
+    },
+  }}
+  asChild
+>
+  <Button
+    onclick={(e: Event) => {
+      const target = e.target as HTMLButtonElement;
+
+      alert('Button Clicked');
+      console.log('Button Clicked', target);
+    }}
+  >
+    Click me!
+  </Button>
+</Story>

package/src/lib/stories/components/Form/Button/IconButton/IconButton.stories.svelte

@@ -0,0 +1,43 @@
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Button from '../Button.svelte';
+  import { storyButtonArgTypes } from '../Button.stories.svelte';
+  import Icon from '@iconify/svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Button,
+    tags: ['autodocs'],
+    argTypes: storyButtonArgTypes,
+  });
+</script>
+
+<!-- Compact button with paddings stripped out and fixed size. We are using this icon library https://iconify.design/docs/icon-components/svelte/ -->
+<Story name="Icon Button" args={{ compact: true }}>
+  <Icon icon="material-symbols:app-badging" width="18" height="18" />
+</Story>
+
+<!-- Circualr Icon button. -->
+<Story name="Icon Button Circular" args={{ compact: true, roundness: 'full' }}>
+  <Icon icon="material-symbols:app-badging" width="18" height="18" />
+</Story>
+
+<!-- Button with an icon in front. -->
+<Story name="Icon Before" asChild>
+  <Button>
+    {#snippet before()}
+      <Icon icon="material-symbols:content-copy" />
+    {/snippet}
+    Copy
+  </Button>
+</Story>
+
+<!-- Button with an icon in front. -->
+<Story name="Icon After" asChild>
+  <Button>
+    {#snippet after()}
+      <Icon icon="material-symbols:download-2" />
+    {/snippet}
+    Download
+  </Button>
+</Story>

package/src/lib/stories/components/Form/Button/Roundness/Roundness.stories.svelte

@@ -0,0 +1,23 @@
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Button from '../Button.svelte';
+  import { storyButtonArgTypes } from '../Button.stories.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Button,
+    tags: ['autodocs'],
+    argTypes: storyButtonArgTypes,
+  });
+</script>
+
+<Story name="Roundness 1">Click me!</Story>
+
+<Story name="Roundness 2" args={{ roundness: 2 }}>Click me!</Story>
+
+<Story name="Roundness 3" args={{ roundness: 3 }}>Click me!</Story>
+
+<Story name="Roundness 0" args={{ roundness: 0 }}>Click me!</Story>
+
+<!-- Button with 50% roundness usefull for icon (Compact) buttons -->
+<Story name="Roundness Full" args={{ roundness: 'full', compact: true }}>C</Story>

package/src/lib/stories/components/Form/Button/Size/Size.stories.svelte

@@ -0,0 +1,16 @@
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Button from '../Button.svelte';
+  import { storyButtonArgTypes } from '../Button.stories.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Button,
+    tags: ['autodocs'],
+    argTypes: storyButtonArgTypes,
+  });
+</script>
+
+<Story name="Normal">Click me!</Story>
+<Story name="Small" args={{ size: 'small' }}>Click me!</Story>
+<Story name="Large" args={{ size: 'large' }}>Click me!</Story>

package/src/lib/stories/components/Form/Button/Variant/Variant.stories.svelte

@@ -0,0 +1,18 @@
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Button from '../Button.svelte';
+  import { storyButtonArgTypes } from '../Button.stories.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Button,
+    tags: ['autodocs'],
+    argTypes: storyButtonArgTypes,
+  });
+</script>
+
+<Story name="Solid">Click me!</Story>
+
+<Story name="Text" args={{ variant: 'text' }}>Click me!</Story>
+
+<Story name="Text Outline" args={{ variant: 'text', outline: true }}>Click me!</Story>

package/src/lib/stories/components/Form/FormControl/FormControl.stories.svelte

@@ -0,0 +1,28 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import FormControl from './FormControl.svelte';
+  import TextInput from '../TextInput/TextInput.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: FormControl,
+    tags: ['autodocs'],
+  });
+</script>
+
+<Story name="Default" args={{ label: 'Hello there' }} />
+
+<Story name="Example TextInput" args={{ label: 'Whats your first name?', for: 'first-name-01' }}>
+  <TextInput placeholder="First name" id="first-name-01" />
+</Story>
+
+<Story
+  name="ErrorMessage"
+  args={{
+    label: 'Whats your first name?',
+    for: 'first-name-02',
+    errorMessage: 'This is an error message',
+  }}
+>
+  <TextInput value="John Smith" id="first-name-02" error />
+</Story>

package/src/lib/stories/components/Form/Label/Label.stories.svelte

@@ -0,0 +1,13 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Label from './Label.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Label,
+    tags: ['autodocs'],
+  });
+</script>
+
+<!-- Label with default style -->
+<Story name="Default">This is a form label</Story>

package/src/lib/stories/components/Form/Message/Color/Color.stories.svelte

@@ -0,0 +1,36 @@
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Message from '../Message.svelte';
+  import { storyMessageArgTypes } from '../Message.stories.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Message,
+    tags: ['autodocs'],
+    argTypes: storyMessageArgTypes,
+  });
+</script>
+
+<Story name="Primary" args={{ color: 'primary' }}>
+  Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</Story>
+
+<Story name="Secondary" args={{ color: 'secondary' }}>
+  Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</Story>
+
+<Story name="Neutral" args={{ color: 'neutral' }}>
+  Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</Story>
+
+<Story name="Safe" args={{ color: 'safe' }}>
+  Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</Story>
+
+<Story name="Warning" args={{ color: 'warning' }}>
+  Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</Story>
+
+<Story name="Danger" args={{ color: 'danger' }}>
+  Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</Story>

package/src/lib/stories/components/Form/Message/Message.stories.svelte

@@ -0,0 +1,27 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Message from './Message.svelte';
+  import type { StoryBookArgTypes } from '$lib/storybook-types.js';
+  import { componentColorArray } from '$lib/types/colors.js';
+  import { componentSizeArray } from '$lib/types/size.js';
+
+  export const storyMessageArgTypes: StoryBookArgTypes = {
+    color: {
+      control: { type: 'select' },
+      options: componentColorArray,
+    },
+    size: {
+      control: { type: 'select' },
+      options: componentSizeArray,
+    },
+  };
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Message,
+    tags: ['autodocs'],
+    argTypes: storyMessageArgTypes,
+  });
+</script>
+
+<Story name="Primary">Lorem ipsum dolor sit amet, consectetur adipiscing elit</Story>

package/src/lib/stories/components/Form/Message/Size/Size.stories.svelte

@@ -0,0 +1,22 @@
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Message from '../Message.svelte';
+  import { storyMessageArgTypes } from '../Message.stories.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Message,
+    tags: ['autodocs'],
+    argTypes: storyMessageArgTypes,
+  });
+</script>
+
+<Story name="Normal">Lorem ipsum dolor sit amet, consectetur adipiscing elit</Story>
+
+<Story name="Small" args={{ size: 'small' }}>
+  Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</Story>
+
+<Story name="Large" args={{ size: 'large' }}>
+  Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</Story>

package/src/lib/stories/components/Form/PasswordInput/Events/Events.stories.svelte

@@ -0,0 +1,110 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import { storyPasswordInputArgTypes } from '../PasswordInput.stories.svelte';
+  import PasswordInput, { type PasswordInputToggleEvent } from '../PasswordInput.svelte';
+  import type {
+    TextInputFocusEvent,
+    TextInputClipboardEvent,
+  } from '../../TextInput/TextInput.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: PasswordInput,
+    tags: ['autodocs'],
+    argTypes: storyPasswordInputArgTypes,
+  });
+</script>
+
+<Story
+  name="Input"
+  args={{
+    oninput: (e: Event) => {
+      const target = e.target as HTMLInputElement;
+
+      console.log('Input Event', target.value);
+    },
+  }}
+/>
+
+<Story
+  name="Change"
+  args={{
+    onchange: (e: Event) => {
+      const target = e.target as HTMLInputElement;
+
+      console.log('onChange Event', target.value);
+    },
+  }}
+/>
+
+<!-- `e: PasswordInputToggleEvent` -->
+<Story
+  name="Toggle"
+  args={{
+    ontoggle: (e: PasswordInputToggleEvent) => {
+      const target = e.event.target as HTMLButtonElement;
+
+      console.log('ontoggle Event', e, target);
+    },
+  }}
+/>
+
+<!-- `e: TextInputFocusEvent` -->
+<Story
+  name="Focus"
+  args={{
+    onfocus: (e: TextInputFocusEvent) => {
+      const target = e.target as HTMLInputElement;
+
+      console.log('onfocus Event', target);
+    },
+  }}
+/>
+
+<!-- `e: TextInputFocusEvent` -->
+<Story
+  name="Blur"
+  args={{
+    onblur: (e: TextInputFocusEvent) => {
+      const target = e.target as HTMLInputElement;
+
+      console.log('onblur Event', target);
+    },
+  }}
+/>
+
+<!-- `e: TextInputClipboardEvent` -->
+<Story
+  name="Copy"
+  args={{
+    oncopy: (e: TextInputClipboardEvent) => {
+      const target = e.target as HTMLInputElement;
+
+      console.log('oncopy Event', target);
+    },
+  }}
+/>
+
+<!-- `e: TextInputClipboardEvent` -->
+<Story
+  name="Cut"
+  args={{
+    oncut: (e: TextInputClipboardEvent) => {
+      const target = e.target as HTMLInputElement;
+
+      console.log('oncut Event', target);
+    },
+  }}
+/>
+
+<!-- `e: TextInputClipboardEvent` -->
+<Story
+  name="Paste"
+  args={{
+    onpaste: (e: TextInputClipboardEvent) => {
+      const target = e.target as HTMLInputElement;
+
+      console.log('onpaste Event', target);
+    },
+  }}
+/>

package/src/lib/stories/components/Form/PasswordInput/PasswordInput.stories.svelte

@@ -0,0 +1,59 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import PasswordInput from './PasswordInput.svelte';
+  import type { StoryBookArgTypes } from '$lib/storybook-types.js';
+  import Icon from '@iconify/svelte';
+  import { componentRoundnessArray } from '$lib/types/roundness.js';
+  import { componentSizeArray } from '$lib/types/size.js';
+
+  export const storyPasswordInputArgTypes: StoryBookArgTypes = {
+    roundness: {
+      control: { type: 'select' },
+      options: componentRoundnessArray,
+    },
+    size: {
+      control: { type: 'select' },
+      options: componentSizeArray,
+    },
+  };
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: PasswordInput,
+    tags: ['autodocs'],
+    argTypes: storyPasswordInputArgTypes,
+    args: { value: 'Hello world!' },
+  });
+</script>
+
+<!-- PasswordInput with default style -->
+<Story name="Default" />
+
+<Story name="Placeholder" args={{ value: '', placeholder: 'Type something...' }} />
+
+<Story name="No Outline" args={{ outline: false }} />
+
+<Story name="Error" args={{ error: true }} />
+
+<Story name="Disabled" args={{ disabled: true }} />
+
+<!-- Disable password toggle -->
+<Story name="No toggle" args={{ passwordToggle: false }} />
+
+<!-- Show Password by default -->
+<Story name="Show Password" args={{ passwordToggleState: true }} />
+
+<Story name="Read only" args={{ readonly: true }} />
+
+<!-- Show Password by default -->
+<Story name="Custom toggle icon" asChild>
+  <PasswordInput value="Hello world!">
+    {#snippet customPasswordToggleIcon(toggle)}
+      {#if toggle}
+        <Icon icon="mingcute:eye-close-line" width="24" height="24" />
+      {:else}
+        <Icon icon="mingcute:eye-2-line" width="24" height="24" />
+      {/if}
+    {/snippet}
+  </PasswordInput>
+</Story>

package/src/lib/stories/components/Form/PasswordInput/Roundness/Roundness.stories.svelte

@@ -0,0 +1,20 @@
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import PasswordInput from '../PasswordInput.svelte';
+  import { storyPasswordInputArgTypes } from '../PasswordInput.stories.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: PasswordInput,
+    tags: ['autodocs'],
+    argTypes: storyPasswordInputArgTypes,
+  });
+</script>
+
+<Story name="Roundness 1" />
+
+<Story name="Roundness 2" args={{ roundness: 2 }} />
+
+<Story name="Roundness 3" args={{ roundness: 3 }} />
+
+<Story name="Roundness 0" args={{ roundness: 0 }} />

package/src/lib/stories/components/Form/PasswordInput/Size/Size.stories.svelte

@@ -0,0 +1,16 @@
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import PasswordInput from '../PasswordInput.svelte';
+  import { storyPasswordInputArgTypes } from '../PasswordInput.stories.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: PasswordInput,
+    tags: ['autodocs'],
+    argTypes: storyPasswordInputArgTypes,
+  });
+</script>
+
+<Story name="Normal" />
+<Story name="Small" args={{ size: 'small' }} />
+<Story name="Large" args={{ size: 'large' }} />