@platform-blocks/ui 0.1.1

package/lib/components/index.d.ts

@@ -0,0 +1,164 @@
+export { Alert } from './Alert';
+export { AppShell } from './AppShell';
+export { AppStoreBadge, AppStoreDownloadBadge, GalaxyStoreDownloadBadge, GooglePlayDownloadBadge, HuaweiAppGalleryBadge, AmazonAppstoreBadge, MicrosoftStoreDownloadBadge, SpotifyListenBadge, ApplePodcastsListenBadge, YouTubeWatchBadge, YouTubeMusicListenBadge, AppleMusicListenBadge, AmazonMusicListenBadge, SoundCloudListenBadge, AmazonStoreBadge, AmazonPrimeVideoBadge, TwitchWatchBadge, GitHubViewBadge, DiscordJoinBadge, RedditJoinBadge, TikTokWatchBadge, ChromeWebStoreBadge, } from './AppStoreBadge';
+export { AudioPlayer } from './AudioPlayer';
+export { Avatar, AvatarGroup } from './Avatar';
+export { BrandButton } from './BrandButton';
+export { Block } from './Block';
+export { Breadcrumbs } from './Breadcrumbs';
+export { Button } from './Button';
+export { Card } from './Card';
+export { Carousel } from './Carousel';
+export { Checkbox } from './Checkbox';
+export { Chip } from './Chip';
+export { CodeBlock } from './CodeBlock';
+export { CopyButton } from './CopyButton/CopyButton';
+export { ColorPicker } from './ColorPicker';
+export { Container } from './Container';
+export { DataTable } from './DataTable';
+export { Disclaimer, ComponentWithDisclaimer, useDisclaimer, withDisclaimer, extractDisclaimerProps } from './Disclaimer';
+export { Dialog, DialogProvider, DialogRenderer, useDialog, useSimpleDialog } from './Dialog';
+export { Divider } from './Divider';
+export { Space } from './Space';
+export { Flex } from './Flex';
+export { Grid } from './Grid';
+export { Tree } from './Tree';
+export { Waveform } from './Waveform';
+export { TimePicker } from './TimePicker/TimePicker';
+export { TimePickerInput } from './TimePickerInput';
+export { Icon } from './Icon';
+export { IconButton } from './IconButton';
+export { Image } from './Image';
+export { BrandIcon } from './BrandIcon';
+export { Input, PasswordInput, TextInputBase } from './Input';
+export { TextArea } from './TextArea';
+export { Overlay } from './Overlay';
+export { KeyCap } from './KeyCap';
+export { Link } from './Link';
+export { Menu, MenuItem, MenuLabel, MenuDivider, MenuDropdown } from './Menu';
+export { MenuItemButton } from './MenuItemButton';
+export { NumberInput } from './NumberInput';
+export { DatePicker, Calendar, Month, Day } from './DatePicker';
+export { MonthPicker } from './MonthPicker';
+export { YearPicker } from './YearPicker';
+export { DatePickerInput } from './DatePickerInput';
+export { MonthPickerInput } from './MonthPickerInput';
+export { YearPickerInput } from './YearPickerInput';
+export { Pagination } from './Pagination';
+export { PinInput } from './PinInput';
+export { Slider, RangeSlider } from './Slider';
+export { AutoComplete } from './AutoComplete';
+export { FileInput } from './FileInput';
+export { RichTextEditor } from './RichTextEditor';
+export { Form } from './Form';
+export { FormLayout, FormSection, FormGroup, FormField } from './FormLayout';
+export { Row, Column } from './Layout';
+export { ToastProvider, useToast, useToastApi, toast } from './Toast';
+export { Progress } from './Progress';
+export { QRCode } from './QRCode';
+export { NavigationProgress, navigationProgress } from './NavigationProgress';
+export { Radio, RadioGroup } from './Radio';
+export { Rating } from './Rating';
+export { Reveal } from './Reveal';
+export { Skeleton } from './Skeleton';
+export { Loader } from './Loader';
+export { LoadingOverlay } from './LoadingOverlay';
+export { Spotlight, SpotlightProvider, useSpotlightStore, spotlight, createSpotlightStore, useSpotlightStoreInstance, onSpotlightRequested } from './Spotlight';
+export { Stepper } from './Stepper';
+export { Switch } from './Switch';
+export { Table } from './Table';
+export { Text } from './Text';
+export { Timeline } from './Timeline';
+export { Toast } from './Toast';
+export { ToggleButton, ToggleGroup } from './Toggle';
+export { Tooltip } from './Tooltip';
+export { Tabs } from './Tabs';
+export { Accordion } from './Accordion';
+export { Gauge } from './Gauge';
+export { GradientText } from './GradientText';
+export { ShimmerText } from './ShimmerText';
+export { Title } from './Title/Title';
+export { TableOfContents } from './TableOfContents/TableOfContents';
+export { HoverCard } from './HoverCard/HoverCard';
+export { ContextMenu } from './ContextMenu';
+export { Gallery } from './Gallery';
+export type { AlertProps } from './Alert';
+export type { AppShellProps } from './AppShell';
+export type { AppStoreBadgeProps, AppStoreBadgeSize, SupportedLocale, BadgeConfig } from './AppStoreBadge';
+export type { AvatarProps, AvatarGroupProps } from './Avatar';
+export type { BrandButtonProps } from './BrandButton';
+export type { BreadcrumbsProps, BreadcrumbItem } from './Breadcrumbs';
+export { Search } from './Search/Search';
+export { SegmentedControl } from './SegmentedControl';
+export type { ButtonProps } from './Button';
+export type { CardProps } from './Card';
+export type { CarouselProps } from './Carousel';
+export type { CheckboxProps } from './Checkbox';
+export type { ChipProps } from './Chip';
+export type { CodeBlockProps } from './CodeBlock/types';
+export type { CopyButtonProps } from './CopyButton/types';
+export type { ColorPickerProps } from './ColorPicker';
+export type { ContainerProps } from './Container';
+export type { DialogProps, DialogConfig, UseSimpleDialogOptions } from './Dialog';
+export type { DividerProps } from './Divider';
+export type { SpaceProps } from './Space';
+export type { FlexProps } from './Flex';
+export type { GridProps } from './Grid';
+export type { GradientTextProps } from './GradientText';
+export type { ShimmerTextProps } from './ShimmerText';
+export type { TreeProps, TreeNode } from './Tree/Tree';
+export type { TimePickerProps, TimePickerValue } from './TimePicker/types';
+export type { IconProps, IconSize, IconVariant, IconDefinition, IconRegistry } from './Icon';
+export type { IconButtonProps } from './IconButton';
+export type { ImageProps } from './Image';
+export type { OverlayProps } from './Overlay';
+export type { InputProps, PasswordInputProps, BaseInputProps, ValidationRule } from './Input';
+export type { LinkProps } from './Link';
+export type { MenuProps, MenuItemProps, MenuLabelProps, MenuDividerProps, MenuDropdownProps } from './Menu';
+export type { MenuItemButtonProps } from './MenuItemButton';
+export type { NumberInputProps } from './NumberInput';
+export type { DatePickerProps, CalendarProps, MonthProps, DayProps, CalendarLevel, CalendarType, } from './DatePicker';
+export type { MonthPickerProps } from './MonthPicker';
+export type { YearPickerProps } from './YearPicker';
+export type { DatePickerInputProps } from './DatePickerInput';
+export type { MonthPickerInputProps } from './MonthPickerInput';
+export type { YearPickerInputProps } from './YearPickerInput';
+export type { TimePickerInputProps } from './TimePickerInput';
+export type { PaginationProps } from './Pagination';
+export type { PinInputProps } from './PinInput';
+export type { SliderProps, RangeSliderProps } from './Slider';
+export type { AutoCompleteProps, AutoCompleteOption } from './AutoComplete';
+export type { FileInputProps, FileInputFile } from './FileInput';
+export type { RichTextEditorProps, RichTextEditorContent, RichTextEditorFormat, RichTextEditorSelection } from './RichTextEditor';
+export type { FormProps, FormFieldProps, FormInputProps, FormLabelProps, FormErrorProps, FormSubmitProps } from './Form';
+export type { RowProps, ColumnProps } from './Layout';
+export type { ToastOptions, ToastPosition } from './Toast';
+export type { ProgressProps } from './Progress';
+export type { QRCodeProps } from './QRCode';
+export type { RadioProps, RadioGroupProps } from './Radio';
+export type { RatingProps } from './Rating';
+export type { SkeletonProps } from './Skeleton';
+export type { LoaderProps } from './Loader';
+export type { LoadingOverlayProps } from './LoadingOverlay';
+export type { SpotlightProps, SpotlightActionData, SpotlightActionGroupData, SpotlightItem, SpotlightState, SpotlightStore } from './Spotlight';
+export type { SwitchProps } from './Switch';
+export type { TableProps } from './Table';
+export type { DataTableProps, DataTableColumn, DataTableFilter, DataTableSort, DataTablePagination } from './DataTable';
+export type { DisclaimerProps, WithDisclaimerProps, ComponentWithDisclaimerProps, DisclaimerSupport } from './Disclaimer';
+export type { TextProps } from './Text';
+export type { ToastProps } from './Toast';
+export type { TooltipProps, TooltipPositionType } from './Tooltip';
+export type { TabsProps, TabItem } from './Tabs';
+export type { AccordionProps } from './Accordion';
+export type { GaugeProps, GaugeRange, GaugeNeedle, GaugeTicks, GaugeLabels } from './Gauge';
+export type { TitleProps } from './Title/types';
+export type { TableOfContentsProps, TocItem } from './TableOfContents/types';
+export type { StepperProps } from './Stepper';
+export type { HoverCardProps } from './HoverCard/types';
+export type { ContextMenuProps, ContextMenuItem } from './ContextMenu/ContextMenu';
+export type { SegmentedControlProps, SegmentedControlItem, SegmentedControlData } from './SegmentedControl';
+export type { GalleryProps, GalleryModalProps, GalleryItem } from './Gallery';
+export * from './Accessibility/AccessibilityHelpers';
+export * from './Accessibility/AccessibilityTesting';
+export * from './Accessibility/AccessibilityDemo';
+export * from './Button/SoundButton';

