@app-studio/web 0.8.74 → 0.8.77

package/dist/components/Text/Text/Text.style.d.ts

@@ -1,2 +1,26 @@
-import { Headings } from './Text.type';
-export declare const HeadingSizes: Record<Headings, Record<string, number | string>>;
+/**
+ * Text Styles
+ *
+ * Defines the styles for the Text component following the design guidelines:
+ * - Typography: Inter/Geist font, specific sizes/weights
+ * - Spacing: 4px grid system
+ * - Colors: Neutral palette with semantic colors
+ */
+import { Headings, Size, TextWeights } from './Text.type';
+import { ViewProps } from 'app-studio';
+/**
+ * Heading sizes following typography guidelines
+ */
+export declare const HeadingSizes: Record<Headings, ViewProps>;
+/**
+ * Font sizes following typography guidelines
+ */
+export declare const FontSizes: Record<Size, string>;
+/**
+ * Line heights following typography guidelines
+ */
+export declare const LineHeights: Record<Size, string>;
+/**
+ * Font weights following typography guidelines
+ */
+export declare const FontWeights: Record<TextWeights, string>;

package/dist/components/Text/Text/Text.view.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Text View Component
+ *
+ * Renders text with various styles and states according to the design guidelines.
+ */
 import React from 'react';
 import { ViewProps } from 'app-studio';
 import { TextProps } from './Text.props';
@@ -6,5 +11,8 @@ interface Props extends TextProps {
         container?: ViewProps;
     };
 }
+/**
+ * Main Text component that renders text with various styles and states
+ */
 declare const TextView: React.FC<Props>;
 export default TextView;

package/dist/components/Text/examples/designSystem.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Text Examples - Design System
+ *
+ * Showcases the Text component following the design guidelines:
+ * - Typography: Inter/Geist font, specific sizes/weights
+ * - Spacing: 4px grid system
+ * - Colors: Neutral palette with semantic colors
+ */
+import React from 'react';
+export declare const DesignSystemText: () => React.JSX.Element;

package/dist/components/Text/examples/index.d.ts

@@ -0,0 +1 @@
+export * from './designSystem';

package/dist/components/Toast/Toast/Toast.hook.d.ts

@@ -0,0 +1,35 @@
+import { ToastOptions, ToastVariant } from './Toast.type';
+/**
+ * Hook for using Toast functionality within components
+ * @returns Object with methods to show and manage toasts
+ */
+export declare const useToast: () => {
+    /**
+     * Show a toast with the specified variant
+     */
+    toast: (variant: ToastVariant, title: string, description?: string | undefined, options?: ToastOptions | undefined) => any;
+    /**
+     * Show an info toast
+     */
+    info: (title: string, description?: string | undefined, options?: ToastOptions | undefined) => any;
+    /**
+     * Show a success toast
+     */
+    success: (title: string, description?: string | undefined, options?: ToastOptions | undefined) => any;
+    /**
+     * Show a warning toast
+     */
+    warning: (title: string, description?: string | undefined, options?: ToastOptions | undefined) => any;
+    /**
+     * Show an error toast
+     */
+    error: (title: string, description?: string | undefined, options?: ToastOptions | undefined) => any;
+    /**
+     * Remove a specific toast by ID
+     */
+    remove: (id: string) => void;
+    /**
+     * Remove all toasts
+     */
+    removeAll: () => void;
+};

package/dist/components/Toast/Toast/Toast.props.d.ts

