@flightlesslabs/dodo-ui 0.22.2 → 0.23.0

package/src/lib/storybook-types.ts

@@ -1,182 +0,0 @@
-type ControlType =
-  | 'object'
-  | 'boolean'
-  | 'check'
-  | 'inline-check'
-  | 'radio'
-  | 'inline-radio'
-  | 'select'
-  | 'multi-select'
-  | 'number'
-  | 'range'
-  | 'file'
-  | 'color'
-  | 'date'
-  | 'text';
-
-interface ControlBase {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  [key: string]: any;
-  /** @see https://storybook.js.org/docs/api/arg-types#controltype */
-  type?: ControlType;
-  disable?: boolean;
-}
-
-type Control =
-  | ControlType
-  | false
-  | (ControlBase &
-      (
-        | ControlBase
-        | {
-            type: 'color';
-            /** @see https://storybook.js.org/docs/api/arg-types#controlpresetcolors */
-            presetColors?: string[];
-          }
-        | {
-            type: 'file';
-            /** @see https://storybook.js.org/docs/api/arg-types#controlaccept */
-            accept?: string;
-          }
-        | {
-            type: 'inline-check' | 'radio' | 'inline-radio' | 'select' | 'multi-select';
-            /** @see https://storybook.js.org/docs/api/arg-types#controllabels */
-            labels?: {
-              [options: string]: string;
-            };
-          }
-        | {
-            type: 'number' | 'range';
-            /** @see https://storybook.js.org/docs/api/arg-types#controlmax */
-            max?: number;
-            /** @see https://storybook.js.org/docs/api/arg-types#controlmin */
-            min?: number;
-            /** @see https://storybook.js.org/docs/api/arg-types#controlstep */
-            step?: number;
-          }
-      ));
-
-type ConditionalTest =
-  | {
-      truthy?: boolean;
-    }
-  | {
-      exists: boolean;
-    }
-  | {
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      eq: any;
-    }
-  | {
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      neq: any;
-    };
-type ConditionalValue =
-  | {
-      arg: string;
-    }
-  | {
-      global: string;
-    };
-type Conditional = ConditionalValue & ConditionalTest;
-
-interface Args {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  [name: string]: any;
-}
-
-interface SBBaseType {
-  required?: boolean;
-  raw?: string;
-}
-type SBScalarType = SBBaseType & {
-  name: 'boolean' | 'string' | 'number' | 'function' | 'symbol';
-};
-type SBArrayType = SBBaseType & {
-  name: 'array';
-  value: SBType;
-};
-type SBObjectType = SBBaseType & {
-  name: 'object';
-  value: Record<string, SBType>;
-};
-type SBEnumType = SBBaseType & {
-  name: 'enum';
-  value: (string | number)[];
-};
-type SBIntersectionType = SBBaseType & {
-  name: 'intersection';
-  value: SBType[];
-};
-type SBUnionType = SBBaseType & {
-  name: 'union';
-  value: SBType[];
-};
-type SBOtherType = SBBaseType & {
-  name: 'other';
-  value: string;
-};
-
-type SBType =
-  | SBScalarType
-  | SBEnumType
-  | SBArrayType
-  | SBObjectType
-  | SBIntersectionType
-  | SBUnionType
-  | SBOtherType;
-
-interface InputType {
-  /** @see https://storybook.js.org/docs/api/arg-types#control */
-  control?: Control;
-  /** @see https://storybook.js.org/docs/api/arg-types#description */
-  description?: string;
-  /** @see https://storybook.js.org/docs/api/arg-types#if */
-  if?: Conditional;
-  /** @see https://storybook.js.org/docs/api/arg-types#mapping */
-  mapping?: {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    [key: string]: any;
-  };
-  /** @see https://storybook.js.org/docs/api/arg-types#name */
-  name?: string;
-  /** @see https://storybook.js.org/docs/api/arg-types#options */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  options?: readonly any[];
-  /** @see https://storybook.js.org/docs/api/arg-types#table */
-  table?: {
-    [key: string]: unknown;
-    /** @see https://storybook.js.org/docs/api/arg-types#tablecategory */
-    category?: string;
-    /** @see https://storybook.js.org/docs/api/arg-types#tabledefaultvalue */
-    defaultValue?: {
-      summary?: string;
-      detail?: string;
-    };
-    /** @see https://storybook.js.org/docs/api/arg-types#tabledisable */
-    disable?: boolean;
-    /** @see https://storybook.js.org/docs/api/arg-types#tablesubcategory */
-    subcategory?: string;
-    /** @see https://storybook.js.org/docs/api/arg-types#tabletype */
-    type?: {
-      summary?: string;
-      detail?: string;
-    };
-  };
-  /** @see https://storybook.js.org/docs/api/arg-types#type */
-  type?: SBType | SBScalarType['name'];
-  /**
-   * @deprecated Use `table.defaultValue.summary` instead.
-   * @see https://storybook.js.org/docs/api/arg-types#defaultvalue
-   */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  defaultValue?: any;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  [key: string]: any;
-}
-
-export type ArgTypes<TArgs = Args> = {
-  [name in keyof TArgs]: InputType;
-};
-
-export type StoryBookArgTypes = Partial<ArgTypes<Args>>;

package/src/lib/utils/time/date-creator/createDate/createDate.mdx