package/lib/components/optimized.d.ts

@@ -0,0 +1,74 @@
+import React from 'react';
+/**
+ * Tree-shakable component exports for bundle size optimization
+ * Import only what you need to reduce bundle size
+ */
+export { Input } from './Input/Input';
+export { TextInputBase } from './Input/InputBase';
+export { Form } from './Form';
+export type { CheckboxProps } from './Checkbox/types';
+export type { RadioProps, RadioGroupProps } from './Radio/types';
+export type { SwitchProps } from './Switch/types';
+export type { NumberInputProps } from './NumberInput/types';
+export type { PinInputProps } from './PinInput/types';
+export type { SliderProps, RangeSliderProps } from './Slider/types';
+export declare const LazyPasswordInput: React.LazyExoticComponent<React.FC<import("./Input/types").PasswordInputProps>>;
+export declare const LazyNumberInput: React.LazyExoticComponent<import("../core").PlatformBlocksComponent<{
+    props: import("./NumberInput/types").NumberInputProps;
+    ref: any;
+}>>;
+export declare const LazyPinInput: React.LazyExoticComponent<import("../core").PlatformBlocksComponent<{
+    props: import("./PinInput/types").PinInputProps;
+    ref: import("react-native").View;
+}>>;
+export declare const LazySlider: React.LazyExoticComponent<import("../core").PlatformBlocksComponent<{
+    props: import("./Slider/types").SliderProps;
+    ref: import("react-native").View;
+}>>;
+export declare const LazyRangeSlider: React.LazyExoticComponent<import("../core").PlatformBlocksComponent<{
+    props: import("./Slider/types").RangeSliderProps;
+    ref: import("react-native").View;
+}>>;
+export declare const LazyCheckbox: React.LazyExoticComponent<React.ForwardRefExoticComponent<import("./Checkbox/types").CheckboxProps & React.RefAttributes<import("react-native").View>>>;
+export declare const LazyRadio: React.LazyExoticComponent<import("../core").PlatformBlocksComponent<{
+    props: import("./Radio/types").RadioProps;
+    ref: import("react-native").View;
+}>>;
+export declare const LazyRadioGroup: React.LazyExoticComponent<import("../core").PlatformBlocksComponent<{
+    props: import("./Radio/types").RadioGroupProps;
+    ref: import("react-native").View;
+}>>;
+export declare const LazySwitch: React.LazyExoticComponent<import("../core").PlatformBlocksComponent<{
+    props: import("./Switch/types").SwitchProps;
+    ref: import("react-native").View;
+}>>;
+export { OptimizedInput, OptimizedPasswordInput } from './Input/OptimizedInput';
+export { OptimizedForm } from './Form/OptimizedForm';
+export type { ValidationRule, PasswordStrengthRule } from './Input/types';
+/**
+ * Lazy load component utility
+ */
+export declare function lazyLoadComponent<T>(importFn: () => Promise<{
+    default: React.ComponentType<T>;
+} | {
+    [key: string]: React.ComponentType<T>;
+}>, componentName?: string): React.LazyExoticComponent<React.ComponentType<T>>;
+/**
+ * Conditional component loading based on usage patterns
+ */
+export declare class ComponentLoader {
+    private static loadedComponents;
+    private static componentUsageCount;
+    static loadComponent(componentName: string): Promise<React.ComponentType<any>>;
+    private static getLoadedComponent;
+    static getUsageStats(): {
+        loadedComponents: string[];
+        usageCount: {
+            [k: string]: number;
+        };
+    };
+}
+/**
+ * Bundle analyzer utility for development
+ */
+export declare function analyzeBundleUsage(): void;