@@ -0,0 +1,91 @@
+/// <reference types="react" />
+import { ToastItem, ToastOptions, ToastPosition, ToastStyles, ToastVariant, ThemesType } from './Toast.type';
+export interface ToastProps {
+    /**
+     * Unique identifier for the toast
+     */
+    id?: string;
+    /**
+     * The variant of the toast
+     */
+    variant: ToastVariant;
+    /**
+     * The title of the toast
+     */
+    title: string;
+    /**
+     * The description of the toast (optional)
+     */
+    description?: string;
+    /**
+     * Function to close the toast
+     */
+    onClose: () => void;
+    /**
+     * Whether the toast should have a close button
+     */
+    isClosable?: boolean;
+    /**
+     * Function to execute when the action button is clicked
+     */
+    action?: () => void;
+    /**
+     * Text for the action button
+     */
+    actionText?: string;
+    /**
+     * Whether to show an icon based on the variant
+     */
+    showIcon?: boolean;
+    /**
+     * Custom theme for the toast
+     */
+    theme?: ThemesType;
+    /**
+     * Custom styles for different parts of the toast
+     */
+    views?: ToastStyles;
+    /**
+     * Duration in milliseconds before the toast auto-closes
+     */
+    duration?: number;
+    /**
+     * Custom render function for complete control over toast appearance
+     */
+    render?: (props: {
+        id: string;
+        onClose: () => void;
+    }) => React.ReactNode;
+    /**
+     * Custom icon to display instead of the default variant icon
+     */
+    icon?: React.ReactNode;
+    /**
+     * Whether the toast is visible (for animation purposes)
+     */
+    isVisible?: boolean;
+}
+export interface ToastContainerProps {
+    /**
+     * The position of the toast container
+     */
+    position?: ToastPosition;
+    /**
+     * The gap between toasts
+     */
+    gap?: number;
+    /**
+     * The maximum number of toasts to show at once
+     */
+    limit?: number;
+    /**
+     * Custom styles for the container
+     */
+    containerStyle?: React.CSSProperties;
+}
+export interface ToastState {
+    toasts: ToastItem[];
+    add: (variant: ToastVariant, title: string, description?: string, options?: ToastOptions) => string;
+    remove: (id: string) => void;
+    removeAll: () => void;
+}

package/dist/components/Toast/Toast/Toast.store.d.ts

@@ -0,0 +1,9 @@
+import { ToastOptions, ToastVariant } from './Toast.type';
+export declare const useToastStore: any;
+export declare const showToast: (variant: ToastVariant, title: string, description?: string | undefined, options?: ToastOptions | undefined) => any;
+export declare const showInfoToast: (title: string, description?: string | undefined, options?: ToastOptions | undefined) => any;
+export declare const showSuccessToast: (title: string, description?: string | undefined, options?: ToastOptions | undefined) => any;
+export declare const showWarningToast: (title: string, description?: string | undefined, options?: ToastOptions | undefined) => any;
+export declare const showErrorToast: (title: string, description?: string | undefined, options?: ToastOptions | undefined) => any;
+export declare const removeToast: (id: string) => void;
+export declare const removeAllToasts: () => void;

package/dist/components/Toast/Toast/Toast.style.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Toast Styles
+ *
+ * Defines the styles for the Toast component following the design guidelines:
+ * - Typography: Inter/Geist font, specific sizes/weights
+ * - Spacing: 4px grid system
+ * - Colors: Neutral palette with semantic colors
+ * - Rounded corners: Consistent border radius
+ * - Transitions: Subtle animations
+ */
+import { ViewProps } from 'app-studio';
+import { ToastPosition, ThemesType } from './Toast.type';
+/**
+ * Theme configurations for the Toast component
+ * Following the design system color palette
+ */
+export declare const Themes: ThemesType;
+/**
+ * Animation configurations for the Toast component
+ */
+export declare const ToastAnimations: {
+    enter: {
+        opacity: number[];
+        transform: string[];
+        transition: string;
+    };
+    exit: {
+        opacity: number[];
+        transform: string[];
+        transition: string;
+    };
+};
+/**
+ * Position configurations for the Toast component
+ * Following the 4px grid system
+ */
+export declare const ToastPositions: Record<ToastPosition, ViewProps>;

package/dist/components/Toast/Toast/Toast.type.d.ts

