@flightlesslabs/dodo-ui 0.20.0 → 0.22.0

package/dist/components/Layout/Grid/Column/Column.stories.svelte

@@ -0,0 +1,66 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Column, { gridColumnSizeOptions } from './Column.svelte';
+  import type { GridColumnProps } from './Column.svelte';
+  import type { ArgTypes } from 'storybook/internal/csf';
+
+  // ------------------------------
+  // Storybook ArgTypes
+  // ------------------------------
+  export const storyColumnArgTypes: Partial<ArgTypes<GridColumnProps>> = {
+    // ------------------------------
+    // Core
+    // ------------------------------
+    children: { table: { category: 'API', subcategory: 'Base' } },
+    class: { table: { category: 'API', subcategory: 'Base' } },
+
+    // ------------------------------
+    // Size
+    // ------------------------------
+    size: {
+      control: { type: 'select' },
+      options: gridColumnSizeOptions,
+      table: { category: 'API', subcategory: 'Size', defaultValue: { summary: '12' } },
+    },
+    sm: {
+      control: { type: 'select' },
+      options: gridColumnSizeOptions,
+      table: { category: 'API', subcategory: 'Size' },
+    },
+    md: {
+      control: { type: 'select' },
+      options: gridColumnSizeOptions,
+      table: { category: 'API', subcategory: 'Size' },
+    },
+    lg: {
+      control: { type: 'select' },
+      options: gridColumnSizeOptions,
+      table: { category: 'API', subcategory: 'Size' },
+    },
+    xl: {
+      control: { type: 'select' },
+      options: gridColumnSizeOptions,
+      table: { category: 'API', subcategory: 'Size' },
+    },
+    xxl: {
+      control: { type: 'select' },
+      options: gridColumnSizeOptions,
+      table: { category: 'API', subcategory: 'Size' },
+    },
+  };
+
+  // ------------------------------
+  // Storybook Meta
+  // ------------------------------
+  const { Story } = defineMeta({
+    component: Column,
+    tags: ['autodocs'],
+    argTypes: storyColumnArgTypes,
+  });
+</script>
+
+<!-- ------------------------------ -->
+<!-- Stories -->
+<!-- ------------------------------ -->
+
+<Story name="Default">Hello there</Story>

package/dist/components/Layout/Grid/Column/Column.stories.svelte.d.ts

@@ -0,0 +1,22 @@
+import Column from './Column.svelte';
+import type { GridColumnProps } from './Column.svelte';
+import type { ArgTypes } from 'storybook/internal/csf';
+export declare const storyColumnArgTypes: Partial<ArgTypes<GridColumnProps>>;
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const Column: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type Column = InstanceType<typeof Column>;
+export default Column;

package/dist/components/Layout/Grid/Column/Column.svelte

@@ -0,0 +1,79 @@
+<script lang="ts" module>
+  import type { Snippet } from 'svelte';
+
+  export const GRID_COLUMN_BREAKPOINT = {
+    numerical: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12],
+    flex: ['flex'],
+  } as const;
+
+  export type GridColumnSizeNumerical = (typeof GRID_COLUMN_BREAKPOINT.numerical)[number];
+  type GridColumnSizeFlex = (typeof GRID_COLUMN_BREAKPOINT.flex)[number];
+  export type GridColumnSize = GridColumnSizeNumerical | GridColumnSizeFlex;
+
+  export const gridColumnSizeOptions = [
+    ...GRID_COLUMN_BREAKPOINT.numerical,
+    ...GRID_COLUMN_BREAKPOINT.flex,
+  ] as const satisfies readonly GridColumnSize[];
+
+  export const gridColumnSizeNumericalOptions = GRID_COLUMN_BREAKPOINT.numerical;
+
+  export interface GridColumnProps {
+    /** Custom CSS class names */
+    class?: string;
+
+    /** Column contents go here */
+    children?: Snippet;
+
+    /** GridColumn ref */
+    ref?: HTMLDivElement | null;
+
+    /** Breakpoint: size (default unit) */
+    size?: GridColumnSize;
+
+    /** Breakpoint: sm */
+    sm?: GridColumnSize;
+
+    /** Breakpoint: md */
+    md?: GridColumnSize;
+
+    /** Breakpoint: lg */
+    lg?: GridColumnSize;
+
+    /** Breakpoint: xl */
+    xl?: GridColumnSize;
+
+    /** Breakpoint: xxl */
+    xxl?: GridColumnSize;
+  }
+</script>
+
+<script lang="ts">
+  let {
+    class: className = '',
+    ref = $bindable(null),
+    children,
+    size = 12,
+    sm,
+    md,
+    lg,
+    xl,
+    xxl,
+  }: GridColumnProps = $props();
+
+  const classes = $derived(
+    [
+      'dodo-ui-Grid-Column',
+      `column-size--default--${size}`,
+      sm ? `column-size--sm--${sm}` : '',
+      md ? `column-size--md--${md}` : '',
+      lg ? `column-size--lg--${lg}` : '',
+      xl ? `column-size--xl--${xl}` : '',
+      xxl ? `column-size--xxl--${xxl}` : '',
+      className,
+    ].filter(Boolean),
+  );
+</script>
+
+<div class={classes.join(' ')} bind:this={ref}>
+  {@render children?.()}
+</div>