package/lib/components/types.d.ts

@@ -0,0 +1,57 @@
+export type { AlertProps } from './Alert';
+export type { AppShellProps } from './AppShell';
+export type { AvatarProps, AvatarGroupProps } from './Avatar';
+export type { BreadcrumbsProps, BreadcrumbItem } from './Breadcrumbs';
+export type { ButtonProps } from './Button';
+export type { CardProps } from './Card';
+export type { CarouselProps } from './Carousel';
+export type { CheckboxProps } from './Checkbox';
+export type { ChipProps } from './Chip';
+export type { CodeBlockProps } from './CodeBlock/types';
+export type { CopyButtonProps } from './CopyButton/types';
+export type { ColorPickerProps } from './ColorPicker';
+export type { ContainerProps } from './Container';
+export type { DialogProps } from './Dialog';
+export type { DividerProps } from './Divider';
+export type { SpaceProps } from './Space';
+export type { FlexProps } from './Flex';
+export type { GridProps } from './Grid';
+export type { IconProps } from './Icon';
+export type { BrandIconProps, BrandName } from './BrandIcon';
+export type { InputProps, PasswordInputProps, BaseInputProps } from './Input';
+export type { PhoneInputProps } from './PhoneInput/types';
+export type { LinkProps } from './Link';
+export type { MenuProps, MenuItemProps, MenuLabelProps, MenuDividerProps, MenuDropdownProps } from './Menu';
+export type { NumberInputProps } from './NumberInput';
+export type { DatePickerProps, CalendarProps, MonthProps, DayProps } from './DatePicker';
+export type { MonthPickerProps } from './MonthPicker';
+export type { YearPickerProps } from './YearPicker';
+export type { DatePickerInputProps } from './DatePickerInput';
+export type { MonthPickerInputProps } from './MonthPickerInput';
+export type { YearPickerInputProps } from './YearPickerInput';
+export type { PaginationProps } from './Pagination';
+export type { PinInputProps } from './PinInput';
+export type { SliderProps, RangeSliderProps } from './Slider';
+export type { AutoCompleteProps, AutoCompleteOption } from './AutoComplete';
+export type { FileInputProps, FileInputFile } from './FileInput';
+export type { RichTextEditorProps } from './RichTextEditor';
+export type { FormProps } from './Form';
+export type { RowProps, ColumnProps } from './Layout';
+export type { ProgressProps } from './Progress';
+export type { QRCodeProps } from './QRCode';
+export type { RadioProps, RadioGroupProps } from './Radio';
+export type { RatingProps } from './Rating';
+export type { SkeletonProps } from './Skeleton';
+export type { LoaderProps } from './Loader';
+export type { SpotlightProps } from './Spotlight';
+export type { SelectProps, SelectOption } from './Select';
+export type { SwitchProps } from './Switch';
+export type { TableProps } from './Table';
+export type { DataTableProps } from './DataTable';
+export type { TextProps } from './Text';
+export type { ToastProps } from './Toast';
+export type { TooltipProps } from './Tooltip';
+export type { TabsProps, TabItem } from './Tabs';
+export type { AccordionProps } from './Accordion';
+export type { GaugeProps } from './Gauge';
+export type { GalleryProps } from './Gallery';