@@ -0,0 +1,63 @@
+/// <reference types="react" />
+import { ViewProps } from 'app-studio';
+export declare type ToastVariant = 'info' | 'success' | 'warning' | 'error';
+export declare type ToastPosition = 'top' | 'top-right' | 'top-left' | 'bottom' | 'bottom-right' | 'bottom-left';
+export interface Theme {
+    container: {
+        backgroundColor: string;
+        border: string;
+    };
+    content: {
+        color: string;
+    };
+    icon: {
+        color: string;
+    };
+}
+export declare type ThemesType = {
+    info: Theme;
+    success: Theme;
+    error: Theme;
+    warning: Theme;
+};
+export interface ToastStyles {
+    container?: ViewProps;
+    title?: ViewProps;
+    description?: ViewProps;
+    icon?: ViewProps;
+    closeButton?: ViewProps;
+    actionButton?: ViewProps;
+}
+export interface ToastOptions {
+    id?: string;
+    duration?: number;
+    position?: ToastPosition;
+    isClosable?: boolean;
+    onClose?: () => void;
+    action?: () => void;
+    actionText?: string;
+    showIcon?: boolean;
+    views?: ToastStyles;
+    /**
+     * Custom render function for complete control over toast appearance
+     */
+    render?: (props: {
+        id: string;
+        onClose: () => void;
+    }) => React.ReactNode;
+    /**
+     * Custom icon to display instead of the default variant icon
+     */
+    icon?: React.ReactNode;
+}
+export interface ToastItem extends ToastOptions {
+    id: string;
+    variant: ToastVariant;
+    title: string;
+    description?: string;
+    createdAt: number;
+    /**
+     * Whether the toast is visible (for animation purposes)
+     */
+    isVisible?: boolean;
+}

package/dist/components/Toast/Toast/Toast.view.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { ToastProps, ToastContainerProps } from './Toast.props';
+export declare const ToastView: React.FC<ToastProps>;
+export declare const ToastContainer: React.FC<ToastContainerProps>;

package/dist/components/Toast/Toast.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import { ToastProps, ToastContainerProps } from './Toast/Toast.props';
+declare const Toast: React.FC<ToastProps> & {
+    Container: (props: ToastContainerProps) => React.JSX.Element;
+    show: (variant: import("./Toast/Toast.type").ToastVariant, title: string, description?: string | undefined, options?: import("./Toast/Toast.type").ToastOptions | undefined) => any;
+    info: (title: string, description?: string | undefined, options?: import("./Toast/Toast.type").ToastOptions | undefined) => any;
+    success: (title: string, description?: string | undefined, options?: import("./Toast/Toast.type").ToastOptions | undefined) => any;
+    warning: (title: string, description?: string | undefined, options?: import("./Toast/Toast.type").ToastOptions | undefined) => any;
+    error: (title: string, description?: string | undefined, options?: import("./Toast/Toast.type").ToastOptions | undefined) => any;
+    remove: (id: string) => void;
+    removeAll: () => void;
+};
+export declare const useToast: () => {
+    toast: (variant: import("./Toast/Toast.type").ToastVariant, title: string, description?: string | undefined, options?: import("./Toast/Toast.type").ToastOptions | undefined) => any;
+    info: (title: string, description?: string | undefined, options?: import("./Toast/Toast.type").ToastOptions | undefined) => any;
+    success: (title: string, description?: string | undefined, options?: import("./Toast/Toast.type").ToastOptions | undefined) => any;
+    warning: (title: string, description?: string | undefined, options?: import("./Toast/Toast.type").ToastOptions | undefined) => any;
+    error: (title: string, description?: string | undefined, options?: import("./Toast/Toast.type").ToastOptions | undefined) => any;
+    remove: (id: string) => void;
+    removeAll: () => void;
+};
+export { Toast };

package/dist/components/Toast/examples/actions.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const ToastActions: () => React.JSX.Element;

package/dist/components/Toast/examples/customization.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const CustomizedToast: () => React.JSX.Element;

package/dist/components/Toast/examples/default.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const DefaultToast: () => React.JSX.Element;