package/dist/components/Layout/Grid/Column/Column.svelte.d.ts

@@ -0,0 +1,33 @@
+import type { Snippet } from 'svelte';
+export declare const GRID_COLUMN_BREAKPOINT: {
+    readonly numerical: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12];
+    readonly flex: readonly ["flex"];
+};
+export type GridColumnSizeNumerical = (typeof GRID_COLUMN_BREAKPOINT.numerical)[number];
+type GridColumnSizeFlex = (typeof GRID_COLUMN_BREAKPOINT.flex)[number];
+export type GridColumnSize = GridColumnSizeNumerical | GridColumnSizeFlex;
+export declare const gridColumnSizeOptions: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, "flex"];
+export declare const gridColumnSizeNumericalOptions: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12];
+export interface GridColumnProps {
+    /** Custom CSS class names */
+    class?: string;
+    /** Column contents go here */
+    children?: Snippet;
+    /** GridColumn ref */
+    ref?: HTMLDivElement | null;
+    /** Breakpoint: size (default unit) */
+    size?: GridColumnSize;
+    /** Breakpoint: sm */
+    sm?: GridColumnSize;
+    /** Breakpoint: md */
+    md?: GridColumnSize;
+    /** Breakpoint: lg */
+    lg?: GridColumnSize;
+    /** Breakpoint: xl */
+    xl?: GridColumnSize;
+    /** Breakpoint: xxl */
+    xxl?: GridColumnSize;
+}
+declare const Column: import("svelte").Component<GridColumnProps, {}, "ref">;
+type Column = ReturnType<typeof Column>;
+export default Column;

package/dist/components/Layout/Grid/Grid.scss

@@ -0,0 +1,8 @@
+// Grid
+
+.dodo-ui-Grid {
+  display: flex;
+  width: 100%;
+  flex-wrap: wrap;
+  margin: calc(calc(var(--dodo-ui-space) * var(--Grid-gap)) * -1);
+}

package/dist/components/Layout/Grid/Grid.stories.svelte

@@ -0,0 +1,177 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Grid from './Grid.svelte';
+  import type { GridProps } from './Grid.svelte';
+  import type { ArgTypes } from 'storybook/internal/csf';
+  import Column from './Column/Column.svelte';
+  import Card from '../Card/Card.svelte';
+  import Row from './Row/Row.svelte';
+
+  // ------------------------------
+  // Storybook ArgTypes
+  // ------------------------------
+  export const storyGridArgTypes: Partial<ArgTypes<GridProps>> = {
+    // ------------------------------
+    // Core
+    // ------------------------------
+    children: { table: { category: 'API', subcategory: 'Base' } },
+    class: { table: { category: 'API', subcategory: 'Base' } },
+    gap: { table: { category: 'API', subcategory: 'Base', defaultValue: { summary: '1' } } },
+  };
+
+  // ------------------------------
+  // Storybook Meta
+  // ------------------------------
+  const { Story } = defineMeta({
+    component: Grid,
+    tags: ['autodocs'],
+    argTypes: storyGridArgTypes,
+  });
+</script>
+
+<!-- ------------------------------ -->
+<!-- Stories -->
+<!-- ------------------------------ -->
+
+<!-- Basic 12 column grid -->
+<Story name="Default">
+  <Column sm={4}>Hello there</Column>
+  <Column sm={4}>Hello there</Column>
+  <Column sm={4}>Hello there</Column>
+  <Column sm={4}>Hello there</Column>
+  <Column sm={4}>Hello there</Column>
+</Story>
+
+<Story name="Example">
+  <Column sm={4}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column sm={4}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column sm={4}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column sm={4}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+</Story>
+
+<Story name="Grid Row">
+  <Row>
+    <Column sm={6} md={4} lg={3}>
+      <Card color="primary">
+        <p>Hello there</p>
+      </Card>
+    </Column>
+    <Column sm={6} md={4} lg={3}>
+      <Card color="primary">
+        <p>Hello there</p>
+      </Card>
+    </Column>
+    <Column sm={6} md={4} lg={3}>
+      <Card color="primary">
+        <p>Hello there</p>
+      </Card>
+    </Column>
+  </Row>
+  <Row>
+    <Column sm={6} md={4} lg={3}>
+      <Card color="primary">
+        <p>Hello there</p>
+      </Card>
+    </Column>
+    <Column sm={6} md={4} lg={3}>
+      <Card color="primary">
+        <p>Hello there</p>
+      </Card>
+    </Column>
+    <Column sm={6} md={4} lg={3}>
+      <Card color="primary">
+        <p>Hello there</p>
+      </Card>
+    </Column>
+  </Row>
+</Story>
+
+<Story name="Gap" args={{ gap: 2 }}>
+  <Column sm={4}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column sm={4}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column sm={4}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column sm={4}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+</Story>
+
+<Story name="Responsive">
+  <Column sm={6} md={4} lg={3}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column sm={6} md={4} lg={3}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column sm={6} md={4} lg={3}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column sm={6} md={4} lg={3}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column sm={6} md={4} lg={3}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column sm={6} md={4} lg={3}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+</Story>
+
+<Story name="Flex">
+  <Column md="flex">
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column md={2}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+  <Column md={2}>
+    <Card color="primary">
+      <p>Hello there</p>
+    </Card>
+  </Column>
+</Story>

