@flightlesslabs/dodo-ui 0.19.1 → 0.21.0

package/dist/stories/developer tools/customize/AutoCustomize/Tool/Tool.stories.svelte.d.ts

@@ -1,19 +0,0 @@
-import Tool from './Tool.svelte';
-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 Tool: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
-    [evt: string]: CustomEvent<any>;
-}, {}, {}, string>;
-type Tool = InstanceType<typeof Tool>;
-export default Tool;

package/dist/stories/developer tools/customize/AutoCustomize/Tool/Tool.svelte

@@ -1,13 +0,0 @@
-<script lang="ts">import Config from './Config/Config.svelte';
-import Preview from './Preview/Preview.svelte';
-</script>
-
-<div class="Tool">
-  <Config />
-  <Preview />
-</div>
-
-<style>.Tool {
-  display: flex;
-  flex-wrap: wrap;
-}</style>

package/dist/stories/developer tools/customize/AutoCustomize/Tool/Tool.svelte.d.ts

@@ -1,18 +0,0 @@
-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 Tool: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
-    [evt: string]: CustomEvent<any>;
-}, {}, {}, string>;
-type Tool = InstanceType<typeof Tool>;
-export default Tool;

package/dist/stories/developer tools/customize/AutoCustomize/Tool/helpers/download-file.d.ts

@@ -1 +0,0 @@
-export declare function downloadFile(fileName: string, data: Blob): Promise<void>;

package/dist/stories/developer tools/customize/AutoCustomize/Tool/helpers/download-file.js

@@ -1,10 +0,0 @@
-import { saveAs } from 'file-saver';
-export async function downloadFile(fileName, data) {
-    try {
-        saveAs(data, fileName);
-        return Promise.resolve();
-    }
-    catch (e) {
-        return Promise.reject(e);
-    }
-}

package/dist/stories/developer tools/customize/AutoCustomize/Tool/stores/config.svelte.d.ts

@@ -1,27 +0,0 @@
-export type AutoCustomizeConfigDataColors = {
-    primary?: string;
-    secondary?: string;
-    neutral?: string;
-    safe?: string;
-    warning?: string;
-    danger?: string;
-};
-export type AutoCustomizeConfigDataComponents = {
-    roundness?: number;
-    elementHeight?: number;
-    borderWidth?: number;
-};
-export type AutoCustomizeConfigData = {
-    colors?: AutoCustomizeConfigDataColors;
-    components?: AutoCustomizeConfigDataComponents;
-    space?: number;
-};
-export declare const autoCustomizeConfigdefaultData: AutoCustomizeConfigData;
-export declare const useAutoCustomizeConfigStore: {
-    readonly data: AutoCustomizeConfigData;
-    readonly updatedAt: number;
-    updateData(newData: Partial<AutoCustomizeConfigData>): void;
-    updateDataColor(newData: Partial<AutoCustomizeConfigDataColors>): void;
-    updateDataComponents(newData: Partial<AutoCustomizeConfigDataComponents>): void;
-    reset(): void;
-};

package/dist/stories/developer tools/customize/AutoCustomize/Tool/stores/config.svelte.js

@@ -1,70 +0,0 @@
-import { browser } from '$app/environment';
-const AUTO_CUSTOMIZE_TOOL_CONFIG = 'AUTO_CUSTOMIZE_TOOL_CONFIG';
-export const autoCustomizeConfigdefaultData = {
-    colors: {
-        primary: 'violet',
-        secondary: 'blue',
-        neutral: 'gray',
-        safe: 'emerald',
-        warning: 'amber',
-        danger: 'red',
-    },
-    components: {
-        roundness: 0,
-        elementHeight: 0,
-        borderWidth: 0,
-    },
-    space: 0,
-};
-function getDefaultData() {
-    if (!browser) {
-        return autoCustomizeConfigdefaultData;
-    }
-    let values = JSON.parse(localStorage.getItem(AUTO_CUSTOMIZE_TOOL_CONFIG) || `{}`);
-    values = { ...autoCustomizeConfigdefaultData, ...values };
-    return values;
-}
-function createAutoCustomizeConfigStore() {
-    let updatedAt = $state(Date.now());
-    let data = $state(getDefaultData());
-    return {
-        get data() {
-            return data;
-        },
-        get updatedAt() {
-            return updatedAt;
-        },
-        updateData(newData) {
-            data = {
-                ...data,
-                ...newData,
-            };
-            updatedAt = Date.now();
-            if (browser) {
-                localStorage.setItem(AUTO_CUSTOMIZE_TOOL_CONFIG, JSON.stringify(newData));
-            }
-        },
-        updateDataColor(newData) {
-            const colors = {
-                ...data.colors,
-                ...newData,
-            };
-            this.updateData({ colors });
-        },
-        updateDataComponents(newData) {
-            const components = {
-                ...data.components,
-                ...newData,
-            };
-            this.updateData({ components });
-        },
-        reset() {
-            data = autoCustomizeConfigdefaultData;
-            updatedAt = Date.now();
-            if (browser) {
-                localStorage.setItem(AUTO_CUSTOMIZE_TOOL_CONFIG, JSON.stringify(autoCustomizeConfigdefaultData));
-            }
-        },
-    };
-}
-export const useAutoCustomizeConfigStore = createAutoCustomizeConfigStore();