package/lib/contexts/TitleRegistryContext.d.ts

@@ -0,0 +1,20 @@
+import React, { ReactNode } from 'react';
+export interface TitleItem {
+    id: string;
+    text: string;
+    order: number;
+    ref?: React.RefObject<any>;
+}
+interface TitleRegistryContextType {
+    titles: TitleItem[];
+    registerTitle: (title: TitleItem) => void;
+    unregisterTitle: (id: string) => void;
+    clearTitles: () => void;
+}
+export declare const useTitleRegistry: () => TitleRegistryContextType;
+export declare const useTitleRegistryOptional: () => TitleRegistryContextType | null;
+interface TitleRegistryProviderProps {
+    children: ReactNode;
+}
+export declare const TitleRegistryProvider: React.FC<TitleRegistryProviderProps>;
+export {};

package/lib/contexts/index.d.ts

@@ -0,0 +1 @@
+export { TitleRegistryProvider, useTitleRegistry, useTitleRegistryOptional, type TitleItem } from './TitleRegistryContext';

package/lib/core/accessibility/advancedHooks.d.ts

@@ -0,0 +1,82 @@
+import React from 'react';
+/**
+ * Hook for managing announcement queues with priorities
+ * Gracefully handles cases where AccessibilityProvider is not available (e.g., in overlays)
+ */
+export declare const useAnnouncementQueue: () => {
+    addToQueue: (message: string, priority?: "low" | "medium" | "high") => void;
+    clearQueue: () => void;
+    queueLength: number;
+};
+/**
+ * Hook for managing focus trapping within a component
+ * Gracefully handles cases where AccessibilityProvider is not available (e.g., in overlays)
+ */
+export declare const useFocusTrap: (isActive?: boolean) => {
+    containerRef: React.RefObject<any>;
+};
+/**
+ * Hook for keyboard navigation within a list of items
+ */
+export declare const useKeyboardNavigation: (items: string[], onSelect?: (id: string) => void) => {
+    activeIndex: number;
+    isFocused: boolean;
+    handleKeyPress: (event: any) => void;
+    focusItem: (index: number) => void;
+    blur: () => void;
+    activeId: string | null;
+};
+/**
+ * Hook for managing accessible form validation
+ * Gracefully handles cases where AccessibilityProvider is not available (e.g., in overlays)
+ */
+export declare const useAccessibleValidation: (fieldId: string) => {
+    errors: string[];
+    hasErrors: boolean;
+    validate: (value: any, rules: ValidationRule[]) => boolean;
+    markAsTouched: () => void;
+    clearErrors: () => void;
+    getAccessibilityProps: () => {
+        'aria-invalid': boolean;
+        'aria-describedby': string | undefined;
+    };
+    errorId: string | undefined;
+};
+interface ValidationRule {
+    validator: (value: any) => boolean;
+    message: string;
+}
+/**
+ * Hook for managing accessible loading states
+ * Gracefully handles cases where AccessibilityProvider is not available (e.g., in overlays)
+ */
+export declare const useAccessibleLoading: (initialLoading?: boolean) => {
+    isLoading: boolean;
+    loadingMessage: string;
+    progress: number | undefined;
+    startLoading: (message?: string) => void;
+    stopLoading: (successMessage?: string) => void;
+    updateProgress: (newProgress: number, message?: string) => void;
+    getAccessibilityProps: () => {
+        'aria-busy': boolean;
+        'aria-live': string;
+        'aria-label': string | undefined;
+    };
+};
+/**
+ * Hook for accessible toast notifications
+ * Gracefully handles cases where AccessibilityProvider is not available (e.g., in overlays)
+ */
+export declare const useAccessibleToast: () => {
+    toasts: Toast[];
+    showToast: (message: string, type?: "success" | "error" | "warning" | "info", duration?: number) => string;
+    removeToast: (id: string) => void;
+    clearAllToasts: () => void;
+};
+interface Toast {
+    id: string;
+    message: string;
+    type: 'success' | 'error' | 'warning' | 'info';
+    duration: number;
+}
+export {};