package/dist/components/Toast/examples/designSystem.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Toast Examples - Design System
+ *
+ * Showcases the Toast component following the design guidelines:
+ * - Typography: Inter/Geist font, specific sizes/weights
+ * - Spacing: 4px grid system
+ * - Colors: Neutral palette with semantic colors
+ * - Rounded corners: Consistent border radius
+ * - Transitions: Subtle animations
+ */
+import React from 'react';
+export declare const DesignSystemToast: () => React.JSX.Element;

package/dist/components/Toast/examples/duration.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const ToastDurations: () => React.JSX.Element;

package/dist/components/Toast/examples/hookUsage.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const HookUsageDemo: () => React.JSX.Element;

package/dist/components/Toast/examples/index.d.ts

@@ -0,0 +1,8 @@
+export * from './default';
+export * from './designSystem';
+export * from './variants';
+export * from './positions';
+export * from './duration';
+export * from './actions';
+export * from './customization';
+export * from './hookUsage';

package/dist/components/Toast/examples/positions.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const ToastPositions: () => React.JSX.Element;

package/dist/components/Toast/examples/variants.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const ToastVariants: () => React.JSX.Element;

package/dist/components/Toast/index.d.ts

@@ -0,0 +1 @@
+export * from './Toast';

package/dist/components/Tooltip/Tooltip/Tooltip.props.d.ts

@@ -0,0 +1,108 @@
+import React from 'react';
+import { ViewProps } from 'app-studio';
+import { Position, Alignment, Size, Variant, TooltipStyles } from './Tooltip.type';
+export interface TooltipProps {
+    /**
+     * The content to display in the tooltip
+     */
+    content: React.ReactNode;
+    /**
+     * The element that triggers the tooltip
+     */
+    children: React.ReactNode;
+    /**
+     * The preferred position of the tooltip
+     * @default 'top'
+     */
+    position?: Position;
+    /**
+     * The alignment of the tooltip relative to the trigger
+     * @default 'center'
+     */
+    align?: Alignment;
+    /**
+     * The size of the tooltip
+     * @default 'md'
+     */
+    size?: Size;
+    /**
+     * The visual style variant of the tooltip
+     * @default 'default'
+     */
+    variant?: Variant;
+    /**
+     * Delay in milliseconds before the tooltip opens on hover
+     * @default 200
+     */
+    openDelay?: number;
+    /**
+     * Delay in milliseconds before the tooltip closes after hover stops
+     * @default 200
+     */
+    closeDelay?: number;
+    /**
+     * Whether to show an arrow pointing to the trigger
+     * @default true
+     */
+    showArrow?: boolean;
+    /**
+     * Whether the tooltip is initially open
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /**
+     * Whether the tooltip is disabled
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Custom styles for different parts of the tooltip
+     */
+    views?: TooltipStyles;
+    /**
+     * Additional props to be spread to the container element
+     */
+    [key: string]: any;
+}
+export interface TooltipTriggerProps {
+    /**
+     * The element that triggers the tooltip
+     */
+    children: React.ReactNode;
+    /**
+     * Custom styles for the trigger container
+     */
+    views?: {
+        container?: ViewProps;
+    };
+    /**
+     * Whether to preserve the child element's props
+     * @default false
+     */
+    asChild?: boolean;
+    /**
+     * Additional props to be spread to the container element
+     */
+    [key: string]: any;
+}
+export interface TooltipContentProps {
+    /**
+     * The content to display in the tooltip
+     */
+    children: React.ReactNode;
+    /**
+     * Custom styles for the content container
+     */
+    views?: {
+        container?: ViewProps;
+        arrow?: ViewProps;
+    };
+    /**
+     * Additional props to be spread to the container element
+     */
+    [key: string]: any;
+}
+export interface TooltipType extends React.FC<TooltipProps> {
+    Trigger: React.FC<TooltipTriggerProps>;
+    Content: React.FC<TooltipContentProps>;
+}

