@platform-blocks/ui 0.1.1

package/lib/components/Disclaimer/disclaimerUtils.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { type DisclaimerProps } from './Disclaimer';
+export interface DisclaimerSupport {
+    disclaimer?: React.ReactNode;
+    disclaimerProps?: Omit<DisclaimerProps, 'children'>;
+}
+/**
+ * Hook that renders a disclaimer below content if provided
+ */
+export declare function useDisclaimer(disclaimer?: React.ReactNode, disclaimerProps?: Omit<DisclaimerProps, 'children'>): () => React.JSX.Element | null;
+/**
+ * Utility function to wrap component content with disclaimer
+ */
+export declare function withDisclaimer(content: React.ReactNode, disclaimer?: React.ReactNode, disclaimerProps?: Omit<DisclaimerProps, 'children'>): React.ReactNode;
+/**
+ * Utility to extract disclaimer props from component props
+ */
+export declare function extractDisclaimerProps<T extends DisclaimerSupport>(props: T): {
+    disclaimerProps: Pick<T, 'disclaimer' | 'disclaimerProps'>;
+    otherProps: Omit<T, 'disclaimer' | 'disclaimerProps'>;
+};

package/lib/components/Disclaimer/index.d.ts

@@ -0,0 +1,6 @@
+export { Disclaimer } from './Disclaimer';
+export type { DisclaimerProps } from './Disclaimer';
+export { ComponentWithDisclaimer } from './withDisclaimer';
+export type { WithDisclaimerProps, ComponentWithDisclaimerProps } from './withDisclaimer';
+export { useDisclaimer, withDisclaimer, extractDisclaimerProps } from './disclaimerUtils';
+export type { DisclaimerSupport } from './disclaimerUtils';

package/lib/components/Disclaimer/withDisclaimer.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { type DisclaimerProps } from './Disclaimer';
+export interface WithDisclaimerProps {
+    disclaimer?: React.ReactNode;
+    disclaimerProps?: Omit<DisclaimerProps, 'children'>;
+}
+/**
+ * Component wrapper that adds disclaimer functionality
+ */
+export interface ComponentWithDisclaimerProps extends WithDisclaimerProps {
+    children: React.ReactNode;
+}
+export declare const ComponentWithDisclaimer: React.FC<ComponentWithDisclaimerProps>;

package/lib/components/Divider/Divider.d.ts

@@ -0,0 +1,2 @@
+import type { DividerFactoryPayload } from './types';
+export declare const Divider: import("../../core/factory").PlatformBlocksComponent<DividerFactoryPayload>;

package/lib/components/Divider/index.d.ts

@@ -0,0 +1,2 @@
+export { Divider } from './Divider';
+export type { DividerProps, DividerOrientation, DividerVariant } from './types';

package/lib/components/Divider/types.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import { ViewStyle, View } from 'react-native';
+import { SpacingProps } from '../../core/utils';
+import { SizeValue } from '../../core/theme/sizes';
+export type DividerOrientation = 'horizontal' | 'vertical';
+export type DividerVariant = 'solid' | 'dashed' | 'dotted';
+export interface DividerProps extends SpacingProps {
+    orientation?: DividerOrientation;
+    variant?: DividerVariant;
+    color?: string;
+    /** Semantic color variant (overrides color prop). Supports theme color palettes */
+    colorVariant?: 'primary' | 'secondary' | 'tertiary' | 'surface' | 'success' | 'warning' | 'error' | 'gray' | 'muted' | 'subtle';
+    size?: SizeValue | number;
+    label?: React.ReactNode;
+    labelPosition?: 'left' | 'center' | 'right';
+    style?: ViewStyle;
+    testID?: string;
+}
+export interface DividerFactoryPayload {
+    props: DividerProps;
+    ref: View;
+}

package/lib/components/EmojiPicker/EmojiPicker.d.ts

@@ -0,0 +1,6 @@
+import { View } from 'react-native';
+import type { EmojiPickerProps } from './types';
+export declare const EmojiPicker: import("../../core/factory").PlatformBlocksComponent<{
+    props: EmojiPickerProps;
+    ref: View;
+}>;

package/lib/components/EmojiPicker/index.d.ts

@@ -0,0 +1,2 @@
+export { EmojiPicker } from './EmojiPicker';
+export type { EmojiPickerProps, EmojiPickerVariant } from './types';

package/lib/components/EmojiPicker/types.d.ts