package/dist/components/Layout/Grid/Grid.stories.svelte.d.ts

@@ -0,0 +1,22 @@
+import Grid from './Grid.svelte';
+import type { GridProps } from './Grid.svelte';
+import type { ArgTypes } from 'storybook/internal/csf';
+export declare const storyGridArgTypes: Partial<ArgTypes<GridProps>>;
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const Grid: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type Grid = InstanceType<typeof Grid>;
+export default Grid;

package/dist/components/Layout/Grid/Grid.svelte

@@ -0,0 +1,32 @@
+<script lang="ts" module>
+  import type { Snippet } from 'svelte';
+
+  export interface GridProps {
+    /** Custom CSS class names */
+    class?: string;
+
+    /** Grid contents go here*/
+    children?: Snippet;
+
+    /** Grid spacing, affects Coulumns */
+    gap?: number;
+  }
+</script>
+
+<script lang="ts">
+  let { class: className = '', gap = 1, children }: GridProps = $props();
+
+  function normalizeGap(value: number) {
+    return value === 0 ? 0 : value / 2;
+  }
+
+  const gapHalf = $derived(normalizeGap(gap));
+
+  const classes = $derived(['dodo-ui-Grid', className].filter(Boolean));
+
+  const inlineStyles = $derived([`--Grid-gap: ${gapHalf}`].filter(Boolean));
+</script>
+
+<div class={classes.join(' ')} style={inlineStyles.join(';')}>
+  {@render children?.()}
+</div>

package/dist/components/Layout/Grid/Grid.svelte.d.ts

@@ -0,0 +1,12 @@
+import type { Snippet } from 'svelte';
+export interface GridProps {
+    /** Custom CSS class names */
+    class?: string;
+    /** Grid contents go here*/
+    children?: Snippet;
+    /** Grid spacing, affects Coulumns */
+    gap?: number;
+}
+declare const Grid: import("svelte").Component<GridProps, {}, "">;
+type Grid = ReturnType<typeof Grid>;
+export default Grid;

package/dist/components/Layout/Grid/Row/Row.scss

@@ -0,0 +1,7 @@
+// Grid-Row
+
+.dodo-ui-Grid-Row {
+  display: flex;
+  width: 100%;
+  flex-wrap: wrap;
+}

package/dist/components/Layout/Grid/Row/Row.stories.svelte

@@ -0,0 +1,39 @@
+<script module lang="ts">
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+  import Row from './Row.svelte';
+  import type { GridRowProps } from './Row.svelte';
+  import type { ArgTypes } from 'storybook/internal/csf';
+  import Column from '../Column/Column.svelte';
+
+  // ------------------------------
+  // Storybook ArgTypes
+  // ------------------------------
+  export const storyRowArgTypes: Partial<ArgTypes<GridRowProps>> = {
+    // ------------------------------
+    // Core
+    // ------------------------------
+    children: { table: { category: 'API', subcategory: 'Base' } },
+    class: { table: { category: 'API', subcategory: 'Base' } },
+  };
+
+  // ------------------------------
+  // Storybook Meta
+  // ------------------------------
+  const { Story } = defineMeta({
+    component: Row,
+    tags: ['autodocs'],
+    argTypes: storyRowArgTypes,
+  });
+</script>
+
+<!-- ------------------------------ -->
+<!-- Stories -->
+<!-- ------------------------------ -->
+
+<Story name="Default">
+  <Column sm={4}>Hello there</Column>
+  <Column sm={4}>Hello there</Column>
+  <Column sm={4}>Hello there</Column>
+  <Column sm={4}>Hello there</Column>
+  <Column sm={4}>Hello there</Column>
+</Story>