package/lib/core/accessibility/constants.d.ts

@@ -0,0 +1,85 @@
+export declare const ACCESSIBILITY_LABELS: {
+    readonly CLOSE: "Close";
+    readonly OPEN: "Open";
+    readonly TOGGLE: "Toggle";
+    readonly SELECT: "Select";
+    readonly DESELECT: "Deselect";
+    readonly EXPAND: "Expand";
+    readonly COLLAPSE: "Collapse";
+    readonly PREVIOUS: "Previous";
+    readonly NEXT: "Next";
+    readonly FIRST: "First";
+    readonly LAST: "Last";
+    readonly PAGE_UP: "Page up";
+    readonly PAGE_DOWN: "Page down";
+    readonly REQUIRED: "Required field";
+    readonly OPTIONAL: "Optional field";
+    readonly INVALID: "Invalid input";
+    readonly VALID: "Valid input";
+    readonly LOADING: "Loading";
+    readonly ERROR: "Error";
+    readonly SUCCESS: "Success";
+    readonly WARNING: "Warning";
+    readonly ITEM_OF: "Item {current} of {total}";
+    readonly PAGE_OF: "Page {current} of {total}";
+    readonly SELECTED_ITEMS: "{count} items selected";
+};
+export declare const ACCESSIBILITY_ROLES: {
+    readonly BUTTON: "button";
+    readonly LINK: "link";
+    readonly CHECKBOX: "checkbox";
+    readonly RADIO: "radio";
+    readonly SWITCH: "switch";
+    readonly SLIDER: "slider";
+    readonly TEXTBOX: "textbox";
+    readonly SEARCH: "search";
+    readonly COMBOBOX: "combobox";
+    readonly SPINBUTTON: "spinbutton";
+    readonly MAIN: "main";
+    readonly BANNER: "banner";
+    readonly CONTENTINFO: "contentinfo";
+    readonly NAVIGATION: "navigation";
+    readonly COMPLEMENTARY: "complementary";
+    readonly HEADING: "heading";
+    readonly LIST: "list";
+    readonly LISTITEM: "listitem";
+    readonly TABLE: "table";
+    readonly ROW: "row";
+    readonly CELL: "cell";
+    readonly MENU: "menu";
+    readonly MENUITEM: "menuitem";
+    readonly TAB: "tab";
+    readonly TABPANEL: "tabpanel";
+    readonly TABLIST: "tablist";
+    readonly ALERT: "alert";
+    readonly STATUS: "status";
+    readonly LOG: "log";
+    readonly MARQUEE: "marquee";
+    readonly TIMER: "timer";
+};
+export declare const ACCESSIBILITY_STATES: {
+    readonly CHECKED: "checked";
+    readonly SELECTED: "selected";
+    readonly PRESSED: "pressed";
+    readonly DISABLED: "disabled";
+    readonly READONLY: "readonly";
+    readonly REQUIRED: "required";
+    readonly EXPANDED: "expanded";
+    readonly COLLAPSED: "collapsed";
+    readonly HIDDEN: "hidden";
+    readonly INVALID: "invalid";
+    readonly VALID: "valid";
+};
+export declare const FOCUS_TRAP_SELECTOR = "[data-focus-trap]";
+export declare const FOCUSABLE_ELEMENTS: string;
+export declare const MOTION_DURATIONS: {
+    readonly INSTANT: 0;
+    readonly FAST: 150;
+    readonly NORMAL: 300;
+    readonly SLOW: 500;
+    readonly REDUCED: 0;
+};
+export declare const ANNOUNCEMENT_PRIORITY: {
+    readonly POLITE: "polite";
+    readonly ASSERTIVE: "assertive";
+};

