@flightlesslabs/dodo-ui-date 0.2.0

package/src/lib/components/Calendar/Calendar.stories.svelte

@@ -0,0 +1,136 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Calendar from './Calendar.svelte';
+  import type { CalendarProps } from './Calendar.svelte';
+  import type { ArgTypes } from 'storybook/internal/csf';
+  import { CalendarDate, type DateValue } from '@internationalized/date';
+  import {
+    cardColorOptions,
+    componentRoundnessOptions,
+    ComponentShadowOptions,
+    componentThemeColorsOptions,
+    componentVariantOptions,
+    Theme,
+  } from '@flightlesslabs/dodo-ui';
+
+  const description = `
+ a plug and play Calendar component based on bits-ui [calendar](https://bits-ui.com/docs/components/calendar).
+
+ \`\`\`ts
+ import { Calendar } from '@flightlesslabs/dodo-ui-date';
+ \`\`\`
+`;
+
+  // ------------------------------
+  // Storybook ArgTypes
+  // ------------------------------
+  export const storyCalendarArgTypes: Partial<ArgTypes<CalendarProps>> = {
+    // ------------------------------
+    // Core
+    // ------------------------------
+    class: { table: { category: 'API', subcategory: 'Base' } },
+    value: {
+      control: { type: 'text' },
+      table: { category: 'API', subcategory: 'Base' },
+    },
+
+    // ------------------------------
+    // State
+    // ------------------------------
+    disabled: {
+      control: { type: 'boolean' },
+      description: 'Disabled state of the input',
+      table: { category: 'API', subcategory: 'State', defaultValue: { summary: 'false' } },
+    },
+
+    // ------------------------------
+    // Appearance
+    // ------------------------------
+    shadow: {
+      control: { type: 'select' },
+      options: ComponentShadowOptions,
+      description: 'Component Shadow',
+      table: { category: 'API', subcategory: 'Appearance', defaultValue: { summary: '1' } },
+    },
+    color: {
+      control: { type: 'select' },
+      options: cardColorOptions,
+      description: 'Color theme token',
+      table: { category: 'API', subcategory: 'Appearance', defaultValue: { summary: 'default' } },
+    },
+    variant: {
+      control: { type: 'select' },
+      options: componentVariantOptions,
+      description: 'Visual variant of the card',
+      table: { category: 'API', subcategory: 'Appearance', defaultValue: { summary: 'text' } },
+    },
+    roundness: {
+      control: { type: 'select' },
+      options: componentRoundnessOptions,
+      description: 'Border radius token',
+      table: { category: 'API', subcategory: 'Appearance' },
+    },
+    outline: {
+      control: { type: 'boolean' },
+      description: 'Render outlined style',
+      table: { category: 'API', subcategory: 'Appearance' },
+    },
+    active: {
+      control: { type: 'boolean' },
+      description: 'Add mouse hover and active effects',
+      table: { category: 'API', subcategory: 'Appearance' },
+    },
+    theme: {
+      control: { type: 'select' },
+      options: componentThemeColorsOptions,
+      description: 'Theme color',
+      table: { category: 'API', subcategory: 'Base', defaultValue: { summary: 'undefined' } },
+    },
+  };
+
+  // ------------------------------
+  // Storybook Meta
+  // ------------------------------
+  const { Story } = defineMeta({
+    component: Calendar,
+    tags: ['autodocs'],
+    argTypes: storyCalendarArgTypes,
+    parameters: {
+      docs: {
+        description: {
+          component: description,
+        },
+      },
+    },
+  });
+
+  let myValue = $state<DateValue>(new CalendarDate(2026, 4, 7));
+</script>
+
+<!-- ------------------------------ -->
+<!-- Stories -->
+<!-- ------------------------------ -->
+
+<Story name="Default" />
+
+<Story name="Controlled" asChild>
+  <Calendar bind:value={myValue} />
+</Story>
+
+<Story name="Starts On Sunday" args={{ weekStartsOn: 0 }} />
+
+<Story name="Min Date" args={{ minValue: new CalendarDate(2026, 4, 7) }} />
+
+<Story name="Max Date" args={{ maxValue: new CalendarDate(2026, 4, 7) }} />
+
+<Story name="Light Theme" asChild>
+  <Theme type="light">
+    <Calendar />
+  </Theme>
+</Story>
+
+<Story name="Dark Theme" asChild globals={{ backgrounds: { value: 'dark' } }}>
+  <Theme type="dark">
+    <Calendar />
+  </Theme>
+</Story>