package/dist/stories/developer tools/customize/Intro.mdx

@@ -1,8 +0,0 @@
-# Customize
-
-Use our [Auto Customize](?path=/docs/developer-tools-customize-autocustomize--docs) to modify the look and feel of the components.
-
-## Explore More
-
-- [Tailwind CSS Color Generator](https://uicolors.app/generate/)
-- [Colors](?path=/docs/developer-tools-philosophy-colors--docs)

package/dist/stories/developer tools/directives/clickOutside/clickOutside.d.ts

@@ -1,3 +0,0 @@
-export declare function clickOutside(node: Element, callback: () => void): {
-    destroy(): void;
-};

package/dist/stories/developer tools/directives/clickOutside/clickOutside.js

@@ -1,14 +0,0 @@
-export function clickOutside(node, callback) {
-    const handleClick = (event) => {
-        const target = event.target;
-        if (node && !node.contains(target) && !event.defaultPrevented) {
-            callback();
-        }
-    };
-    document.addEventListener('click', handleClick, true);
-    return {
-        destroy() {
-            document.removeEventListener('click', handleClick, true);
-        },
-    };
-}

package/dist/stories/developer tools/directives/clickOutside/index.mdx

@@ -1,25 +0,0 @@
-import { Source } from '@storybook/addon-docs/blocks';
-
-# Click Outside
-
-Event that fires after clicking outside the target component
-
-<Source
-  dark
-  language="js"
-  code={`
-import { clickOutside } '@flightlesslabs/dodo-ui';
-`}
-/>
-
-Attach it to a component
-
-<Source
-  dark
-  language="js"
-  code={`
-<div
-  use:clickOutside={onClickOutside}
-  ...
-`}
-/>

package/dist/stories/developer tools/directives/drag/drag.d.ts

@@ -1,3 +0,0 @@
-export declare function drag(node: HTMLElement): {
-    destroy(): void;
-};

package/dist/stories/developer tools/directives/drag/drag.js

@@ -1,40 +0,0 @@
-export function drag(node) {
-    let dragging = false;
-    function getX(e) {
-        return 'touches' in e ? e.touches[0].clientX : e.clientX;
-    }
-    function handleStart(e) {
-        dragging = true;
-        const x = getX(e);
-        node.dispatchEvent(new CustomEvent('dragstart', { detail: { x } }));
-        window.addEventListener('mousemove', handleMove);
-        window.addEventListener('mouseup', handleEnd);
-        window.addEventListener('touchmove', handleMove);
-        window.addEventListener('touchend', handleEnd);
-    }
-    function handleMove(e) {
-        if (!dragging)
-            return;
-        const x = getX(e);
-        node.dispatchEvent(new CustomEvent('dragging', { detail: { x } }));
-    }
-    function handleEnd(e) {
-        if (!dragging)
-            return;
-        dragging = false;
-        const x = getX(e);
-        node.dispatchEvent(new CustomEvent('dragend', { detail: { x } }));
-        window.removeEventListener('mousemove', handleMove);
-        window.removeEventListener('mouseup', handleEnd);
-        window.removeEventListener('touchmove', handleMove);
-        window.removeEventListener('touchend', handleEnd);
-    }
-    node.addEventListener('mousedown', handleStart);
-    node.addEventListener('touchstart', handleStart, { passive: true });
-    return {
-        destroy() {
-            node.removeEventListener('mousedown', handleStart);
-            node.removeEventListener('touchstart', handleStart);
-        },
-    };
-}

package/dist/stories/developer tools/helpers/Numbers/cleanNumericString/cleanNumericString.d.ts

@@ -1,13 +0,0 @@
-/**
- * Cleans the input string by removing all characters except numeric digits (0-9) and a single decimal point.
- * Only the first decimal point is retained; all subsequent dots are removed.
- *
- * @param {string} input - The input string to be cleaned.
- * @returns {string} - A string containing only digits and at most one decimal point.
- *
- * @example
- * cleanNumericString("abc123.45.67def"); // returns "123.4567"
- * cleanNumericString("a1b2c3");          // returns "123"
- * cleanNumericString("...12.3.4..5");    // returns "12.345"
- */
-export default function cleanNumericString(input: string): string;

package/dist/stories/developer tools/helpers/Numbers/cleanNumericString/cleanNumericString.js

@@ -1,26 +0,0 @@
-/**
- * Cleans the input string by removing all characters except numeric digits (0-9) and a single decimal point.
- * Only the first decimal point is retained; all subsequent dots are removed.
- *
- * @param {string} input - The input string to be cleaned.
- * @returns {string} - A string containing only digits and at most one decimal point.
- *
- * @example
- * cleanNumericString("abc123.45.67def"); // returns "123.4567"
- * cleanNumericString("a1b2c3");          // returns "123"
- * cleanNumericString("...12.3.4..5");    // returns "12.345"
- */
-export default function cleanNumericString(input) {
-    // Remove all characters except digits and dots
-    const filtered = input.replace(/[^0-9.]/g, '');
-    // Split by dot to separate parts
-    const parts = filtered.split('.');
-    if (parts.length === 1) {
-        // No dot present, just digits
-        return parts[0];
-    }
-    else {
-        // Keep only first dot, join the rest parts without dots
-        return parts[0] + '.' + parts.slice(1).join('');
-    }
-}

package/dist/stories/developer tools/helpers/Numbers/cleanNumericString/index.mdx

@@ -1,20 +0,0 @@
-import { Source } from '@storybook/addon-docs/blocks';
-
-# `cleanNumericString`
-
-Cleans the input string by removing all characters except numeric digits (0-9) and a single decimal point.
-Only the first decimal point is retained; all subsequent dots are removed.
-
----
-
-## Basic Usage
-
-<Source
-  dark
-  language="ts"
-  code={`
-import { cleanNumericString } from '@flightlesslabs/dodo-ui';
-
-const result = cleanNumericString("abc123.45.67def"); // result === "123.4567"
-`}
-/>

package/dist/stories/developer tools/helpers/Numbers/isValidNumberValue/index.mdx

@@ -1,71 +0,0 @@
-import { Source } from '@storybook/addon-docs/blocks';
-
-# `isValidNumberValue`
-
-Utility function to validate whether a string is a valid number based on customizable settings including minimum, maximum, decimal places, and allowance of negative numbers.
-
----
-
-## Basic Usage
-
-Validates a string as a number with default settings (no decimals allowed, no negatives allowed, strict checking):
-
-<Source
-  dark
-  language="ts"
-  code={`
-import { isValidNumberValue } from '@flightlesslabs/dodo-ui';
-
-const result = isValidNumberValue("123");
-console.log(result); // true
-`}
-/>
-
----
-
-## With Settings
-
-Customize validation rules:
-
-- `min` — minimum allowed value (inclusive)
-- `max` — maximum allowed value (inclusive)
-- `allowNegativeValues` — whether negatives are allowed
-- `decimalPlaces` — max decimal places allowed
-- `log` — enable detailed logging
-- `strict` — Strict checking, Full text - keep it enabled, Partial text - keep it disabled
-
-<Source
-  dark
-  language="ts"
-  code={`
-import { isValidNumberValue } from '@flightlesslabs/dodo-ui';
-
-const result1 = isValidNumberValue("123.456", { decimalPlaces: 3, log: true });
-const result2 = isValidNumberValue("-50", { allowNegativeValues: true, min: -100 });
-const result3 = isValidNumberValue("200", { max: 150 });
-
-const result4 = isValidNumberValue("-", { allowNegativeValues: true });
-const result5 = isValidNumberValue("-", { allowNegativeValues: true, strict: false });
-
-console.log(result1); // true
-console.log(result2); // true
-console.log(result3); // false (exceeds max)
-console.log(result4); // false (fails in strict check)
-console.log(result5); // true (pass in strict check)
-`}
-/>
-
----
-
-## Type Definition
-
-```ts
-export type IsValidNumberValueSettings = {
-  min?: number;
-  max?: number;
-  allowNegativeValues?: boolean;
-  decimalPlaces?: number;
-  log?: boolean;
-  strict?: boolean;
-};
-```

package/dist/stories/developer tools/helpers/Numbers/isValidNumberValue/isValidNumberValue.d.ts

@@ -1,51 +0,0 @@
-export type IsValidNumberValueSettings = {
-    /**
-     * Minimum allowed numeric value (inclusive).
-     */
-    min?: number;
-    /**
-     * Maximum allowed numeric value (inclusive).
-     */
-    max?: number;
-    /**
-     * Whether negative numbers are allowed.
-     * Defaults to false.
-     */
-    allowNegativeValues?: boolean;
-    /**
-     * Maximum allowed decimal places.
-     * Defaults to 0 (no decimals allowed).
-     */
-    decimalPlaces?: number;
-    /**
-     * Whether to enable logging.
-     * Defaults to false.
-     */
-    log?: boolean;
-    /**
-     * Strict checking, Full text - keep it enabled, Partial text - keep it disabled
-     * Defaults to true.
-     */
-    strict?: boolean;
-};
-/**
- * Validates whether a string represents a valid number based on provided settings.
- *
- * @param value - The string to validate as a number.
- * @param settings - Optional validation settings.
- * @param settings.min - Minimum allowed value (inclusive).
- * @param settings.max - Maximum allowed value (inclusive).
- * @param settings.allowNegativeValues - Whether negative numbers are allowed.
- * @param settings.decimalPlaces - Maximum allowed decimal places.
- * @param settings.log - Whether to enable detailed logging.
- * @param settings.strict - Whether to enable Strict checking, Full text - keep it enabled, Partial text - keep it disabled
- *
- * @returns True if the value is a valid number according to the settings; otherwise false.
- *
- * @example
- * ```ts
- * isValidNumberValue("123.45", { decimalPlaces: 2, log: true });
- * isValidNumberValue("-50", { allowNegativeValues: true, min: -100 });
- * ```
- */
-export default function isValidNumberValue(value: string, settings?: IsValidNumberValueSettings): boolean;

package/dist/stories/developer tools/helpers/Numbers/isValidNumberValue/isValidNumberValue.js

@@ -1,96 +0,0 @@
-import createLogger from '../../logger/logger.js';
-/**
- * Checks if the input string is a valid numeric string.
- * Allows integers, decimals, negative numbers, and scientific notation.
- *
- * @param str - Input string to validate.
- * @returns True if string is numeric, false otherwise.
- */
-function isNumericString(str) {
-    if (typeof str !== 'string')
-        return false;
-    const trimmed = str.trim();
-    if (trimmed === '')
-        return false;
-    const num = Number(trimmed);
-    return !isNaN(num) && isFinite(num);
-}
-/**
- * Validates whether a string represents a valid number based on provided settings.
- *
- * @param value - The string to validate as a number.
- * @param settings - Optional validation settings.
- * @param settings.min - Minimum allowed value (inclusive).
- * @param settings.max - Maximum allowed value (inclusive).
- * @param settings.allowNegativeValues - Whether negative numbers are allowed.
- * @param settings.decimalPlaces - Maximum allowed decimal places.
- * @param settings.log - Whether to enable detailed logging.
- * @param settings.strict - Whether to enable Strict checking, Full text - keep it enabled, Partial text - keep it disabled
- *
- * @returns True if the value is a valid number according to the settings; otherwise false.
- *
- * @example
- * ```ts
- * isValidNumberValue("123.45", { decimalPlaces: 2, log: true });
- * isValidNumberValue("-50", { allowNegativeValues: true, min: -100 });
- * ```
- */
-export default function isValidNumberValue(value, settings) {
-    const allowNegativeValues = settings?.allowNegativeValues || false;
-    const decimalPlaces = settings?.decimalPlaces || 0;
-    const valueFormatted = value.trim();
-    const log = settings?.log || false;
-    const logger = createLogger({
-        label: 'isValidNumberValue',
-        show: log,
-    });
-    const min = settings?.min;
-    const max = settings?.max;
-    const strict = settings?.strict === false ? false : true;
-    logger.info(`Validating value: "${valueFormatted}"`);
-    if (strict && !isNumericString(valueFormatted)) {
-        logger.warn('Invalid input: strict checking is enaabled and the text failed the checks');
-        return false;
-    }
-    if (valueFormatted === '') {
-        logger.info('Valid input: Blank value');
-        return true;
-    }
-    if (allowNegativeValues && valueFormatted === '-') {
-        logger.info(`Valid input: Single '-' sign allowed as a negative placeholder.`);
-        return true;
-    }
-    if (!decimalPlaces && valueFormatted.includes('.')) {
-        logger.warn('Invalid input: Decimals not allowed');
-        return false;
-    }
-    const dotCount = (valueFormatted.match(/\./g) || []).length;
-    if (dotCount > 1) {
-        logger.warn('Invalid input: More than one decimal point detected.');
-        return false;
-    }
-    const parts = valueFormatted.split('.');
-    if (parts[1]?.length > decimalPlaces) {
-        logger.warn(`Invalid input: Number has ${parts[1].length} decimal places, exceeding the allowed limit of ${decimalPlaces}.`);
-        return false;
-    }
-    if (!isNumericString(valueFormatted)) {
-        logger.warn('Invalid input: String is not a valid number.');
-        return false;
-    }
-    const numericValue = Number(valueFormatted);
-    if (!allowNegativeValues && numericValue < 0) {
-        logger.warn('Invalid input: Negative numbers are not allowed.');
-        return false;
-    }
-    if (min !== undefined && numericValue < min) {
-        logger.warn(`Invalid input: Number ${numericValue} is less than the minimum allowed value of ${min}.`);
-        return false;
-    }
-    if (max !== undefined && numericValue > max) {
-        logger.warn(`Invalid input: Number ${numericValue} exceeds the maximum allowed value of ${max}.`);
-        return false;
-    }
-    logger.info('Validation passed: Input is a valid number according to the provided settings.');
-    return true;
-}

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

@@ -1,39 +0,0 @@
-import type { ConfigType, OptionType } from 'dayjs';
-import dayjs from 'dayjs';
-type Dayjs = ReturnType<typeof dayjs>;
-/**
- * Acceptable input types for the `getMoment` function, compatible with dayjs.
- */
-export type GetMomentDate = ConfigType;
-/**
- * Optional formatting string used to parse the date.
- */
-export type GetMomentFormat = OptionType;
-/**
- * Settings to control how the moment is returned (UTC, timezone, or local).
- */
-export interface GetMomentSettings {
-    /**
-     * Timezone string (e.g., "America/New_York").
-     */
-    timezone?: string;
-    /**
-     * 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 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', 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;
-export {};

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

@@ -1,33 +0,0 @@
-import dayjs from 'dayjs';
-import utc from 'dayjs/plugin/utc.js';
-import timezone from 'dayjs/plugin/timezone.js';
-import customParseFormat from 'dayjs/plugin/customParseFormat.js';
-dayjs.extend(utc);
-dayjs.extend(timezone);
-dayjs.extend(customParseFormat);
-/**
- * A wrapper around dayjs to return a moment-like object with optional formatting,
- * timezone, or UTC handling.
- *
- * @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', 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 ?? false;
-    if (utc) {
-        return dayjs.utc(dayjs(date, format));
-    }
-    else if (timezone) {
-        return dayjs.tz(dayjs(date, format), timezone);
-    }
-    else {
-        return dayjs(date, format);
-    }
-}

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

@@ -1,45 +0,0 @@
-import { Source } from '@storybook/addon-docs/blocks';
-
-# `getMoment`
-
-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
-
-<Source
-  dark
-  language="ts"
-  code={`
-// 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"
-`}
-/>
-
----
-
-## API
-
-<Source
-  dark
-  language="ts"
-  code={`
-getMoment(
-  date?: ConfigType,
-  format?: string,
-  settings?: {
-    utc?: boolean;
-    timezone?: string;
-  }
-): dayjs.Dayjs
-`}
-/>