@flightlesslabs/dodo-ui 0.10.3 → 0.11.1

package/dist/stories/developer tools/components/Popper/PopperPopup/PopperPopup.svelte

@@ -3,27 +3,42 @@ import { getPopupPosition } from './utils/getPopupPosition.js';
 </script>
 
 <script lang="ts">"use strict";
-let { children, paperProps = {}, class: className = '', popupWidth: width, popupMaxHeight: maxHeight, popupPositionX: positionX = 'left', popupPositionY: positionY = 'bottom', popperLocation, ref = $bindable(), popupOffsetX: offsetX = 0, popupOffsetY: offsetY = 12, popperHeightForVerticalPosition = 100, lockPoistions = false, } = $props();
-const popperWidth = $derived(width || '100%');
+let { children, paperProps = {}, class: className = '', popupWidth: width, popupMaxHeight: maxHeight, popupPositionX: positionX = 'left', popupPositionY: positionY = 'bottom', popperLocation, ref = $bindable(), popupOffsetX: offsetX = 0, popupOffsetY: offsetY = 12, popperHeightForVerticalPosition = 100, lockPoistions = false, fullWidth = false, } = $props();
+let popupLocation = $state();
+const fullWidthInPixels = $derived(fullWidth && popperLocation?.width ? `${popperLocation?.width}px` : '');
+const popperWidth = $derived(width || fullWidthInPixels);
 const popupMaxHeight = $derived(maxHeight || '400px');
 let left = $state(null);
 let right = $state(null);
 let top = $state(null);
 let bottom = $state(null);