package/lib/core/accessibility/context.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { AccessibilityContextValue, AccessibilityProviderProps } from './types';
+export declare const AccessibilityProvider: React.FC<AccessibilityProviderProps>;
+export declare const useAccessibility: () => AccessibilityContextValue;
+export declare const useOptionalAccessibility: () => AccessibilityContextValue | null;

package/lib/core/accessibility/hooks.d.ts

@@ -0,0 +1,33 @@
+import type { FocusOptions, AnnouncementOptions, ScreenReaderInfo } from './types';
+/**
+ * Hook for managing focus state and restoration
+ * Gracefully handles cases where AccessibilityProvider is not available (e.g., in overlays)
+ */
+export declare const useFocus: (id: string, options?: FocusOptions) => {
+    ref: import("react").RefObject<any>;
+    focus: () => void;
+    blur: () => void;
+    isFocused: boolean;
+};
+/**
+ * Hook for making announcements to screen readers
+ * Gracefully handles cases where AccessibilityProvider is not available (e.g., in overlays)
+ */
+export declare const useAnnouncer: () => {
+    announce: (message: string, options?: AnnouncementOptions) => void;
+    screenReaderEnabled: boolean;
+};
+/**
+ * Hook for detecting reduced motion preferences
+ * Gracefully handles cases where AccessibilityProvider is not available (e.g., in overlays)
+ */
+export declare const useReducedMotion: () => {
+    prefersReducedMotion: boolean;
+    getDuration: (normalDuration: number) => number;
+    getScale: (normalScale: number) => number;
+};
+/**
+ * Hook for screen reader detection and information
+ * Gracefully handles cases where AccessibilityProvider is not available (e.g., in overlays)
+ */
+export declare const useScreenReader: () => ScreenReaderInfo;