@@ -0,0 +1,29 @@
+import type { SpacingProps } from '../../core/utils';
+export type EmojiPickerVariant = 'quick';
+export interface EmojiPickerProps extends SpacingProps {
+    /** Picker variant */
+    variant?: EmojiPickerVariant;
+    /** Controlled value (selected emoji) */
+    value?: string;
+    /** Callback when emoji selected */
+    onSelect?: (emoji: string) => void;
+    /** Whether picker is disabled */
+    disabled?: boolean;
+    /** Placeholder text for search */
+    searchPlaceholder?: string;
+    /** Number of frequently used / quick emojis to show in quick variant */
+    emojis?: {
+        label: string;
+        emoji: string;
+    }[];
+    /** Default opened (uncontrolled) */
+    defaultOpened?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (opened: boolean) => void;
+    /** Callback whenever search query changes */
+    onSearchChange?: (query: string) => void;
+    /** Show background for the whole quick variant component */
+    showBackground?: boolean;
+    /** Test id */
+    testID?: string;
+}

package/lib/components/FileInput/FileInput.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { FileInputProps } from './types';
+export declare const FileInput: React.FC<FileInputProps>;

package/lib/components/FileInput/index.d.ts

@@ -0,0 +1,2 @@
+export { FileInput } from './FileInput';
+export type { FileInputProps, FileInputFile } from './types';

package/lib/components/FileInput/types.d.ts

@@ -0,0 +1,82 @@
+import React from 'react';
+import type { DocumentPickerAsset } from 'expo-document-picker';
+import { BaseInputProps } from '../Input/types';
+export interface FileInputFile {
+    /** File object or document picker asset */
+    file: File | DocumentPickerAsset;
+    /** Unique identifier */
+    id: string;
+    /** File name */
+    name: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type */
+    type: string;
+    /** Native file URI (if available) */
+    uri?: string;
+    /** Preview URL (for images) */
+    previewUrl?: string;
+    /** Upload progress (0-100) */
+    progress?: number;
+    /** Upload status */
+    status?: 'pending' | 'uploading' | 'success' | 'error';
+    /** Error message if upload failed */
+    error?: string;
+}
+export interface FileInputProps extends BaseInputProps {
+    /** File input variant */
+    variant?: 'standard' | 'dropzone' | 'compact';
+    /** Accepted file types (MIME types or extensions) */
+    accept?: string[];
+    /** Multiple file selection */
+    multiple?: boolean;
+    /** Maximum file size in bytes */
+    maxSize?: number;
+    /** Maximum number of files */
+    maxFiles?: number;
+    /** Upload handler */
+    onUpload?: (files: FileInputFile[]) => Promise<void>;
+    /** Upload progress callback */
+    onProgress?: (fileId: string, progress: number) => void;
+    /** File change handler */
+    onFilesChange?: (files: FileInputFile[]) => void;
+    /** File remove handler */
+    onFileRemove?: (fileId: string) => void;
+    /** File preview component */
+    PreviewComponent?: React.ComponentType<{
+        file: FileInputFile;
+        onRemove: () => void;
+    }>;
+    /** Custom drop zone content */
+    children?: React.ReactNode;
+    /** Whether to show file list */
+    showFileList?: boolean;
+    /** Whether to enable drag and drop */
+    enableDragDrop?: boolean;
+    /** Custom validation function */
+    validateFile?: (file: File | DocumentPickerAsset) => string | null;
+    /** Image preview settings */
+    imagePreview?: {
+        /** Enable image previews */
+        enabled?: boolean;
+        /** Maximum preview width */
+        maxWidth?: number;
+        /** Maximum preview height */
+        maxHeight?: number;
+        /** Preview quality (0-1) */
+        quality?: number;
+    };
+    /** Upload settings */
+    uploadSettings?: {
+        /** Upload URL */
+        url?: string;
+        /** HTTP method */
+        method?: 'POST' | 'PUT';
+        /** Additional headers */
+        headers?: Record<string, string>;
+        /** Form field name for files */
+        fieldName?: string;
+        /** Additional form data */
+        formData?: Record<string, string>;
+    };
+}