package/src/lib/components/Calendar/Calendar.svelte

@@ -0,0 +1,59 @@
+<script lang="ts" module>
+  export type CalendarProps = Omit<CalendarSingleRootProps, 'type'> &
+    Omit<CardProps, 'children' | 'ref'>;
+</script>
+
+<script lang="ts">
+  import { Calendar as CalendarBitsUi, type CalendarSingleRootProps } from 'bits-ui';
+  import Header from './Header.svelte';
+  import CalendarGrid from './CalendarGrid/CalendarGrid.svelte';
+  import { useThemeContext, type CardProps } from '@flightlesslabs/dodo-ui';
+  let {
+    roundness = 1,
+    outline = true,
+    class: className = '',
+    theme: cardTheme,
+    color = 'default',
+    variant = 'text',
+    shadow = 0,
+    active = false,
+    weekStartsOn = 1,
+    weekdayFormat = 'short',
+    fixedWeeks = true,
+    value = $bindable(undefined),
+    ...restProps
+  }: CalendarProps = $props();
+
+  const themeContext = useThemeContext();
+  const theme = $derived(cardTheme ? cardTheme : themeContext.theme);
+
+  const popupClasses = $derived(
+    [
+      'dodo-ui-Card',
+      'dodo-ui-Calendar',
+      `color--${color}`,
+      `variant--${variant}`,
+      `roundness--${roundness}`,
+      `dodo-shadow-${shadow}`,
+      outline && 'outline',
+      active && 'active',
+      theme ? `dodo-theme--${theme}` : '',
+      className,
+    ].filter(Boolean),
+  );
+</script>
+
+<CalendarBitsUi.Root
+  {...restProps}
+  {weekStartsOn}
+  {weekdayFormat}
+  {fixedWeeks}
+  bind:value
+  type="single"
+  class={popupClasses.join(' ')}
+>
+  {#snippet children(calendarRootSnippetProps)}
+    <Header />
+    <CalendarGrid {...calendarRootSnippetProps} />
+  {/snippet}
+</CalendarBitsUi.Root>

package/src/lib/components/Calendar/CalendarGrid/CalendarGrid.svelte

@@ -0,0 +1,16 @@
+<script lang="ts">
+  import { Calendar, type CalendarRootSnippetProps } from 'bits-ui';
+  import TableHead from './TableHead.svelte';
+  import TableBody from './TableBody.svelte';
+
+  let { months, weekdays }: CalendarRootSnippetProps = $props();
+</script>
+
+<div class="CalendarGrid">
+  {#each months as month (month.value)}
+    <Calendar.Grid>
+      <TableHead {weekdays} />
+      <TableBody {month} />
+    </Calendar.Grid>
+  {/each}
+</div>

package/src/lib/components/Calendar/CalendarGrid/TableBody.svelte

@@ -0,0 +1,25 @@
+<script lang="ts">
+  import type { DateValue } from '@internationalized/date';
+  import { Calendar, type Month } from 'bits-ui';
+
+  type Props = {
+    month: Month<DateValue>;
+  };
+
+  let { month }: Props = $props();
+</script>
+
+<Calendar.GridBody>
+  {#each month.weeks as weekDates (weekDates)}
+    <Calendar.GridRow>
+      {#each weekDates as date (date)}
+        <Calendar.Cell {date} month={month.value}>
+          <Calendar.Day>
+            <div></div>
+            {date.day}
+          </Calendar.Day>
+        </Calendar.Cell>
+      {/each}
+    </Calendar.GridRow>
+  {/each}
+</Calendar.GridBody>

package/src/lib/components/Calendar/CalendarGrid/TableHead.svelte

@@ -0,0 +1,19 @@
+<script lang="ts">
+  import { Calendar } from 'bits-ui';
+
+  type Props = {
+    weekdays: string[];
+  };
+
+  let { weekdays }: Props = $props();
+</script>
+
+<Calendar.GridHead>
+  <Calendar.GridRow>
+    {#each weekdays as day (day)}
+      <Calendar.HeadCell>
+        <div>{day.slice(0, 2)}</div>
+      </Calendar.HeadCell>
+    {/each}
+  </Calendar.GridRow>
+</Calendar.GridHead>

package/src/lib/components/Calendar/Header.svelte

@@ -0,0 +1,25 @@
+<script lang="ts">
+  import Icon from '@iconify/svelte';
+  import { Calendar } from 'bits-ui';
+
+  const triggerClasses = $derived(
+    [
+      'dodo-ui-Button',
+      'compact',
+      'size--normal',
+      'variant--text',
+      'color--primary',
+      'roundness--1',
+    ].filter(Boolean),
+  );
+</script>
+
+<Calendar.Header>
+  <Calendar.PrevButton class={triggerClasses.join(' ')}>
+    <Icon icon="material-symbols:chevron-left-rounded" />
+  </Calendar.PrevButton>
+  <Calendar.Heading />
+  <Calendar.NextButton class={triggerClasses.join(' ')}>
+    <Icon icon="material-symbols:chevron-right-rounded" />
+  </Calendar.NextButton>
+</Calendar.Header>

package/src/lib/components/DatePicker/DatePicker.scss

@@ -0,0 +1,55 @@
+.dodo-ui-DatePicker {
+  button[data-popover-trigger] {
+    font-size: 1.4em;
+  }
+
+  [data-date-field-input] {
+    display: flex;
+    align-items: center;
+  }
+
+  [data-date-field-segment] {
+    height: 80%;
+    display: inline-flex;
+    align-items: center;
+  }
+
+  [data-segment='literal'] {
+    color: var(--dodo-color-neutral-500);
+  }
+
+  // ----------------------------------------
+  // Sizes
+  // ----------------------------------------
+  &.size {
+    &--normal {
+      button[data-popover-trigger] {
+        margin: 0 calc(var(--dodo-ui-space) / 2.5);
+      }
+
+      [data-date-field-segment] {
+        padding: 0 calc(var(--dodo-ui-space) / 3);
+      }
+    }
+
+    &--small {
+      button[data-popover-trigger] {
+        margin: 0 calc(var(--dodo-ui-space--small) / 2.5);
+      }
+
+      [data-date-field-segment] {
+        padding: 0 calc(var(--dodo-ui-space-small) / 3);
+      }
+    }
+
+    &--large {
+      button[data-popover-trigger] {
+        margin: 0 calc(var(--dodo-ui-space--large) / 2.5);
+      }
+
+      [data-date-field-segment] {
+        padding: 0 calc(var(--dodo-ui-space-large) / 3);
+      }
+    }
+  }
+}

package/src/lib/components/DatePicker/DatePicker.stories.svelte

@@ -0,0 +1,136 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import DatePicker from './DatePicker.svelte';
+  import type { DatePickerProps } from './DatePicker.svelte';
+  import type { ArgTypes } from 'storybook/internal/csf';
+  import { CalendarDate, type DateValue } from '@internationalized/date';
+  import { componentSizeOptions, componentRoundnessOptions, Theme } from '@flightlesslabs/dodo-ui';
+
+  const description = `
+ A sleek, plug and play Date Picker based on bits-ui [date-picker](https://bits-ui.com/docs/components/date-picker).
+ \`\`\`ts
+ import { DatePicker } from '@flightlesslabs/dodo-ui-date';
+
+import { CalendarDate, type DateValue } from '@internationalized/date';
+ \`\`\`
+`;
+
+  // ------------------------------
+  // Storybook ArgTypes
+  // ------------------------------
+  export const storyDatePickerArgTypes: Partial<ArgTypes<DatePickerProps>> = {
+    // ------------------------------
+    // Core
+    // ------------------------------
+    class: { table: { category: 'API', subcategory: 'Base' } },
+    value: {
+      control: { type: 'text' },
+      table: { category: 'API', subcategory: 'Base' },
+    },
+    dateFormat: {
+      control: { type: 'text' },
+      table: { category: 'API', subcategory: 'Base', defaultValue: { summary: 'dd/mm/yyyy' } },
+    },
+
+    // ------------------------------
+    // 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',
+    },
+  };
+
+  // ------------------------------
+  // Storybook Meta
+  // ------------------------------
+  const { Story } = defineMeta({
+    component: DatePicker,
+    tags: ['autodocs'],
+    argTypes: storyDatePickerArgTypes,
+    parameters: {
+      docs: {
+        description: {
+          component: description,
+        },
+        story: { height: '420px' },
+      },
+    },
+  });
+
+  let myValue = $state<DateValue>(new CalendarDate(2026, 4, 7));
+</script>
+
+<!-- ------------------------------ -->
+<!-- Stories -->
+<!-- ------------------------------ -->
+
+<Story name="Default" />
+
+<Story name="Controlled" asChild>
+  <DatePicker bind:value={myValue} />
+</Story>
+
+<Story name="Starts On Sunday" args={{ weekStartsOn: 0 }} />
+
+<Story name="Date Format" args={{ dateFormat: 'mm/dd/yyyy' }} />
+
+<Story name="Min Date" args={{ minValue: new CalendarDate(2026, 4, 7) }} />
+
+<Story name="Max Date" args={{ maxValue: new CalendarDate(2026, 4, 7) }} />
+
+<Story name="Light Theme" asChild>
+  <Theme type="light">
+    <DatePicker />
+  </Theme>
+</Story>
+
+<Story name="Dark Theme" asChild globals={{ backgrounds: { value: 'dark' } }}>
+  <Theme type="dark">
+    <DatePicker />
+  </Theme>
+</Story>

package/src/lib/components/DatePicker/DatePicker.svelte

@@ -0,0 +1,134 @@
+<script lang="ts" module>
+  export type DatePickerProps = DatePickerRootPropsWithoutHTML & {
+    /** 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;
+
+    /**
+     * 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;
+
+    /** Select placeholder */
+    placeholder?: string;
+
+    /**
+     * Date display format for the input segments.
+     *
+     * Controls the visual order and separators of the date parts
+     * (e.g. "dd/mm/yyyy", "mm-dd-yyyy", "yyyy.mm.dd").
+     *
+     * This only affects how the date is rendered in the input,
+     * not the internal parsing or keyboard interaction behavior
+     * of the DatePicker.
+     */
+    dateFormat?: DatePickerFormat;
+
+    /** bits ui dateFieldInputProps */
+    dateFieldInputProps?: DateFieldInputProps;
+
+    /** bits ui datePickerTriggerProps */
+    datePickerTriggerProps?: DatePickerTriggerProps;
+
+    /** Props for Popup */
+    popupProps?: DatePickerPopupProps;
+  };
+</script>
+
+<script lang="ts">
+  import {
+    DatePicker as DatePickerBitsUi,
+    type DateFieldInputProps,
+    type DatePickerRootPropsWithoutHTML,
+    type DatePickerTriggerProps,
+  } from 'bits-ui';
+  import type { Snippet } from 'svelte';
+  import DatepickerInput from './DatePickerInput/DatePickerInput.svelte';
+  import type { DatePickerFormat } from './DatePickerInput/utils.js';
+  import DatePickerPopup, {
+    type DatePickerPopupProps,
+  } from './DatePickerPopup/DatePickerPopup.svelte';
+  import type { ComponentSize, ComponentRoundnessShape } from '@flightlesslabs/dodo-ui';
+
+  let {
+    size = 'normal',
+    roundness = 1,
+    outline = true,
+    class: className = '',
+    disabled = false,
+    error = false,
+    focused: forcedFocused = false,
+    before,
+    after,
+    open = $bindable(false),
+    value = $bindable(undefined),
+    placeholder,
+    weekdayFormat = 'short',
+    fixedWeeks = true,
+    dateFieldInputProps,
+    datePickerTriggerProps,
+    weekStartsOn = 1,
+    dateFormat = 'dd/mm/yyyy',
+    popupProps,
+    ...restProps
+  }: DatePickerProps = $props();
+</script>
+
+<DatePickerBitsUi.Root
+  {...restProps}
+  bind:value
+  bind:open
+  {weekdayFormat}
+  {weekStartsOn}
+  {fixedWeeks}
+>
+  <DatepickerInput
+    {size}
+    {roundness}
+    {outline}
+    class={className}
+    {disabled}
+    {error}
+    {dateFieldInputProps}
+    {datePickerTriggerProps}
+    focused={forcedFocused}
+    {before}
+    {after}
+    {placeholder}
+    {dateFormat}
+  />
+  <DatePickerPopup {...popupProps} />
+</DatePickerBitsUi.Root>