package/lib/core/accessibility/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './hooks';
+export * from './context';
+export * from './utils';
+export * from './constants';
+export * from './advancedHooks';

package/lib/core/accessibility/types.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+export interface AccessibilityContextValue {
+    prefersReducedMotion: boolean;
+    currentFocusId: string | null;
+    focusHistory: string[];
+    screenReaderEnabled: boolean;
+    announcements: string[];
+    setFocus: (id: string) => void;
+    restoreFocus: () => void;
+    announce: (message: string, priority?: 'polite' | 'assertive') => void;
+    clearAnnouncements: () => void;
+}
+export interface AccessibilityProviderProps {
+    children: React.ReactNode;
+    reducedMotion?: boolean;
+}
+export interface FocusableElement {
+    id: string;
+    ref: React.RefObject<any>;
+    priority?: number;
+}
+export interface FocusOptions {
+    preventScroll?: boolean;
+    restoreOnUnmount?: boolean;
+}
+export interface AnnouncementOptions {
+    priority?: 'polite' | 'assertive';
+    timeout?: number;
+    clearPrevious?: boolean;
+}
+export type MotionPreference = 'no-preference' | 'reduce';
+export interface ScreenReaderInfo {
+    enabled: boolean;
+    type?: 'voiceover' | 'talkback' | 'nvda' | 'jaws' | 'unknown';
+}

package/lib/core/accessibility/utils.d.ts

@@ -0,0 +1,56 @@
+import { AccessibilityRole, AccessibilityState } from 'react-native';
+/**
+ * Generate accessible label with context
+ */
+export declare const createAccessibleLabel: (label: string, context?: {
+    required?: boolean;
+    invalid?: boolean;
+    current?: number;
+    total?: number;
+    selected?: boolean;
+}) => string;
+/**
+ * Generate accessibility props for React Native components
+ */
+export declare const createAccessibilityProps: (options: {
+    role?: AccessibilityRole;
+    label?: string;
+    hint?: string;
+    state?: AccessibilityState;
+    value?: {
+        min?: number;
+        max?: number;
+        now?: number;
+        text?: string;
+    };
+    actions?: Array<{
+        name: string;
+        label?: string;
+    }>;
+    disabled?: boolean;
+    selected?: boolean;
+}) => any;
+/**
+ * Format numbers for screen readers (e.g., "1,000" becomes "1 thousand")
+ */
+export declare const formatNumberForScreenReader: (num: number) => string;
+/**
+ * Format time duration for screen readers
+ */
+export declare const formatDurationForScreenReader: (seconds: number) => string;
+/**
+ * Get appropriate ARIA role based on component type
+ */
+export declare const getAriaRole: (componentType: string) => AccessibilityRole | undefined;
+/**
+ * Check if an element should be focusable
+ */
+export declare const isFocusable: (element: any) => boolean;
+/**
+ * Debounce announcements to prevent spam
+ */
+export declare const debounceAnnouncement: (key: string, announcement: () => void, delay?: number) => void;
+/**
+ * Get reading time estimate for content
+ */
+export declare const getReadingTime: (text: string, wordsPerMinute?: number) => string;

package/lib/core/animations/index.d.ts

@@ -0,0 +1,2 @@
+export { createTransition, createSpringTransition, TRANSITION_EASINGS, DEFAULT_TRANSITION_CONFIG } from './transitions';
+export type { TransitionConfig, TransitionType } from './transitions';