package/lib/components/Flex/Flex.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+import { View, ViewStyle, DimensionValue } from 'react-native';
+import { SpacingProps, LayoutProps } from '../../core/utils';
+import { SizeValue } from '../../core/theme/sizes';
+export interface FlexProps extends SpacingProps, LayoutProps {
+    /** Flex direction */
+    direction?: 'row' | 'column' | 'row-reverse' | 'column-reverse';
+    /** Align items on the cross axis */
+    align?: 'flex-start' | 'flex-end' | 'center' | 'stretch' | 'baseline';
+    /** Justify content on the main axis */
+    justify?: 'flex-start' | 'flex-end' | 'center' | 'space-between' | 'space-around' | 'space-evenly';
+    /** Flex wrap */
+    wrap?: 'nowrap' | 'wrap' | 'wrap-reverse';
+    /** Gap between children (applies to both row and column gap) */
+    gap?: SizeValue;
+    /** Row gap between children */
+    rowGap?: SizeValue;
+    /** Column gap between children */
+    columnGap?: SizeValue;
+    /** Flex grow */
+    grow?: number;
+    /** Flex shrink */
+    shrink?: number;
+    /** Flex basis */
+    basis?: DimensionValue;
+    /** Children elements */
+    children?: React.ReactNode;
+    /** Custom styles */
+    style?: ViewStyle;
+    /** Test ID for testing */
+    testID?: string;
+    /** Disable automatic RTL mirroring for row direction */
+    disableRTLMirroring?: boolean;
+}
+export declare const Flex: import("../../core/factory").PlatformBlocksComponent<{
+    props: FlexProps;
+    ref: View;
+}>;

package/lib/components/Flex/helpers.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { View } from 'react-native';
+import { FlexProps } from './Flex';
+/**
+ * Row component - shorthand for Flex with direction="row"
+ * Automatically mirrors to row-reverse in RTL
+ */
+export declare const Row: React.ForwardRefExoticComponent<Omit<FlexProps, "direction"> & React.RefAttributes<View>>;
+/**
+ * Column component - shorthand for Flex with direction="column"
+ * Not affected by RTL (columns are vertical)
+ */
+export declare const Column: React.ForwardRefExoticComponent<Omit<FlexProps, "direction"> & React.RefAttributes<View>>;

package/lib/components/Flex/index.d.ts

@@ -0,0 +1,2 @@
+export { Flex, FlexProps } from './Flex';
+export { Row, Column } from './helpers';

package/lib/components/FloatingActions/FloatingActions.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import { ViewStyle } from 'react-native';
+export interface FloatingActionItem {
+    key: string;
+    icon?: string;
+    getIcon?: () => string;
+    onPress: () => void;
+    accessibilityLabel?: string;
+}
+export interface FloatingActionsProps {
+    /** Custom actions. If not provided, defaults to spotlight, theme toggle, and GitHub */
+    actions?: FloatingActionItem[];
+    /** Called when the speed dial opens */
+    onOpen?: () => void;
+    /** Called when the speed dial closes */
+    onClose?: () => void;
+    /** If true, clicking/tapping outside will not close the menu */
+    disableOutsideClose?: boolean;
+    /** Radius (in px) for the arc along which actions are laid out */
+    radius?: number;
+    /** Container style (position should remain absolute for proper layout) */
+    style?: ViewStyle;
+    /** Handler to toggle theme (if omitted, the Theme action still shows but will be a no-op) */
+    onToggleTheme?: () => void;
+    /** GitHub URL for the default GitHub action */
+    githubUrl?: string;
+}
+export declare const FloatingActions: React.FC<FloatingActionsProps>;
+export default FloatingActions;

package/lib/components/FloatingActions/index.d.ts

@@ -0,0 +1,2 @@
+export { FloatingActions } from './FloatingActions';
+export type { FloatingActionsProps, FloatingActionItem } from './FloatingActions';

package/lib/components/Form/FormBase.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { FormProps } from './types';
+export declare const FormBase: React.FC<FormProps>;

package/lib/components/Form/FormContext.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { FormContextValue, ValidationSchema } from './types';
+export declare const useFormContext: () => FormContextValue;
+export declare const useOptionalFormContext: () => FormContextValue | null;
+interface FormProviderProps {
+    initialValues?: Record<string, any>;
+    validationSchema?: ValidationSchema;
+    onSubmit?: (values: Record<string, any>) => void | Promise<void>;
+    validate?: (values: Record<string, any>) => Record<string, string> | Promise<Record<string, string>>;
+    disabled?: boolean;
+    validateOnChange?: boolean;
+    validateOnBlur?: boolean;
+    children: React.ReactNode;
+}
+export declare const FormProvider: React.FC<FormProviderProps>;
+export {};

package/lib/components/Form/FormError.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { FormErrorProps } from './types';
+export declare const FormError: React.FC<FormErrorProps>;

