@flightlesslabs/dodo-ui 0.19.1 → 0.21.0

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

@@ -0,0 +1,159 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import TextInput from './TextInput.svelte';
+  import type { TextInputProps } from './TextInput.svelte';
+  import type { ArgTypes } from 'storybook/internal/csf';
+
+  import { componentSizeOptions } from '$lib/attributes/size.js';
+  import { componentRoundnessOptions } from '$lib/attributes/roundness.js';
+  import Theme from '$lib/components/Layout/Theme/Theme.svelte';
+
+  // ------------------------------
+  // Storybook ArgTypes
+  // ------------------------------
+  export const storyTextInputArgTypes: Partial<ArgTypes<TextInputProps>> = {
+    children: {
+      table: { disable: true },
+      control: false,
+    },
+
+    // ------------------------------
+    // Core
+    // ------------------------------
+    class: { table: { category: 'API', subcategory: 'Base' } },
+    placeholder: {
+      control: { type: 'text' },
+      table: { category: 'API', subcategory: 'Base' },
+    },
+    value: {
+      control: { type: 'text' },
+      table: { category: 'API', subcategory: 'Base' },
+    },
+    name: { table: { category: 'API', subcategory: 'Base' } },
+
+    // ------------------------------
+    // State
+    // ------------------------------
+    disabled: {
+      control: { type: 'boolean' },
+      description: 'Disabled state of the input',
+      table: { category: 'API', subcategory: 'State', defaultValue: { summary: 'false' } },
+    },
+    focused: {
+      control: { type: 'boolean' },
+      description: 'Force focused visual state',
+      table: { category: 'API', subcategory: 'State', defaultValue: { summary: 'false' } },
+    },
+    error: {
+      control: { type: 'boolean' },
+      description: 'Error visual state',
+      table: { category: 'API', subcategory: 'State', defaultValue: { summary: 'false' } },
+    },
+
+    // ------------------------------
+    // Appearance
+    // ------------------------------
+    size: {
+      control: { type: 'select' },
+      options: componentSizeOptions,
+      description: 'Visual size token',
+      table: { category: 'API', subcategory: 'Appearance', defaultValue: { summary: 'normal' } },
+    },
+    roundness: {
+      control: { type: 'select' },
+      options: componentRoundnessOptions,
+      description: 'Border radius token',
+      table: { category: 'API', subcategory: 'Appearance', defaultValue: { summary: '1' } },
+    },
+    outline: {
+      control: { type: 'boolean' },
+      description: 'Render outlined enclosure',
+      table: { category: 'API', subcategory: 'Appearance', defaultValue: { summary: 'true' } },
+    },
+
+    // ------------------------------
+    // Slots (Snippets)
+    // ------------------------------
+    before: {
+      table: { category: 'API', subcategory: 'Slots' },
+      description: 'Content rendered before the input',
+    },
+    after: {
+      table: { category: 'API', subcategory: 'Slots' },
+      description: 'Content rendered after the input',
+    },
+
+    // ------------------------------
+    // Events
+    // ------------------------------
+    onfocus: { table: { category: 'API', subcategory: 'Events' }, action: 'focus' },
+    onblur: { table: { category: 'API', subcategory: 'Events' }, action: 'blur' },
+    oninput: { table: { category: 'API', subcategory: 'Events' }, action: 'input' },
+    onchange: { table: { category: 'API', subcategory: 'Events' }, action: 'change' },
+  };
+
+  // ------------------------------
+  // Storybook Meta
+  // ------------------------------
+  const { Story } = defineMeta({
+    component: TextInput,
+    tags: ['autodocs'],
+    argTypes: storyTextInputArgTypes,
+  });
+</script>
+
+<!-- ------------------------------ -->
+<!-- Stories -->
+<!-- ------------------------------ -->
+
+<Story name="Default" args={{ placeholder: 'Type something…' }} />
+
+<Story name="Focused" args={{ placeholder: 'Focused state…', focused: true }} />
+
+<Story name="Error" args={{ placeholder: 'Error state…', error: true }} />
+
+<Story name="Disabled" args={{ placeholder: 'Disabled state…', disabled: true }} />
+
+<Story name="Large" args={{ placeholder: 'Type something…', size: 'large' }} />
+
+<Story name="Pill Shape" args={{ placeholder: 'Type something…', roundness: 'pill' }} />
+
+<Story name="With Before (Prefix Icon)" asChild>
+  <TextInput placeholder="Search…">
+    {#snippet before()}
+      <span style="color: #888;">🔍</span>
+    {/snippet}
+  </TextInput>
+</Story>
+
+<Story name="With After (Suffix Text)" asChild>
+  <TextInput placeholder="Website">
+    {#snippet after()}
+      <span style="color: #888;">.com</span>
+    {/snippet}
+  </TextInput>
+</Story>
+
+<Story name="With Before + After" asChild>
+  <TextInput placeholder="Amount">
+    {#snippet before()}
+      <span style="opacity: 0.6;">$</span>
+    {/snippet}
+
+    {#snippet after()}
+      <span style="opacity: 0.6;">USD</span>
+    {/snippet}
+  </TextInput>
+</Story>
+
+<Story name="Light Theme" asChild>
+  <Theme type="light">
+    <TextInput placeholder="Type something…" />
+  </Theme>
+</Story>
+
+<Story name="Dark Theme" asChild globals={{ backgrounds: { value: 'dark' } }}>
+  <Theme type="dark">
+    <TextInput placeholder="Type something…" />
+  </Theme>
+</Story>

package/src/lib/components/Form/TextInput/TextInput.svelte

@@ -0,0 +1,140 @@
+<script lang="ts" module>
+  import type { Snippet } from 'svelte';
+  import type { HTMLInputAttributes } from 'svelte/elements';
+
+  export type TextInputEvent = {
+    currentTarget: EventTarget & HTMLInputElement;
+  };
+
+  export type TextInputFocusEvent = FocusEvent & TextInputEvent;
+
+  /**
+   * Shared base props for the TextInput component.
+   *
+   * These props control the visual wrapper (InputEnclosure) and
+   * common text-input behaviors.
+   */
+  interface TextInputBaseProps {
+    /** Input contents are not used (TextInput manages its own <input>) */
+    children?: never;
+
+    /** Reference to the underlying input element */
+    ref?: HTMLInputElement | null;
+
+    /** Visual size token (e.g. small, normal, large) */
+    size?: ComponentSize;
+
+    /** Border radius token (e.g. 1–3, "pill") */
+    roundness?: ComponentRoundnessShape;
+
+    /** Render an outlined enclosure (shows border) */
+    outline?: boolean;
+
+    /** Custom CSS class names applied to the InputEnclosure */
+    class?: string;
+
+    /** Disabled state of the input */
+    disabled?: boolean;
+
+    /**
+     * Error visual state.
+     *
+     * When true, applies error styling to the enclosure.
+     * Intended for validation errors.
+     */
+    error?: boolean;
+
+    /**
+     * Focused visual state.
+     *
+     * When true, forces focused styling on the enclosure.
+     * Usually controlled automatically via focus/blur.
+     */
+    focused?: boolean;
+
+    /**
+     * Content rendered before the input (prefix).
+     *
+     * Use {#snippet before} in Svelte.
+     */
+    before?: Snippet;
+
+    /**
+     * Content rendered after the input (suffix).
+     *
+     * Use {#snippet after} in Svelte.
+     */
+    after?: Snippet;
+  }
+
+  /**
+   * TextInput component props.
+   *
+   * Renders a semantic <input type="text"> wrapped in InputEnclosure.
+   * Inherits all native HTML input attributes (placeholder, value, name, etc.).
+   */
+  export type TextInputProps = TextInputBaseProps & Omit<HTMLInputAttributes, 'size' | 'children'>;
+</script>
+
+<script lang="ts">
+  import type { ComponentSize } from '$lib/attributes/size.js';
+  import type { ComponentRoundnessShape } from '$lib/attributes/roundness.js';
+  import InputEnclosure from '../InputEnclosure/InputEnclosure.svelte';
+
+  let {
+    ref = $bindable(null),
+    size = 'normal',
+    roundness = 1,
+    outline = true,
+    class: className = '',
+    disabled = false,
+    error = false,
+    focused: forcedFocused = false,
+    before,
+    after,
+    onfocus,
+    onblur,
+    ...restProps
+  }: TextInputProps = $props();
+
+  /**
+   * Local focus state used to drive InputEnclosure focus styling.
+   */
+  let isFocused = $state(false);
+
+  function handleFocus(event: FocusEvent) {
+    isFocused = true;
+    onfocus?.(event as TextInputFocusEvent);
+  }
+
+  function handleBlur(event: FocusEvent) {
+    isFocused = false;
+    onblur?.(event as TextInputFocusEvent);
+  }
+
+  /**
+   * Computed class list for the InputEnclosure component.
+   */
+  const classes = $derived(['dodo-ui-TextInput', className].filter(Boolean));
+</script>
+
+<InputEnclosure
+  {size}
+  {roundness}
+  {outline}
+  {disabled}
+  {error}
+  focused={forcedFocused || isFocused}
+  class={classes.join(' ')}
+  {before}
+  {after}
+>
+  <input
+    {...restProps}
+    bind:this={ref}
+    {disabled}
+    onfocus={handleFocus}
+    onblur={handleBlur}
+    class="InputBox"
+  />
+</InputEnclosure>

package/src/lib/components/Form/UtilityButton/UtilityButton.scss

@@ -0,0 +1,151 @@
+@use '../../../styles/scss/mixins/utility-button-color' as buttons;
+
+// ----------------------------------------
+// Config
+// ----------------------------------------
+$dodo-utility-button-themes: neutral, primary, secondary, safe, warning, danger;
+
+// ----------------------------------------
+// Theme tokens (global CSS variables)
+// ----------------------------------------
+:root {
+  --dodo-ui-UtilityButton-disabled-color: var(--dodo-color-neutral-400);
+  --dodo-ui-UtilityButton-disabled-bg: var(--dodo-color-neutral-200);
+
+  @each $theme in $dodo-utility-button-themes {
+    // Fixed: Added buttons. prefix
+    @include buttons.generate-dodo-ui-utility-button-colors($theme, light);
+  }
+}
+
+.dodo-theme--dark {
+  --dodo-ui-UtilityButton-disabled-bg: var(--dodo-color-neutral-100);
+  --dodo-ui-UtilityButton-disabled-color: var(--dodo-color-neutral-500);
+
+  @each $theme in $dodo-utility-button-themes {
+    // Fixed: Added buttons. prefix
+    @include buttons.generate-dodo-ui-utility-button-colors($theme, dark);
+  }
+}
+
+// ----------------------------------------
+// SCSS maps
+// ----------------------------------------
+
+$roundness: (
+  1: var(--dodo-ui-element-roundness-1),
+  2: var(--dodo-ui-element-roundness-2),
+  3: var(--dodo-ui-element-roundness-3),
+  pill: 999px,
+  full: 50%,
+);
+
+// ----------------------------------------
+// Component CSS
+// ----------------------------------------
+.dodo-ui-UtilityButton {
+  cursor: pointer;
+  transition:
+    background-color 70ms,
+    color 70ms,
+    border-color 70ms;
+  text-decoration: none;
+  margin: 0;
+  display: inline-flex;
+  justify-content: center;
+  align-items: center;
+  font-family: inherit;
+  background-color: transparent;
+  border-style: solid;
+  border-width: var(--dodo-ui-element-border-width);
+  border-color: transparent;
+  color: inherit;
+  letter-spacing: 0.3px;
+
+  // ----------------------------------------
+  // Sizes
+  // ----------------------------------------
+  &.size {
+    &--normal {
+      height: calc(var(--dodo-ui-element-height-normal) / 1.2);
+      font-size: 0.9rem;
+      padding: 0 calc(var(--dodo-ui-space-small) * 2);
+      min-width: 35px;
+    }
+
+    &--small {
+      height: calc(var(--dodo-ui-element-height-small) / 1.2);
+      padding: 0 var(--dodo-ui-space);
+      font-size: 0.8rem;
+      min-width: 25px;
+    }
+
+    &--large {
+      height: calc(var(--dodo-ui-element-height-large) / 1.2);
+      font-size: 1rem;
+      padding: 0 calc(var(--dodo-ui-space) * 2);
+      min-width: 55px;
+    }
+  }
+
+  // ----------------------------------------
+  // Roundness
+  // ----------------------------------------
+  &.roundness {
+    @each $name, $radius in $roundness {
+      &--#{$name} {
+        border-radius: $radius;
+      }
+    }
+  }
+
+  // ----------------------------------------
+  // Theme colors
+  // ----------------------------------------
+  &.color {
+    @each $theme in $dodo-utility-button-themes {
+      // Fixed: Added buttons. prefix
+      @include buttons.generate-dodo-ui-utility-button-color($theme);
+    }
+  }
+
+  // ----------------------------------------
+  // Disabled
+  // ----------------------------------------
+  &[disabled] {
+    cursor: not-allowed;
+    pointer-events: none;
+    background-color: var(--dodo-ui-UtilityButton-disabled-bg);
+    color: var(--dodo-ui-UtilityButton-disabled-color);
+
+    &.outline {
+      border-color: transparent;
+    }
+  }
+
+  // ----------------------------------------
+  // Compact
+  // ----------------------------------------
+  &.compact {
+    &.size {
+      &--normal,
+      &--small,
+      &--large {
+        min-width: initial;
+        padding: 0;
+      }
+
+      &--normal {
+        width: calc(var(--dodo-ui-element-height-normal) / 1.2);
+      }
+
+      &--small {
+        width: calc(var(--dodo-ui-element-height-small) / 1.2);
+      }
+
+      &--large {
+        width: calc(var(--dodo-ui-element-height-large) / 1.2);
+      }
+    }
+  }
+}

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

@@ -0,0 +1,154 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import UtilityButton from './UtilityButton.svelte';
+  import type { UtilityButtonProps } from './UtilityButton.svelte';
+  import type { ArgTypes } from 'storybook/internal/csf';
+  import { componentColorOptions } from '$lib/attributes/color.js';
+  import { componentSizeOptions } from '$lib/attributes/size.js';
+  import { componentRoundnessOptions } from '$lib/attributes/roundness.js';
+  import Theme from '$lib/components/Layout/Theme/Theme.svelte';
+
+  // ------------------------------
+  // Storybook ArgTypes
+  // ------------------------------
+  export const storyUtilityButtonArgTypes: Partial<ArgTypes<UtilityButtonProps>> = {
+    // ------------------------------
+    // Core
+    // ------------------------------
+    children: { table: { category: 'API', subcategory: 'Base' } },
+    href: {
+      control: { type: 'text' },
+      description: 'Render as Anchor when provided',
+      table: { category: 'API', subcategory: 'Base' },
+    },
+    disabled: {
+      control: { type: 'boolean' },
+      description: 'Disable interactions',
+      table: { category: 'API', subcategory: 'Base' },
+    },
+    class: { table: { category: 'API', subcategory: 'Base' } },
+    type: { table: { category: 'API', subcategory: 'Base' } },
+
+    // ------------------------------
+    // Appearance
+    // ------------------------------
+    color: {
+      control: { type: 'select' },
+      options: componentColorOptions,
+      description: 'Color theme token',
+      table: { category: 'API', subcategory: 'Appearance', defaultValue: { summary: 'primary' } },
+    },
+    size: {
+      control: { type: 'select' },
+      options: componentSizeOptions,
+      description: 'Visual size token',
+      table: { category: 'API', subcategory: 'Appearance', defaultValue: { summary: 'normal' } },
+    },
+    roundness: {
+      control: { type: 'select' },
+      options: componentRoundnessOptions,
+      description: 'Border radius token',
+      table: { category: 'API', subcategory: 'Appearance' },
+    },
+    compact: {
+      control: { type: 'boolean' },
+      description: 'Compact spacing (icon buttons)',
+      table: { category: 'API', subcategory: 'Appearance' },
+    },
+    outline: {
+      control: { type: 'boolean' },
+      description: 'Render outlined style',
+      table: { category: 'API', subcategory: 'Appearance' },
+    },
+
+    // ------------------------------
+    // Accessibility
+    // ------------------------------
+    'aria-label': {
+      control: { type: 'text' },
+      description: 'Accessible label (required for icon-only buttons)',
+      table: { category: 'API', subcategory: 'Accessibility' },
+    },
+
+    // ------------------------------
+    // Events (Svelte-style)
+    // ------------------------------
+    onclick: { table: { category: 'API', subcategory: 'Events' }, action: 'click' },
+  };
+
+  // ------------------------------
+  // Storybook Meta
+  // ------------------------------
+  const { Story } = defineMeta({
+    component: UtilityButton,
+    tags: ['autodocs'],
+    argTypes: storyUtilityButtonArgTypes,
+  });
+</script>
+
+<!-- ------------------------------ -->
+<!-- Stories -->
+<!-- ------------------------------ -->
+
+<!-- A Button to be used with other components. -->
+<Story name="Primary">Click me!</Story>
+
+<Story name="Neutral" args={{ color: 'neutral', outline: true }}>Click me!</Story>
+
+<Story
+  name="OnClick (Actions)"
+  args={{
+    onclick: (e: Event) => {
+      const target = e.target as HTMLButtonElement;
+      alert('UtilityButton Clicked');
+      console.log('UtilityButton Clicked', target);
+    },
+  }}
+>
+  Click me
+</Story>
+
+<Story name="Outline" args={{ outline: true }}>Click me!</Story>
+
+<Story name="Large UtilityButton" args={{ size: 'large' }}>Large</Story>
+
+<Story name="Disabled" args={{ disabled: true }}>Click me!</Story>
+
+<Story name="Safe" args={{ color: 'safe' }}>Safe</Story>
+
+<Story name="Danger / Outline" args={{ color: 'danger', outline: true }}>Danger</Story>
+
+<Story name="Light Theme" asChild>
+  <Theme type="light">
+    <UtilityButton>Hello</UtilityButton>
+  </Theme>
+</Story>
+
+<Story name="Dark Theme" asChild globals={{ backgrounds: { value: 'dark' } }}>
+  <Theme type="dark">
+    <UtilityButton>Hello</UtilityButton>
+  </Theme>
+</Story>
+
+<Story name="Submit UtilityButton" args={{ type: 'submit' }}>Submit Form</Story>
+
+<Story
+  name="Link UtilityButton"
+  args={{
+    href: 'https://www.w3schools.com/tags/tag_a.asp',
+    target: '_blank',
+  }}
+>
+  External Link
+</Story>
+
+<Story
+  name="Icon Only (A11y Example)"
+  args={{
+    compact: true,
+    roundness: 'full',
+    'aria-label': 'Add item',
+  }}
+>
+  +
+</Story>