dash-ui-kit 1.0.2

package/dist/react/components/text/index.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import { VariantProps } from 'class-variance-authority';
+declare const textStyles: (props?: ({
+    reset?: boolean | null | undefined;
+    theme?: "light" | "dark" | null | undefined;
+    color?: "default" | "red" | "blue" | "blue-dark" | null | undefined;
+    size?: "sm" | "md" | "xl" | "xs" | "lg" | null | undefined;
+    weight?: "bold" | "normal" | 500 | null | undefined;
+    italic?: boolean | null | undefined;
+    underline?: boolean | null | undefined;
+    lineThrough?: boolean | null | undefined;
+    transform?: "none" | "capitalize" | "uppercase" | null | undefined;
+    opacity?: 0 | 20 | 10 | 100 | 30 | 40 | 50 | 60 | 70 | 80 | 90 | null | undefined;
+    monospace?: boolean | null | undefined;
+    dim?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+type TextVariants = Omit<VariantProps<typeof textStyles>, 'theme'>;
+export interface TextProps extends TextVariants {
+    /** Render as this element or component (e.g. 'h1' or Link). */
+    as?: React.ElementType;
+    /** Additional CSS classes. */
+    className?: string;
+    /** Text children. */
+    children?: React.ReactNode;
+}
+/**
+ * A versatile text component with size, color, weight, decoration,
+ * transform, opacity, monospace, dimming, and theme-aware defaults.
+ */
+export declare const Text: React.FC<TextProps>;
+export default Text;

package/dist/react/components/textarea/index.d.ts

@@ -0,0 +1,41 @@
+import React, { TextareaHTMLAttributes } from 'react';
+import { VariantProps } from 'class-variance-authority';
+declare const textareaContainer: (props?: ({
+    theme?: "light" | "dark" | null | undefined;
+    hasValue?: boolean | null | undefined;
+    colorScheme?: "default" | "brand" | "error" | "success" | null | undefined;
+    size?: "sm" | "md" | "xl" | null | undefined;
+    variant?: "outlined" | null | undefined;
+    isValid?: boolean | "null" | null | undefined;
+    disabled?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+type TextareaVariants = VariantProps<typeof textareaContainer>;
+export interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'onChange' | 'size'>, Omit<TextareaVariants, 'theme' | 'hasValue' | 'isValid' | 'disabled'> {
+    className?: string;
+    onChange?: (value: string) => void;
+    showPasteButton?: boolean;
+    validator?: ((value: string) => boolean) | boolean;
+    rows?: number;
+    font?: 'main' | 'grotesque';
+    weight?: 'light' | 'normal' | 'medium' | 'semibold' | 'bold';
+    error?: boolean;
+    success?: boolean;
+}
+/**
+ * A versatile textarea component that adapts to light/dark theme,
+ * supports various color schemes, sizes, variants, and states.
+ * Includes optional paste functionality and validation.
+ *
+ * @example
+ * <Textarea
+ *   placeholder='Enter your message'
+ *   colorScheme='brand'
+ *   size='xl'
+ *   font='grotesque'
+ *   weight='medium'
+ *   rows={4}
+ *   showPasteButton={true}
+ * />
+ */
+export declare const Textarea: React.FC<TextareaProps>;
+export default Textarea;

package/dist/react/components/timeDelta/index.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { type TimeDeltaFormat } from '../../utils/datetime';
+export interface TimeDeltaProps {
+    /** Start date for delta calculation, defaults to now */
+    startDate?: Date | number | string;
+    /** End date or timestamp */
+    endDate: Date | number | string;
+    /** Show tooltip with exact timestamp */
+    showTimestampTooltip?: boolean;
+    /** Override date for tooltip instead of endDate */
+    tooltipDate?: Date | number | string;
+    /** Format mode: 'default' shows delta and tooltip, 'detailed' suppresses tooltip */
+    format?: TimeDeltaFormat;
+}
+/**
+ * TimeDelta component renews a human-readable delta string periodically,
+ * and optionally wraps it in a tooltip showing the exact date/time.
+ * Supports light/dark theme.
+ */
+export declare const TimeDelta: React.FC<TimeDeltaProps>;
+export default TimeDelta;

package/dist/react/components/transactionStatusIcon/index.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import { SuccessIcon } from '../icons';
+/**
+ * Available status keys for which an icon will be rendered.
+ */
+export type StatusKey = 'SUCCESS' | 'FAIL' | 'QUEUED' | 'POOLED' | 'BROADCASTED';
+/**
+ * Props for the TransactionStatusIcon component.
+ * Inherits all props of SuccessIcon (assumed representative of all icons),
+ * plus a `status` field to choose which icon to render.
+ */
+export interface TransactionStatusIconProps extends Omit<React.ComponentProps<typeof SuccessIcon>, 'size' | 'color'> {
+    /** Which status icon to show. */
+    status: StatusKey;
+    /** Optional override for icon size. */
+    size?: number;
+    /** Optional override for icon color. */
+    color?: string;
+}
+/**
+ * Renders an icon corresponding to the given `status`.
+ * If `status` is not recognized, returns null.
+ * Colors adapt to light/dark theme unless overridden.
+ */
+export declare const TransactionStatusIcon: React.FC<TransactionStatusIconProps>;
+export default TransactionStatusIcon;

package/dist/react/components/valueCard/index.d.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+import { VariantProps } from 'class-variance-authority';
+declare const valueCard: (props?: ({
+    theme?: "light" | "dark" | null | undefined;
+    colorScheme?: "white" | "default" | "lightBlue" | "lightGray" | "green" | "transparent" | "yellow" | null | undefined;
+    size?: "sm" | "md" | "xl" | null | undefined;
+    clickable?: boolean | null | undefined;
+    loading?: boolean | null | undefined;
+    border?: boolean | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
+type ValueCardVariants = VariantProps<typeof valueCard>;
+export interface ValueCardProps extends Omit<ValueCardVariants, 'theme'> {
+    /** If you pass an `as` component, it'll receive `href` when `link` is set */
+    as?: React.ElementType;
+    /** Only applies `href` if `as` is `'a'` or a component that accepts `href` */
+    link?: string;
+    className?: string;
+    children: React.ReactNode;
+    /** Additional props to pass to the underlying element */
+    [key: string]: any;
+}
+/**
+ * A card container that adapts to light/dark theme,
+ * supports various color schemes, sizes, clickability,
+ * loading state, and optional border styling.
+ *
+ * @example
+ * <ValueCard colorScheme="green" border as={Link} link="/foo">
+ *   Go
+ * </ValueCard>
+ */
+export declare const ValueCard: React.FC<ValueCardProps>;
+export default ValueCard;

package/dist/react/contexts/ThemeContext.d.ts

@@ -0,0 +1,36 @@
+import React from 'react';
+export type Theme = 'light' | 'dark';
+/**
+ * Context value shape for theme switching.
+ */
+export interface ThemeContextValue {
+    /** Current theme, either 'light' or 'dark'. */
+    theme: Theme;
+    /** Set the theme explicitly. */
+    setTheme: (theme: Theme) => void;
+    /** Toggle between 'light' and 'dark'. */
+    toggleTheme: () => void;
+}
+/**
+ * Props for the ThemeProvider component.
+ */
+export interface ThemeProviderProps {
+    /** Initial theme; if not provided, reads from localStorage or defaults to 'light'. */
+    initialTheme?: Theme;
+    /** React children that will have access to the theme context. */
+    children: React.ReactNode;
+}
+/**
+ * Provides theme context to its descendants and syncs theme with localStorage
+ * and the root HTML element's class list ('light' or 'dark').
+ *
+ * @param initialTheme - Optional initial theme override.
+ * @param children - React children.
+ */
+export declare const ThemeProvider: React.FC<ThemeProviderProps>;
+/**
+ * Hook to access the theme context.
+ * @returns ThemeContextValue - Contains `theme`, `setTheme`, and `toggleTheme`.
+ * @throws If used outside of a ThemeProvider.
+ */
+export declare function useTheme(): ThemeContextValue;

package/dist/react/contexts/index.d.ts

@@ -0,0 +1 @@
+export { ThemeProvider, useTheme, type Theme, type ThemeContextValue, type ThemeProviderProps } from './ThemeContext';

package/dist/react/hooks/index.d.ts

@@ -0,0 +1 @@
+export { default as useDebounce } from './useDebounce';

package/dist/react/hooks/useDebounce.d.ts

@@ -0,0 +1,42 @@
+interface UseDebounceOptions<T> {
+    /**
+     * Delay in milliseconds
+     */
+    delay: number;
+    /**
+     * Callback called when debounced value changes
+     */
+    callback?: (value: T) => void;
+    /**
+     * If true, the value will be set immediately on first call
+     */
+    immediate?: boolean;
+}
+interface UseDebounceReturn<T> {
+    /**
+     * Current debounced value
+     */
+    debouncedValue: T;
+    /**
+     * Function to force flush debounce and immediately update value
+     */
+    flush: () => void;
+    /**
+     * Function to cancel current pending debounce
+     */
+    cancel: () => void;
+    /**
+     * Whether there's a pending change
+     */
+    isPending: boolean;
+}
+/**
+ * Hook for debouncing values with extended functionality
+ *
+ * @param value - Value to debounce
+ * @param options - Configuration options
+ * @returns Object with debounced value and control methods
+ */
+declare const useDebounce: <T>(value: T, options: UseDebounceOptions<T> | number) => UseDebounceReturn<T>;
+export default useDebounce;
+export { useDebounce };