@flightlesslabs/dodo-ui 0.7.1 → 0.8.0

package/src/lib/stories/developer tools/components/InputEnclosure/WithIcon/WithIcon.stories.svelte

@@ -0,0 +1,47 @@
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import InputEnclosure from '../InputEnclosure.svelte';
+  import { storyInputEnclosureArgTypes } from '../InputEnclosure.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: InputEnclosure,
+    tags: ['autodocs'],
+    argTypes: storyInputEnclosureArgTypes,
+  });
+</script>
+
+<!-- InputEnclosure icon in front. -->
+<Story name="Icon Before" asChild>
+  <InputEnclosure>
+    {#snippet before()}
+      <Icon icon="material-symbols:content-copy" />
+    {/snippet}
+  </InputEnclosure>
+</Story>
+
+<!-- InputEnclosure icon in front. -->
+<Story name="Icon After" asChild>
+  <InputEnclosure>
+    {#snippet after()}
+      <Icon icon="material-symbols:download-2" />
+    {/snippet}
+  </InputEnclosure>
+</Story>
+
+<Story name="Small" args={{ size: 'small' }} asChild>
+  <InputEnclosure size="small">
+    {#snippet before()}
+      <Icon icon="material-symbols:content-copy" />
+    {/snippet}
+  </InputEnclosure>
+</Story>
+
+<Story name="Large" args={{ size: 'large' }} asChild>
+  <InputEnclosure size="large">
+    {#snippet before()}
+      <Icon icon="material-symbols:content-copy" />
+    {/snippet}
+  </InputEnclosure>
+</Story>

package/src/lib/stories/developer tools/components/Popper/Popper.stories.svelte

@@ -0,0 +1,124 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import type { StoryBookArgTypes } from '$lib/storybook-types.js';
+  import { Menu, MenuItem, Popper } from '$lib/index.js';
+  import Button from '$lib/stories/components/Form/Button/Button.svelte';
+  import { positionXArray, positionYArray } from '$lib/types/position.js';
+
+  export const storyPopperArgTypes: StoryBookArgTypes = {
+    popupPositionX: {
+      control: { type: 'select' },
+      options: positionXArray,
+    },
+    popupPositionY: {
+      control: { type: 'select' },
+      options: positionYArray,
+    },
+  };
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Popper,
+    tags: ['autodocs'],
+    argTypes: storyPopperArgTypes,
+    parameters: {
+      docs: {
+        story: {
+          height: '200px',
+          inline: false,
+        },
+      },
+    },
+  });
+
+  let open = $state(false);
+</script>
+
+<Story name="Default" args={{ open, onClickOutside: () => (open = false) }} asChild>
+  <Popper {open} onClickOutside={() => (open = false)}>
+    <Button onclick={() => (open = true)}>Click to see Popup</Button>
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>
+
+<Story name="MenuOpen" args={{ open: true }} asChild>
+  <Popper open>
+    Hello! how are you doing?
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>
+
+<Story
+  name="CustomPaperProps"
+  args={{
+    open: true,
+    paperProps: {
+      color: 'primary',
+    },
+  }}
+  asChild
+>
+  <Popper
+    open
+    paperProps={{
+      color: 'primary',
+    }}
+  >
+    Hello! how are you doing?
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>
+
+<Story name="FullWidth" asChild>
+  <Popper {open} fullWidth onClickOutside={() => (open = false)}>
+    <Button onclick={() => (open = true)}>Click to see Popup</Button>
+
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>
+
+<Story
+  name="CustomPopup"
+  args={{
+    open,
+    onClickOutside: () => (open = false),
+  }}
+  asChild
+>
+  <Popper {open} onClickOutside={() => (open = false)}>
+    <Button onclick={() => (open = true)}>Click to see Popup</Button>
+
+    {#snippet customPopup(popperLocation)}
+      {#if open}
+        <Menu>
+          <MenuItem>{popperLocation?.height}</MenuItem>
+          <MenuItem>{popperLocation?.width}</MenuItem>
+        </Menu>
+      {/if}
+    {/snippet}
+  </Popper>
+</Story>

package/src/lib/stories/developer tools/components/Popper/PopperPopup/PopperPopup.stories.svelte

@@ -0,0 +1,64 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import type { StoryBookArgTypes } from '$lib/storybook-types.js';
+  import { Menu, MenuItem, PopperPopup } from '$lib/index.js';
+  import { positionXArray, positionYArray } from '$lib/types/position.js';
+
+  export const storyPopperPopupArgTypes: StoryBookArgTypes = {
+    popupPositionX: {
+      control: { type: 'select' },
+      options: positionXArray,
+    },
+    popupPositionY: {
+      control: { type: 'select' },
+      options: positionYArray,
+    },
+  };
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: PopperPopup,
+    tags: ['autodocs'],
+    argTypes: storyPopperPopupArgTypes,
+    parameters: {
+      docs: {
+        story: {
+          height: '200px',
+          inline: false,
+        },
+      },
+    },
+  });
+</script>
+
+<Story name="Default" asChild>
+  <PopperPopup>
+    <Menu>
+      <MenuItem>One</MenuItem>
+      <MenuItem>Two</MenuItem>
+      <MenuItem>Three</MenuItem>
+    </Menu>
+  </PopperPopup>
+</Story>
+
+<Story
+  name="CustomPaperProps"
+  args={{
+    paperProps: {
+      color: 'primary',
+    },
+  }}
+  asChild
+>
+  <PopperPopup
+    paperProps={{
+      color: 'primary',
+    }}
+  >
+    <Menu>
+      <MenuItem>One</MenuItem>
+      <MenuItem>Two</MenuItem>
+      <MenuItem>Three</MenuItem>
+    </Menu>
+  </PopperPopup>
+</Story>

package/src/lib/stories/developer tools/components/Popper/Positions/AutoPosition/AutoPosition.stories.svelte

@@ -0,0 +1,92 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import { Menu, MenuItem, Popper } from '$lib/index.js';
+  import Button from '$lib/stories/components/Form/Button/Button.svelte';
+  import { storyPopperArgTypes } from '../../Popper.stories.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Popper,
+    tags: ['autodocs'],
+    argTypes: storyPopperArgTypes,
+    parameters: {
+      docs: {
+        story: {
+          height: '200px',
+          inline: false,
+        },
+      },
+    },
+  });
+
+  let open = $state(false);
+</script>
+
+<!-- Positions will auto adjust depending on the space on top and bottom -->
+<Story
+  name="PositionAutoAdjust"
+  args={{ open, onClickOutside: () => (open = false), popupPositionY: 'top' }}
+  asChild
+>
+  <Popper {open} onClickOutside={() => (open = false)} popupPositionY="top">
+    <Button onclick={() => (open = true)}>Click to see Popup</Button>
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>
+
+<!-- Positions will not auto adjust if you use `lockPoistions` -->
+<Story
+  name="LockPoistions"
+  args={{
+    open,
+    onClickOutside: () => (open = false),
+    popupPositionY: 'top',
+    lockPoistions: true,
+  }}
+  asChild
+>
+  <Popper {open} lockPoistions onClickOutside={() => (open = false)} popupPositionY="top">
+    <Button onclick={() => (open = true)}>Click to see Popup</Button>
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>
+
+<!-- you can also adjust `popperHeightForVerticalPosition` to achive the same -->
+<Story
+  name="HeightForVerticalPosition"
+  args={{
+    open,
+    onClickOutside: () => (open = false),
+    popupPositionY: 'top',
+    popperHeightForVerticalPosition: 3,
+  }}
+  asChild
+>
+  <Popper
+    {open}
+    onClickOutside={() => (open = false)}
+    popupPositionY="top"
+    popperHeightForVerticalPosition={3}
+  >
+    <Button onclick={() => (open = true)}>Click to see Popup</Button>
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>