package/dist/components/Layout/Grid/Row/Row.stories.svelte.d.ts

@@ -0,0 +1,22 @@
+import Row from './Row.svelte';
+import type { GridRowProps } from './Row.svelte';
+import type { ArgTypes } from 'storybook/internal/csf';
+export declare const storyRowArgTypes: Partial<ArgTypes<GridRowProps>>;
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const Row: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type Row = InstanceType<typeof Row>;
+export default Row;

package/dist/components/Layout/Grid/Row/Row.svelte

@@ -0,0 +1,21 @@
+<script lang="ts" module>
+  import type { Snippet } from 'svelte';
+
+  export interface GridRowProps {
+    /** Custom CSS class names */
+    class?: string;
+
+    /** GridRow contents go here*/
+    children?: Snippet;
+  }
+</script>
+
+<script lang="ts">
+  let { class: className = '', children }: GridRowProps = $props();
+
+  const classes = $derived(['dodo-ui-Grid-Row', className].filter(Boolean));
+</script>
+
+<div class={classes.join(' ')}>
+  {@render children?.()}
+</div>

package/dist/components/Layout/Grid/Row/Row.svelte.d.ts

@@ -0,0 +1,10 @@
+import type { Snippet } from 'svelte';
+export interface GridRowProps {
+    /** Custom CSS class names */
+    class?: string;
+    /** GridRow contents go here*/
+    children?: Snippet;
+}
+declare const Row: import("svelte").Component<GridRowProps, {}, "">;
+type Row = ReturnType<typeof Row>;
+export default Row;

package/dist/components/Layout/Theme/ThemeSystem/index.mdx

@@ -1,53 +1,53 @@
-import { Source } from '@storybook/addon-docs/blocks';
-
-# 🎨 Theme System
-
-A lightweight theme system built using context + local store.
-
-## 🧩 Theme Context
-
-### 📦 Import
-
-<Source
-  dark
-  language="ts"
-  code={`
-import { useThemeContext } from '@flightlesslabs/dodo-ui';
-`}
-/>
-
-Provides access to the active theme.
-
-### Usage
-
-<Source
-  dark
-  language="ts"
-  code={`
-const { theme } = useThemeContext();
-`}
-/>
-
-## 🏪 Theme Store
-
-Global theme state.
-
-### 📦 Import
-
-<Source
-  dark
-  language="ts"
-  code={`
-import { useThemeStore } from '@flightlesslabs/dodo-ui';
-`}
-/>
-
-### Read
-
-<Source
-  dark
-  language="ts"
-  code={`
-const theme = useThemeStore.theme;
-`}
-/>
+import { Source } from '@storybook/addon-docs/blocks';
+
+# 🎨 Theme System
+
+A lightweight theme system built using context + local store.
+
+## 🧩 Theme Context
+
+### 📦 Import
+
+<Source
+  dark
+  language="ts"
+  code={`
+import { useThemeContext } from '@flightlesslabs/dodo-ui';
+`}
+/>
+
+Provides access to the active theme.
+
+### Usage
+
+<Source
+  dark
+  language="ts"
+  code={`
+const { theme } = useThemeContext();
+`}
+/>
+
+## 🏪 Theme Store
+
+Global theme state.
+
+### 📦 Import
+
+<Source
+  dark
+  language="ts"
+  code={`
+import { useThemeStore } from '@flightlesslabs/dodo-ui';
+`}
+/>
+
+### Read
+
+<Source
+  dark
+  language="ts"
+  code={`
+const theme = useThemeStore.theme;
+`}
+/>

package/dist/index.d.ts

@@ -53,6 +53,12 @@ export { useThemeStore } from './components/Layout/Theme/ThemeSystem/theme.svelt
  * Card component and related prop types.
  */
 export { CARD_COLOR, default as Card, cardColorOptions, type CardColor, type CardProps, } from './components/Layout/Card/Card.svelte';
+/**
+ * Grid component and related prop types.
+ */
+export { default as Grid, type GridProps } from './components/Layout/Grid/Grid.svelte';
+export { GRID_COLUMN_BREAKPOINT, default as Column, gridColumnSizeOptions, gridColumnSizeNumericalOptions, type GridColumnProps, type GridColumnSizeNumerical, type GridColumnSize, } from './components/Layout/Grid/Column/Column.svelte';
+export { default as Row, type GridRowProps } from './components/Layout/Grid/Row/Row.svelte';
 /**
  * Calendar component and related prop types.
  */