@@ -1,98 +0,0 @@
-# createDate
-
-A centralized date factory built on top of `dayjs`.
-
-This utility ensures **consistent parsing, timezone handling, and validation** across your application.
-
-## 📦 Import
-
-```ts
-import { createDate } from '@flightlesslabs/dodo-ui';
-```
-
-## 🚀 Basic Usage
-
-### Current Date
-
-```ts
-const now = createDate();
-console.log(now.format());
-```
-
-
-### Parse a Date
-
-```ts
-const date = createDate("01-02-2025", "DD-MM-YYYY");
-console.log(date.format());
-```
-
-## 🌍 Timezone & UTC
-
-### UTC Mode
-
-```ts
-const utcDate = createDate("2025-01-01T12:00:00Z", undefined, {
-  utc: true,
-});
-```
-
-### Timezone Conversion
-
-```ts
-const indiaTime = createDate("01-01-2025", "DD-MM-YYYY", {
-  timezone: "Asia/Kolkata",
-});
-```
-
-## ⚙️ Options
-
-```ts
-interface CreateDateOptions {
-  timezone?: string;
-  utc?: boolean;
-  strict?: boolean;
-  throwOnInvalid?: boolean;
-}
-```
-
-## 🔁 Behavior Priority
-
-1. utc (highest priority)
-2. timezone
-3. local
-
----
-
-### timezone
-
-- IANA timezone string
-- Interprets input in given timezone
-
----
-
-### utc
-
-- Forces UTC mode
-
----
-
-### strict
-
-- Only applies when format is provided
-- Has no effect on ISO / timestamps
-
----
-
-### throwOnInvalid
-
-- Throws error if date is invalid
-
----
-
-## 📥 Supported Inputs
-
-- string
-- number (timestamp)
-- Date object
-- undefined

package/src/lib/utils/time/date-creator/createDateFactory/createDateFactory.mdx

@@ -1,104 +0,0 @@
-# createDateFactory
-
-A **factory function** that creates a `createDate` utility with an optional custom `dayjs` instance.
-
-This allows advanced users to:
-
-- Inject their own configured `dayjs`
-- Share plugins across multiple libraries
-- Avoid global `dayjs.extend` pollution
-- Create isolated date environments
-
----
-
-## 📦 Import
-
-```ts
-import { createDateFactory } from '@flightlesslabs/dodo-ui';
-```
-
----
-
-## 🚀 Basic Usage
-
-### Default Factory
-
-```ts
-import { createDateFactory } from '@flightlesslabs/dodo-ui';
-
-const { createDate } = createDateFactory();
-
-const now = createDate();
-console.log(now.format());
-```
-
----
-
-## 🧠 Why Use a Factory?
-
-Instead of relying on global `dayjs.extend`, you can:
-
-- isolate plugin setups
-- avoid conflicts in monorepos
-- support multiple configurations
-- improve testability
-
----
-
-## 🔌 Custom Dayjs Instance
-
-### Inject your own configured instance
-
-```ts
-import dayjs from 'dayjs';
-import utc from 'dayjs/plugin/utc';
-import timezone from 'dayjs/plugin/timezone';
-
-dayjs.extend(utc);
-dayjs.extend(timezone);
-
-const { createDate } = createDateFactory(dayjs);
-
-const date = createDate("2025-01-01", "YYYY-MM-DD");
-```
-
----
-
-## ⚙️ Behavior
-
-The factory wraps your `dayjs` instance and preserves:
-
-- UTC handling
-- Timezone support
-- Strict parsing
-- Validation options
-
----
-
-## 🔁 Priority Order
-
-1. utc (highest priority)
-2. timezone
-3. local parsing
-
----
-
-## 📥 Returned API
-
-```ts
-{
-  createDate: Function,
-  dayjs: DayjsInstance
-}
-```
-
-## 🧪 Example: Multiple Factories
-
-
-```ts
-const factoryA = createDateFactory(dayjsA);
-const factoryB = createDateFactory(dayjsB);
-
-factoryA.createDate("2025-01-01");
-factoryB.createDate("2025-01-01");
-```

package/src/lib/utils/time/timeout/timeout.mdx

@@ -1,114 +0,0 @@
-# timeout
-
-A simple utility to delay execution using Promises.
-
-Useful for **pausing async workflows**, **simulating delays**, or **controlling execution timing**.
-
----
-
-## 📦 Import
-
-```ts
-import { timeout } from '@flightlesslabs/dodo-ui';
-```
-
----
-
-## 🚀 Basic Usage
-
-
-
-```ts
-await timeout(1000); // waits 1 second
-```
-
----
-
-## 🎯 Resolve with Value
-
-You can optionally pass a value that will be returned after the delay.
-
-```ts
-const result = await timeout(500, "done");
-
-console.log(result); // "done"
-```
-
----
-
-## ⚙️ API
-
-```ts
-function timeout<T = void>(
-  milliseconds: number,
-  value?: T
-): Promise<T>
-```
-
----
-
-### `milliseconds`
-
-- Time to wait before resolving (in ms)
-- Must be `>= 0`
-
----
-
-### `value`
-
-- Optional value to resolve with
-- Defaults to `undefined`
-
----
-
-## ⚠️ Error Handling
-
-If a negative duration is provided, the promise will reject:
-
-```ts
-await timeout(-1); // ❌ throws Error
-```
-
----
-
-## 🧠 Use Cases
-
-- Delay execution in async functions
-- Simulate API latency in tests
-- Simple throttling or pacing logic
-
----
-
-## 🔍 Examples
-
-### Async Flow
-
-```ts
-async function run() {
-  console.log("Start");
-
-await timeout(1000);
-
-console.log("End");
-}
-```
-
----
-
-### With Data
-
-<Source
-  dark
-  language="ts"
-  code={`
-const data = await timeout(300, { success: true });
-
-console.log(data.success); // true
-`}
-/>
-
-```ts
-const data = await timeout(300, { success: true });
-
-console.log(data.success); // true
-```