package/src/lib/stories/developer tools/components/Popper/Positions/Positions.stories.svelte

@@ -0,0 +1,114 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import { Menu, MenuItem, Popper } from '$lib/index.js';
+  import Button from '$lib/stories/components/Form/Button/Button.svelte';
+  import { storyPopperArgTypes } from '../Popper.stories.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Popper,
+    tags: ['autodocs'],
+    argTypes: storyPopperArgTypes,
+    parameters: {
+      layout: 'centered',
+      docs: {
+        story: {
+          height: '400px',
+          inline: false,
+        },
+      },
+    },
+  });
+
+  let open = $state(false);
+</script>
+
+<Story name="BottomLeft" asChild>
+  <Popper {open} onClickOutside={() => (open = false)} popupWidth="100px">
+    <Button onclick={() => (open = true)}>Click to see Popup</Button>
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>
+
+<Story name="BottomCenter" asChild>
+  <Popper {open} popupPositionX="center" onClickOutside={() => (open = false)} popupWidth="100px">
+    <Button onclick={() => (open = true)}>Click to see Popup</Button>
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>
+
+<Story name="BottomRight" asChild>
+  <Popper {open} popupPositionX="right" onClickOutside={() => (open = false)} popupWidth="100px">
+    <Button onclick={() => (open = true)}>Click to see Popup</Button>
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>
+
+<Story name="TopLeft" asChild>
+  <Popper {open} popupPositionY="top" onClickOutside={() => (open = false)} popupWidth="100px">
+    <Button onclick={() => (open = true)}>Click to see Popup</Button>
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>
+
+<Story name="TopCenter" asChild>
+  <Popper
+    {open}
+    popupPositionY="top"
+    popupPositionX="center"
+    onClickOutside={() => (open = false)}
+    popupWidth="100px"
+  >
+    <Button onclick={() => (open = true)}>Click to see Popup</Button>
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>
+
+<Story name="TopRight" asChild>
+  <Popper
+    {open}
+    popupPositionY="top"
+    popupPositionX="right"
+    onClickOutside={() => (open = false)}
+    popupWidth="100px"
+  >
+    <Button onclick={() => (open = true)}>Click to see Popup</Button>
+    {#snippet popupChildren()}
+      <Menu>
+        <MenuItem>One</MenuItem>
+        <MenuItem>Two</MenuItem>
+        <MenuItem>Three</MenuItem>
+      </Menu>
+    {/snippet}
+  </Popper>
+</Story>

package/src/lib/stories/developer tools/components/UtilityButton/Size/Size.stories.svelte

@@ -0,0 +1,25 @@
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import UtilityButton from '../UtilityButton.svelte';
+  import { storyUtilityButtonArgTypes } from '../UtilityButton.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: UtilityButton,
+    tags: ['autodocs'],
+    argTypes: storyUtilityButtonArgTypes,
+  });
+</script>
+
+<Story name="Normal">
+  <Icon icon="mdi:eye" width="24" height="24" />
+</Story>
+
+<Story name="Small" args={{ size: 'small' }}>
+  <Icon icon="mdi:eye" width="24" height="24" />
+</Story>
+
+<Story name="Large" args={{ size: 'large' }}>
+  <Icon icon="mdi:eye" width="24" height="24" />
+</Story>