+function capturePopupLocation() {
+    if (!ref) {
+        return;
+    }
+    popupLocation = ref.getBoundingClientRect();
+}
+$effect(() => {
+    if (!ref) {
+        return;
+    }
+    capturePopupLocation();
+    window.addEventListener('resize', capturePopupLocation);
+    return () => {
+        window.removeEventListener('resize', capturePopupLocation);
+    };
+});
 $effect(() => {
     const values = getPopupPosition({
         positionX,
         positionY,
-        height: popperLocation?.height || 0,
-        width: popperLocation?.width || 0,
-        top: popperLocation?.top || 0,
-        bottom: popperLocation?.bottom || 0,
-        left: popperLocation?.left || 0,
-        right: popperLocation?.right || 0,
         offsetX: offsetX,
         offsetY: offsetY,
         popperHeight: popperHeightForVerticalPosition,
         lockPoistions,
+        popperLocation,
+        popupLocation,
+        fullWidth,
     });
     left = values.left;
     right = values.right;
@@ -40,12 +55,11 @@ $effect(() => {
     className,
   ].join(' ')}
   bind:this={ref}
-  style={`width: ${popperWidth};
+  style={`${popperWidth ? `width: ${popperWidth};` : ''}
   ${left !== null ? `left: ${left}px;` : ''}
   ${right !== null ? `right: ${right}px;` : ''}
   ${top !== null ? `top: ${top}px;` : ''}
   ${bottom !== null ? `bottom: ${bottom}px;` : ''}
-  ${positionX === 'center' ? `margin: auto;` : ''}
   `}
 >
   <Paper shadow={3} {...paperProps}>
@@ -58,7 +72,7 @@ $effect(() => {
 </div>
 
 <style>.dodo-ui-PopperPopup {
-  position: absolute;
+  position: fixed;
   z-index: var(--dodo-ui-z-index-4);
 }
 .dodo-ui-PopperPopup section {

package/dist/stories/developer tools/components/Popper/PopperPopup/PopperPopup.svelte.d.ts

@@ -28,6 +28,8 @@ export interface PopperPopupProps {
     lockPoistions?: boolean;
     /** Popper Height For Vertical Position, default 300 */
     popperHeightForVerticalPosition?: number;
+    /** Full width Popper? */
+    fullWidth?: boolean;
 }
 declare const PopperPopup: import("svelte").Component<PopperPopupProps, {}, "ref">;
 type PopperPopup = ReturnType<typeof PopperPopup>;

package/dist/stories/developer tools/components/Popper/PopperPopup/utils/getPopupPosition.d.ts

@@ -2,20 +2,22 @@ import type { PositionX, PositionY } from '../../../../../../types/position.js';
 export interface GetPopupPositionProps {
     positionX: PositionX;
     positionY: PositionY;
-    height: number;
-    width: number;
-    top: number;
-    bottom: number;
-    left: number;
-    right: number;
     offsetX?: number;
     offsetY?: number;
     popperHeight: number;
     lockPoistions: boolean;
+    popperLocation?: DOMRect;
+    popupLocation?: DOMRect;
+    fullWidth?: boolean;
 }
 export declare function getPopupPosition(props: GetPopupPositionProps): {
-    left: number | null;
-    right: number | null;
+    left: null;
+    right: null;
+    top: null;
+    bottom: null;
+} | {
+    left: number;
+    right: null;
     top: number | null;
     bottom: number | null;
 };

package/dist/stories/developer tools/components/Popper/PopperPopup/utils/getPopupPosition.js

@@ -13,46 +13,63 @@ export function getPopupPosition(props) {
             bottom,
         };
     }
-    const innerHeight = window.innerHeight;
-    const gapBottom = innerHeight - props.bottom;
-    const popperHeight = props.popperHeight;
+    const POPPER_LEFT = props.popperLocation?.left || 0;
+    const POPPER_TOP = props.popperLocation?.top || 0;
+    const POPPER_BOTTOM = props.popperLocation?.bottom || 0;
+    const POPPER_HEIGHT = props.popperLocation?.height || 0;
+    const POPPER_WIDTH = props.popperLocation?.width || 0;
     const offsetX = props.offsetX ? props.offsetX : 0;
     const offsetY = props.offsetY ? props.offsetY : 0;
-    const positionX = props.positionX;
+    const POPUP_WIDTH = props.popupLocation?.width || 0;
+    const WIDTH_DIFF = POPPER_WIDTH - POPUP_WIDTH;
+    const innerHeight = window.innerHeight;
+    const gapBottom = innerHeight - POPPER_BOTTOM;
     let positionY = props.positionY;
+    // Adjust position if there is not enough space to draw it.
     if (!props.lockPoistions) {
-        if (positionY === 'top' && props.top < popperHeight + offsetY) {
+        if (positionY === 'top' && POPPER_TOP < POPPER_HEIGHT + offsetY) {
             positionY = 'bottom';
         }
-        else if (positionY === 'bottom' && gapBottom < popperHeight + offsetY) {
+        else if (positionY === 'bottom' && gapBottom < POPPER_HEIGHT + offsetY) {
             positionY = 'top';
         }
     }
-    switch (positionX) {
-        case 'left':
-            left = offsetX;
-            right = null;
-            break;
-        case 'center':
-            left = 0;
-            right = 0;
-            break;
-        case 'right':
-            left = null;
-            right = offsetX;
-            break;
-    }
     switch (positionY) {
         case 'top':
-        case 'middle':
             top = null;
-            bottom = props.height + offsetY;
+            bottom = POPPER_TOP + POPPER_HEIGHT + offsetY;
             break;
         case 'bottom':
-            top = props.height + offsetY;
+            top = POPPER_TOP + POPPER_HEIGHT + offsetY;
             bottom = null;
             break;
     }
+    if (props.fullWidth) {
+        // If Full Width
+        left = POPPER_LEFT;
+        right = null;
+    }
+    else if (WIDTH_DIFF < 0) {
+        // If Popup is bigger than the Popper Container
+        left = POPPER_LEFT;
+        right = null;
+    }
+    else {
+        switch (props.positionX) {
+            case 'left':
+                left = POPPER_LEFT + offsetX;
+                right = null;
+                break;
+            case 'center':
+                left = POPPER_LEFT + offsetX + WIDTH_DIFF / 2;
+                right = null;
+                break;
+            case 'right':
+                left = POPPER_LEFT + offsetX + WIDTH_DIFF;
+                right = null;
+                break;
+        }
+    }
     return {
         left,
         right,

package/dist/stories/developer tools/helpers/Time/getMoment/getMoment.d.ts

@@ -1,18 +1,17 @@
 import type { ConfigType, OptionType } from 'dayjs';
-import dayjs from 'dayjs';
+import { Dayjs } from 'dayjs';
 /**
  * Acceptable input types for the `getMoment` function, compatible with dayjs.
  */
 export type GetMomentDate = ConfigType;
 /**
  * Optional formatting string used to parse the date.
- * Refer to dayjs customParseFormat plugin for supported formats.
  */
 export type GetMomentFormat = OptionType;
 /**
  * Settings to control how the moment is returned (UTC, timezone, or local).
  */
-export type GetMomentSettings = {
+export interface GetMomentSettings {
     /**
      * Timezone string (e.g., "America/New_York").
      */
@@ -21,18 +20,18 @@ export type GetMomentSettings = {
      * Whether to return the time in UTC. If true, overrides timezone.
      */
     utc?: boolean;
-};
+}
 /**
  * A wrapper around dayjs to return a moment-like object with optional formatting,
  * timezone, or UTC handling.
  *
- * @param {GetMomentDate} [date] - The input date, time, or string to be parsed.
- * @param {format} [format] - A custom format string for parsing the input date.
- * @param {GetMomentSettings} [settings] - Optional settings for format, timezone, and UTC.
- * @returns {dayjs.Dayjs} - A dayjs object in local, UTC, or specified timezone.
+ * @param date - The input date, time, or string to be parsed.
+ * @param format - A custom format string for parsing the input date.
+ * @param settings - Optional settings for timezone or UTC output.
+ * @returns A dayjs object in local, UTC, or specified timezone.
  *
  * @example
- * getMoment('2025-01-01T12:00:00Z', { utc: true }).format()
- * getMoment('01-01-2025', { format: 'DD-MM-YYYY', timezone: 'Asia/Kolkata' }).format()
+ * getMoment('2025-01-01T12:00:00Z', undefined, { utc: true }).format()
+ * getMoment('01-01-2025', 'DD-MM-YYYY', { timezone: 'Asia/Kolkata' }).format()
  */
-export default function getMoment(date?: GetMomentDate, format?: GetMomentFormat, settings?: GetMomentSettings): dayjs.Dayjs;
+export default function getMoment(date?: GetMomentDate, format?: GetMomentFormat, settings?: GetMomentSettings): Dayjs;

package/dist/stories/developer tools/helpers/Time/getMoment/getMoment.js

@@ -1,4 +1,4 @@
-import dayjs from 'dayjs';
+import dayjs, { Dayjs } from 'dayjs';
 import utc from 'dayjs/plugin/utc.js';
 import timezone from 'dayjs/plugin/timezone.js';
 import customParseFormat from 'dayjs/plugin/customParseFormat.js';
@@ -9,18 +9,18 @@ dayjs.extend(customParseFormat);
  * A wrapper around dayjs to return a moment-like object with optional formatting,
  * timezone, or UTC handling.
  *
- * @param {GetMomentDate} [date] - The input date, time, or string to be parsed.
- * @param {format} [format] - A custom format string for parsing the input date.
- * @param {GetMomentSettings} [settings] - Optional settings for format, timezone, and UTC.
- * @returns {dayjs.Dayjs} - A dayjs object in local, UTC, or specified timezone.
+ * @param date - The input date, time, or string to be parsed.
+ * @param format - A custom format string for parsing the input date.
+ * @param settings - Optional settings for timezone or UTC output.
+ * @returns A dayjs object in local, UTC, or specified timezone.
  *
  * @example
- * getMoment('2025-01-01T12:00:00Z', { utc: true }).format()
- * getMoment('01-01-2025', { format: 'DD-MM-YYYY', timezone: 'Asia/Kolkata' }).format()
+ * getMoment('2025-01-01T12:00:00Z', undefined, { utc: true }).format()
+ * getMoment('01-01-2025', 'DD-MM-YYYY', { timezone: 'Asia/Kolkata' }).format()
  */
 export default function getMoment(date, format, settings) {
     const timezone = settings?.timezone;
-    const utc = settings?.utc ? true : false;
+    const utc = settings?.utc ?? false;
     if (utc) {
         return dayjs.utc(dayjs(date, format));
     }

package/dist/stories/developer tools/helpers/Time/getMoment/index.mdx

@@ -2,7 +2,9 @@ import { Source } from '@storybook/addon-docs/blocks';
 
 # `getMoment`
 
-a Day.js wrapper
+A [Day.js](https://day.js.org/) wrapper that supports custom formats, UTC mode, and timezone conversion using `dayjs`, `utc`, `timezone`, and `customParseFormat` plugins.
+
+---
 
 ## Usage
 
@@ -10,9 +12,34 @@ a Day.js wrapper
   dark
   language="ts"
   code={`
-import { getMoment } from '@flightlesslabs/dodo-ui';
+// Basic local time
+getMoment('2025-01-01T00:00:00Z').format();
+
+// UTC output
+getMoment('2025-01-01T00:00:00Z', undefined, { utc: true }).format();
+// → "2025-01-01T00:00:00Z"
+
+// With custom format + timezone
+getMoment('01-01-2025', 'DD-MM-YYYY', { timezone: 'Asia/Kolkata' }).format();
+// → "2025-01-01T00:00:00+05:30"
+`}
+/>
+
+---
 
-getMoment('2025-01-01T00:00:00Z', { utc: true }).format(); // "2025-01-01T00:00:00Z"
-getMoment('01-01-2025', { format: 'DD-MM-YYYY', timezone: 'Asia/Kolkata' }).format();
+## API
+
+<Source
+  dark
+  language="ts"
+  code={`
+getMoment(
+  date?: ConfigType,
+  format?: string,
+  settings?: {
+    utc?: boolean;
+    timezone?: string;
+  }
+): dayjs.Dayjs
 `}
 />

package/package.json

@@ -1,19 +1,6 @@
 {
   "name": "@flightlesslabs/dodo-ui",
-  "version": "0.10.3",
-  "scripts": {
-    "build": "vite build && pnpm run prepack",
-    "preview": "vite preview",
-    "prepare": "svelte-kit sync || echo ''",
-    "prepack": "svelte-kit sync && svelte-package && publint",
-    "svelte-check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
-    "format": "prettier --write .",
-    "lint": "prettier --check . && eslint .",
-    "dev": "storybook dev -p 6006",
-    "build-storybook": "storybook build && touch ./storybook-static/.nojekyll",
-    "check": "pnpm run svelte-check && eslint . && pnpm run lint",
-    "check:fix": "pnpm run svelte-check && eslint . && pnpm run format"
-  },
+  "version": "0.11.1",
   "homepage": "https://flightlesslabs.github.io/dodo-ui",
   "repository": {
     "type": "git",
@@ -50,13 +37,13 @@
   },
   "devDependencies": {
     "@chromatic-com/storybook": "4.0.0",
-    "@eslint/compat": "^1.2.9",
+    "@eslint/compat": "^1.3.0",
     "@eslint/js": "^9.28.0",
     "@storybook/addon-svelte-csf": "5.0.3",
-    "@storybook/svelte": "^9.0.8",
-    "@storybook/sveltekit": "^9.0.8",
+    "@storybook/svelte": "^9.0.9",
+    "@storybook/sveltekit": "^9.0.9",
     "@sveltejs/adapter-static": "^3.0.8",
-    "@sveltejs/kit": "^2.21.4",
+    "@sveltejs/kit": "^2.21.5",
     "@sveltejs/package": "^2.3.11",
     "@sveltejs/vite-plugin-svelte": "^5.1.0",
     "@vitest/browser": "^3.2.3",
@@ -71,8 +58,8 @@
     "prettier-plugin-svelte": "^3.4.0",
     "publint": "^0.3.12",
     "sass": "^1.89.2",
-    "storybook": "^9.0.8",
-    "svelte": "^5.33.19",
+    "storybook": "^9.0.9",
+    "svelte": "^5.34.1",
     "svelte-check": "^4.2.1",
     "svelte-preprocess": "^6.0.3",
     "typescript": "^5.8.3",
@@ -89,8 +76,19 @@
   },
   "dependencies": {
     "@iconify/svelte": "^5.0.0",
-    "@storybook/addon-docs": "^9.0.8",
-    "@storybook/addon-vitest": "^9.0.8",
+    "@storybook/addon-docs": "^9.0.9",
+    "@storybook/addon-vitest": "^9.0.9",
     "dayjs": "^1.11.13"
+  },
+  "scripts": {
+    "build": "vite build && pnpm run prepack",
+    "preview": "vite preview",
+    "svelte-check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "format": "prettier --write .",
+    "lint": "prettier --check . && eslint .",
+    "dev": "storybook dev -p 6006",
+    "build-storybook": "storybook build && touch ./storybook-static/.nojekyll",
+    "check": "pnpm run svelte-check && eslint . && pnpm run lint",
+    "check:fix": "pnpm run svelte-check && eslint . && pnpm run format"
   }
-}
+}

package/src/lib/index.ts

@@ -199,9 +199,9 @@ export { default as CalendarYearChip } from '$lib/stories/components/Info/Calend
 
 export type { DateOfMonth } from '$lib/stories/components/Info/Calendar/utils/types.js';
 export { DAYS_OF_WEEK, MONTHS } from '$lib/stories/components/Info/Calendar/utils/types.js';
-export { default as getDatesOfMonth } from '$lib/stories/components/Info/Calendar/utils/getDatesOfMonth.js';
-export { default as createDateOfMonth } from '$lib/stories/components/Info/Calendar/utils/createDateOfMonth.js';
+export { default as getDatesOfMonth } from '$lib/stories/components/Info/Calendar/utils/getDatesOfMonth/getDatesOfMonth.js';
+export { default as createDateOfMonth } from '$lib/stories/components/Info/Calendar/utils/createDateOfMonth/createDateOfMonth.js';
 export type {
   CreateDatesOfMonthSettings,
   CreateDateOfMonthType,
-} from '$lib/stories/components/Info/Calendar/utils/createDateOfMonth.js';
+} from '$lib/stories/components/Info/Calendar/utils/createDateOfMonth/createDateOfMonth.js';

package/src/lib/stories/Home.mdx

@@ -0,0 +1,59 @@
+import { Source } from '@storybook/addon-docs/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>