package/dist/components/Tooltip/Tooltip/Tooltip.state.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="react" />
+interface TooltipStateProps {
+    defaultOpen?: boolean;
+    openDelay?: number;
+    closeDelay?: number;
+    isDisabled?: boolean;
+}
+export declare const useTooltipState: ({ defaultOpen, openDelay, closeDelay, isDisabled, }?: TooltipStateProps) => {
+    isOpen: boolean;
+    openTooltip: () => void;
+    closeTooltip: () => void;
+    cancelCloseTimer: () => void;
+    triggerRef: import("react").RefObject<HTMLElement>;
+    contentRef: import("react").RefObject<HTMLElement>;
+    triggerId: string;
+    contentId: string;
+};
+export {};

package/dist/components/Tooltip/Tooltip/Tooltip.style.d.ts

@@ -0,0 +1,6 @@
+import { ViewProps } from 'app-studio';
+import { Size, Variant, Position, Alignment } from './Tooltip.type';
+export declare const TooltipSizes: Record<Size, ViewProps>;
+export declare const TooltipVariants: Record<Variant, ViewProps>;
+export declare const getTooltipPositionStyles: (position: Position, align: Alignment) => ViewProps;
+export declare const getArrowStyles: (position: Position) => ViewProps;

package/dist/components/Tooltip/Tooltip/Tooltip.type.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="react" />
+import { ViewProps, TextProps } from 'app-studio';
+export declare type Position = 'top' | 'right' | 'bottom' | 'left';
+export declare type Alignment = 'start' | 'center' | 'end';
+export declare type Size = 'sm' | 'md' | 'lg';
+export declare type Variant = 'default' | 'light' | 'dark';
+export interface TooltipContextType {
+    isOpen: boolean;
+    openTooltip: () => void;
+    closeTooltip: () => void;
+    triggerRef: React.RefObject<HTMLElement>;
+    contentRef: React.RefObject<HTMLElement>;
+    contentId: string;
+    triggerId: string;
+}
+export interface TooltipStyles {
+    container?: ViewProps;
+    content?: ViewProps;
+    arrow?: ViewProps;
+    text?: TextProps;
+}

package/dist/components/Tooltip/Tooltip/Tooltip.view.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import { TooltipContextType, Position, Alignment } from './Tooltip.type';
+import { TooltipTriggerProps, TooltipContentProps } from './Tooltip.props';
+export declare const useTooltipContext: () => TooltipContextType;
+export declare const TooltipProvider: React.FC<{
+    value: TooltipContextType;
+    children: React.ReactNode;
+}>;
+export declare const TooltipTrigger: React.FC<TooltipTriggerProps>;
+export declare const TooltipContent: React.FC<TooltipContentProps>;
+export declare const TooltipView: React.FC<{
+    content: React.ReactNode;
+    children: React.ReactNode;
+    position?: Position;
+    align?: Alignment;
+    size?: string;
+    variant?: string;
+    showArrow?: boolean;
+    views?: any;
+}>;

package/dist/components/Tooltip/Tooltip.d.ts

@@ -0,0 +1,2 @@
+import { TooltipType } from './Tooltip/Tooltip.props';
+export declare const Tooltip: TooltipType;

package/dist/components/Tooltip/examples/custom.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const CustomTooltip: () => React.JSX.Element;

package/dist/components/Tooltip/examples/default.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const DefaultTooltip: () => React.JSX.Element;

package/dist/components/Tooltip/examples/index.d.ts

@@ -0,0 +1,6 @@
+export * from './default';
+export * from './positions';
+export * from './variants';
+export * from './sizes';
+export * from './custom';
+export * from './integration';

package/dist/components/Tooltip/examples/integration.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const TooltipIntegration: () => React.JSX.Element;

package/dist/components/Tooltip/examples/positions.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const TooltipPositions: () => React.JSX.Element;

package/dist/components/Tooltip/examples/sizes.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const TooltipSizes: () => React.JSX.Element;

package/dist/components/Tooltip/examples/variants.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const TooltipVariants: () => React.JSX.Element;

package/dist/components/Tooltip/index.d.ts

@@ -0,0 +1 @@
+export * from './Tooltip';