package/src/lib/stories/developer tools/components/UtilityButton/UtilityButton.stories.svelte

@@ -0,0 +1,30 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import UtilityButton from './UtilityButton.svelte';
+  import type { StoryBookArgTypes } from '$lib/storybook-types.js';
+  import Icon from '@iconify/svelte';
+  import { componentSizeArray } from '$lib/types/size.js';
+
+  export const storyUtilityButtonArgTypes: StoryBookArgTypes = {
+    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: UtilityButton,
+    tags: ['autodocs'],
+    argTypes: storyUtilityButtonArgTypes,
+  });
+</script>
+
+<!-- Button with default style -->
+<Story name="Default">
+  <Icon icon="mdi:eye" width="24" height="24" />
+</Story>
+
+<Story name="Disabled" args={{ disabled: true }}>
+  <Icon icon="mdi:eye" width="24" height="24" />
+</Story>

package/src/lib/stories/developer tools/directives/clickOutside/index.mdx

@@ -0,0 +1,25 @@
+import { Source } from '@storybook/blocks';
+
+# Click Outside
+
+Event that fires after clicking outside the target component
+
+<Source
+  dark
+  language="js"
+  code={`
+import { clickOutside } '@flightlesslabs/dodo-ui';
+`}
+/>
+
+Attach it to a component
+
+<Source
+  dark
+  language="js"
+  code={`
+<div
+  use:clickOutside={onClickOutside}
+  ...
+`}
+/>