package/lib/components/Form/FormField.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { FormFieldProps } from './types';
+export declare const FormField: React.FC<FormFieldProps>;

package/lib/components/Form/FormInput.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { FormInputProps } from './types';
+export declare const FormInput: React.FC<FormInputProps>;

package/lib/components/Form/FormLabel.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { FormLabelProps } from './types';
+export declare const FormLabel: React.FC<FormLabelProps>;

package/lib/components/Form/FormSubmit.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { FormSubmitProps } from './types';
+export declare const FormSubmit: React.FC<FormSubmitProps>;

package/lib/components/Form/OptimizedForm.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { FormProps } from './types';
+/**
+ * Complete optimized Form compound component
+ */
+export declare const OptimizedForm: React.NamedExoticComponent<FormProps> & {
+    Field: React.NamedExoticComponent<import("./types").FormFieldProps>;
+    Input: React.NamedExoticComponent<import("./types").FormInputProps>;
+    Label: React.NamedExoticComponent<import("./types").FormLabelProps>;
+    Error: React.NamedExoticComponent<import("./types").FormErrorProps>;
+    Submit: React.NamedExoticComponent<import("./types").FormSubmitProps>;
+};
+/**
+ * Custom hook for form performance monitoring
+ */
+export declare function useFormPerformanceMonitoring(formName: string): {
+    renderCount: number;
+};
+/**
+ * Higher-order component for adding performance monitoring to forms
+ */
+export declare function withFormPerformanceMonitoring<T extends object>(Component: React.ComponentType<T>, componentName: string): React.NamedExoticComponent<T>;

package/lib/components/Form/index.d.ts

@@ -0,0 +1,9 @@
+export declare const Form: import("react").FC<import("./types").FormProps> & {
+    Field: import("react").FC<import("./types").FormFieldProps>;
+    Input: import("react").FC<import("./types").FormInputProps>;
+    Label: import("react").FC<import("./types").FormLabelProps>;
+    Error: import("react").FC<import("./types").FormErrorProps>;
+    Submit: import("react").FC<import("./types").FormSubmitProps>;
+};
+export type { FormProps, FormFieldProps, FormInputProps, FormLabelProps, FormErrorProps, FormSubmitProps, ValidationSchema, FormContextValue } from './types';
+export { useFormContext, useOptionalFormContext } from './FormContext';

package/lib/components/Form/types.d.ts

@@ -0,0 +1,104 @@
+import React from 'react';
+import { ValidationRule } from '../Input/types';
+export interface ValidationSchema {
+    [fieldName: string]: ValidationRule[];
+}
+export interface FormContextValue {
+    /** Form values */
+    values: Record<string, any>;
+    /** Form errors */
+    errors: Record<string, string>;
+    /** Touched fields */
+    touched: Record<string, boolean>;
+    /** Whether form is disabled */
+    disabled: boolean;
+    /** Whether form is submitting */
+    isSubmitting: boolean;
+    /** Whether form is valid */
+    isValid: boolean;
+    /** Validate a single field */
+    validateField: (name: string, value: any) => Promise<string | null>;
+    /** Set field value */
+    setFieldValue: (name: string, value: any) => void;
+    /** Set field error */
+    setFieldError: (name: string, error: string | null) => void;
+    /** Set field as touched */
+    setFieldTouched: (name: string, touched: boolean) => void;
+    /** Get field props for binding */
+    getFieldProps: (name: string) => {
+        value: any;
+        onChangeText: (value: any) => void;
+        onBlur: () => void;
+        error?: string;
+        name: string;
+    };
+    /** Submit form */
+    submitForm: () => Promise<void>;
+    /** Reset form */
+    resetForm: () => void;
+}
+export interface FormProps {
+    /** Initial form values */
+    initialValues?: Record<string, any>;
+    /** Form validation schema */
+    validationSchema?: ValidationSchema;
+    /** Submit handler */
+    onSubmit?: (values: Record<string, any>) => void | Promise<void>;
+    /** Validation handler */
+    validate?: (values: Record<string, any>) => Record<string, string> | Promise<Record<string, string>>;
+    /** Whether form is disabled */
+    disabled?: boolean;
+    /** Whether to validate on change */
+    validateOnChange?: boolean;
+    /** Whether to validate on blur */
+    validateOnBlur?: boolean;
+    /** Children components */
+    children: React.ReactNode;
+}
+export interface FormFieldProps {
+    /** Field name */
+    name: string;
+    /** Field dependencies for conditional logic */
+    dependsOn?: Array<{
+        field: string;
+        condition: (value: any, formValues: Record<string, any>) => boolean;
+        action: 'show' | 'hide' | 'enable' | 'disable' | 'require';
+    }>;
+    /** Field validation dependencies */
+    validateWhen?: {
+        field: string;
+        condition: (value: any, formValues: Record<string, any>) => boolean;
+    };
+    /** Custom validation for this field */
+    validation?: ValidationRule[];
+    /** Children components */
+    children: React.ReactNode;
+}
+export interface FormInputProps {
+    /** Field name (optional when used inside FormField) */
+    name?: string;
+    /** All other props passed to Input component */
+    [key: string]: any;
+}
+export interface FormLabelProps {
+    /** Field name (for accessibility) */
+    htmlFor?: string;
+    /** Whether field is required */
+    required?: boolean;
+    /** Label content */
+    children: React.ReactNode;
+}
+export interface FormErrorProps {
+    /** Field name to show error for */
+    name?: string;
+    /** Custom error message */
+    error?: string;
+}
+export interface FormSubmitProps {
+    /** Submit button content */
+    children: React.ReactNode;
+    /** Whether button is disabled */
+    disabled?: boolean;
+    /** Additional button props */
+    [key: string]: any;
+}