package/src/lib/stories/developer tools/philosophy/Colors/Colors.mdx

@@ -0,0 +1,43 @@
+import { Meta, Story, Source } from '@storybook/blocks';
+import * as ColorsStories from './Colors.stories.svelte';
+import * as OpacityStories from './Opacity.stories.svelte';
+
+<Meta of={ColorsStories} />
+
+# Colors
+
+We are using an extensive color pallet identical to [Tailwind Css](https://tailwindcss.com/docs/colors) Colors. The colors are adjusted for dark and light themes.
+
+## Main Colors
+
+<Story of={ColorsStories.Main} />
+
+Greyscale colors
+
+<Story of={ColorsStories.ColorsNeutral} />
+
+Constant Colors
+
+<Story of={ColorsStories.ColorsConstant} />
+
+## Base Color
+
+<Story of={ColorsStories.ColorsBase} />
+
+Greyscale colors
+
+<Story of={ColorsStories.BaseColorsNeutral} />
+
+## Adjusting opacity
+
+Opacity can be adjusted using css `color-mix` function.
+
+<Source
+  dark
+  language="css"
+  code={`
+color-mix(in oklab, var(--dodo-color-primary-800) 10%, transparent)
+`}
+/>
+
+<Story of={OpacityStories.Main} meta={OpacityStories} />

package/src/lib/stories/developer tools/philosophy/Colors/Colors.stories.svelte

@@ -0,0 +1,22 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Colors from './Colors.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Colors,
+    args: {
+      swatchType: 'colors',
+    },
+  });
+</script>
+
+<Story name="Main" />
+
+<Story name="ColorsNeutral" args={{ swatchType: 'colors-neutral' }} />
+
+<Story name="ColorsConstant" args={{ swatchType: 'colors-constant' }} />
+
+<Story name="ColorsBase" args={{ swatchType: 'base-colors' }} />
+
+<Story name="BaseColorsNeutral" args={{ swatchType: 'base-colors-neutral' }} />

package/src/lib/stories/developer tools/philosophy/Colors/Opacity.stories.svelte

@@ -0,0 +1,11 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Opacity from './Opacity.svelte';
+
+  // More on how to set up stories at: https://storybook.js.org/docs/writing-stories
+  const { Story } = defineMeta({
+    component: Opacity,
+  });
+</script>
+
+<Story name="Main" />

package/src/lib/stories/developer tools/philosophy/Themes.mdx

@@ -0,0 +1,23 @@
+import { Source } from '@storybook/blocks';
+import darkThemeToggleImage from '$lib/stories/assets/dark-theme-toggle.png';
+
+# Themes
+
+## Dark theme
+
+dark theme can be activated by adding `.dodo-theme--dark` class on the top container.
+
+<Source
+  dark
+  language="html"
+  code={`
+ <body class="dodo-theme--dark">
+ ...
+`}
+/>
+
+## Toggle theme in documentation
+
+Use the moon icon to toogle theme in documentation mode
+
+<img src={darkThemeToggleImage} />