package/lib/components/FormLayout/FormField.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { FormFieldProps } from './types';
+export declare const FormField: React.FC<FormFieldProps>;

package/lib/components/FormLayout/FormGroup.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { FormGroupProps } from './types';
+export declare const FormGroup: React.FC<FormGroupProps>;

package/lib/components/FormLayout/FormLayout.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { FormLayoutProps } from './types';
+export declare const FormLayout: React.FC<FormLayoutProps>;

package/lib/components/FormLayout/FormSection.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { FormSectionProps } from './types';
+export declare const FormSection: React.FC<FormSectionProps>;

package/lib/components/FormLayout/index.d.ts

@@ -0,0 +1,5 @@
+export { FormSection } from './FormSection';
+export { FormField } from './FormField';
+export { FormGroup } from './FormGroup';
+export { FormLayout } from './FormLayout';
+export * from './types';

package/lib/components/FormLayout/types.d.ts

@@ -0,0 +1,31 @@
+import { ReactNode } from 'react';
+export interface FormLayoutProps {
+    children: ReactNode;
+    maxWidth?: number;
+    spacing?: 'sm' | 'md' | 'lg' | 'xl';
+    variant?: 'default' | 'card' | 'modal';
+}
+export interface FormSectionProps {
+    title?: string;
+    description?: string;
+    children: ReactNode;
+    spacing?: 'sm' | 'md' | 'lg';
+    collapsible?: boolean;
+    defaultCollapsed?: boolean;
+}
+export interface FormGroupProps {
+    children: ReactNode;
+    direction?: 'row' | 'column';
+    columns?: 2 | 3 | 4;
+    spacing?: 'xs' | 'sm' | 'md' | 'lg';
+    align?: 'start' | 'center' | 'end' | 'stretch';
+}
+export interface FormFieldProps {
+    label?: string;
+    description?: string;
+    error?: string;
+    required?: boolean;
+    children: ReactNode;
+    width?: 'auto' | 'full' | number;
+    labelPosition?: 'top' | 'left' | 'right';
+}

package/lib/components/Forms/ContactForm.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { ContactFormProps } from './types';
+export declare const ContactForm: React.FC<ContactFormProps>;

package/lib/components/Forms/ForgotPasswordForm.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { ForgotPasswordFormProps } from './types';
+export declare const ForgotPasswordForm: React.FC<ForgotPasswordFormProps>;

package/lib/components/Forms/LoginForm.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { LoginFormProps } from './types';
+export declare const LoginForm: React.FC<LoginFormProps>;

package/lib/components/Forms/SignupForm.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { SignupFormProps } from './types';
+export declare const SignupForm: React.FC<SignupFormProps>;

package/lib/components/Forms/index.d.ts

@@ -0,0 +1,5 @@
+export { LoginForm } from './LoginForm';
+export { SignupForm } from './SignupForm';
+export { ForgotPasswordForm } from './ForgotPasswordForm';
+export { ContactForm } from './ContactForm';
+export type { LoginFormProps, SignupFormProps, SignupFormData, ForgotPasswordFormProps, ContactFormProps, ContactFormData, ContactFormField, OAuthProvider } from './types';