@platform-blocks/ui 0.5.0 → 0.6.0

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

@@ -4,9 +4,11 @@ import { SpacingProps } from '../../core/utils';
 import type { ResponsiveSize } from '../AppShell/types';
 import type { ComponentSizeValue } from '../../core/theme/componentSize';
 export interface CarouselProps extends SpacingProps {
+    /** Array of carousel slide elements */
     children: React.ReactNode[];
     /** Orientation of the carousel */
     orientation?: 'horizontal' | 'vertical';
+    /** Show navigation arrow buttons */
     showArrows?: boolean;
     /** Show navigation dots */
     showDots?: boolean;
@@ -55,16 +57,28 @@ export interface CarouselProps extends SpacingProps {
     };
     /** Responsive gap between slides (overrides itemGap). Accepts spacing token string or number or responsive map. */
     slideGap?: ResponsiveSize;
+    /** Gap between slides in pixels */
     itemGap?: number;
+    /** Fixed height of the carousel container */
     height?: number;
+    /** Callback fired when the active slide changes */
     onSlideChange?: (index: number) => void;
+    /** Style override for the carousel container */
     style?: ViewStyle;
+    /** Style override applied to each slide item */
     itemStyle?: ViewStyle;
+    /** Enable snapping to individual items */
     snapToItem?: boolean;
+    /** Position of navigation arrows relative to the carousel */
     arrowPosition?: 'inside' | 'outside';
+    /** Size of the navigation arrow buttons */
     arrowSize?: ComponentSizeValue;
+    /** Size of the navigation dots */
     dotSize?: ComponentSizeValue;
+    /** Enable or disable scroll gestures */
     scrollEnabled?: boolean;
+    /** Disable animated width/color transitions for dots and snapping */
     reducedMotion?: boolean;
+    /** Number of logical pages to render for virtualization */
     windowSize?: number;
 }

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

@@ -1,7 +1,7 @@
 import React from 'react';
 import { ViewStyle, View } from 'react-native';
 import { SizeValue } from '../../core/theme/sizes';
-export type HoverCardPosition = 'top' | 'bottom' | 'left' | 'right';
+export type HoverCardPosition = 'top' | 'bottom' | 'left' | 'right' | 'auto';
 export type HoverCardShadow = 'none' | 'sm' | 'md' | 'lg';
 export interface HoverCardProps {
     /** Floating content */
@@ -22,7 +22,7 @@ export interface HoverCardProps {
     shadow?: HoverCardShadow;
     /** Corner radius */
     radius?: SizeValue;
-    /** Whether rendered in portal (not yet implemented) */
+    /** Whether rendered in portal (deprecated - always uses portal) */
     withinPortal?: boolean;
     /** Fixed width */
     width?: number;
@@ -46,6 +46,8 @@ export interface HoverCardProps {
     keepMounted?: boolean;
     /** Trigger mode */
     trigger?: 'hover' | 'click';
+    /** Positioning strategy: 'fixed' for web, 'portal' for native */
+    strategy?: 'fixed' | 'portal';
 }
 export interface HoverCardFactoryPayload {
     props: HoverCardProps;

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

@@ -29,6 +29,8 @@ export interface PopoverProps extends SpacingProps {
     onClose?: () => void;
     /** Called when popover is dismissed via outside click or escape */
     onDismiss?: () => void;
+    /** How the popover is triggered: 'click' (default) or 'hover' (mostly useful for devices with a mouse) */
+    trigger?: 'click' | 'hover';
     /** Disable popover entirely */
     disabled?: boolean;
     /** Close when clicking outside */

package/lib/components/Switch/styles.d.ts

@@ -26,7 +26,7 @@ export declare const useSwitchStyles: (props: SwitchStyleProps & {
         lineHeight: number;
     };
     labelContainer: {
-        flex: number;
+        flexShrink: number;
         justifyContent: "center";
     };
     labelDisabled: {

package/lib/components/TextArea/styles.d.ts

@@ -40,7 +40,7 @@ export declare const useTextAreaStyles: (props: TextAreaProps & {
             backgroundColor: string;
             borderColor: string;
             borderRadius: 8;
-            borderWidth: 2;
+            borderWidth: number;
             paddingHorizontal: 8;
             paddingVertical: 4;
         };

package/lib/components/index.d.ts

@@ -57,7 +57,6 @@ export { Row, Column } from './Layout';
 export { ToastProvider, useToast, useToastApi } 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 { Collapse } from './Collapse';
@@ -82,7 +81,6 @@ export { ShimmerText } from './ShimmerText';
 export { Highlight } from './Highlight';
 export { Title } from './Title/Title';
 export { TableOfContents } from './TableOfContents/TableOfContents';
-export { HoverCard } from './HoverCard/HoverCard';
 export { ContextMenu } from './ContextMenu';
 export { Popover } from './Popover';
 export { Gallery } from './Gallery';

package/lib/core/providers/OverlayProvider.d.ts

@@ -3,7 +3,7 @@ export interface OverlayConfig {
     id: string;
     content: ReactNode;
     trigger?: 'click' | 'hover' | 'contextmenu' | 'manual';
-    placement?: 'top' | 'bottom' | 'left' | 'right' | 'auto';
+    placement?: 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end' | 'auto';
     offset?: number;
     anchor?: {
         x: number;

package/lib/core/theme/PlatformBlocksProvider.d.ts

@@ -3,11 +3,9 @@ import { PlatformBlocksThemeProviderProps } from './ThemeProvider';
 import type { DirectionProviderProps } from '../providers';
 import type { HighlightProps as HighlightComponentProps } from '../../components/Highlight';
 import type { HapticsProviderProps } from '../haptics/HapticsProvider';
-import type { PermissionProviderProps } from '../../components/Can';
 import { ThemeModeConfig } from './ThemeModeProvider';
 type DirectionProviderConfig = Omit<DirectionProviderProps, 'children'>;
 type HapticsProviderConfig = Omit<HapticsProviderProps, 'children'>;
-type PermissionProviderConfig = Omit<PermissionProviderProps, 'children'>;
 export interface PlatformBlocksProviderProps extends Omit<PlatformBlocksThemeProviderProps, 'children'> {
     /** Your application */
     children: React.ReactNode;
@@ -52,14 +50,12 @@ export interface PlatformBlocksProviderProps extends Omit<PlatformBlocksThemePro
     direction?: false | DirectionProviderConfig;
     /** Haptics context configuration (pass false to opt out) */
     haptics?: false | HapticsProviderConfig;
-    /** Permission context configuration (pass false to opt out) */
-    permissions?: false | PermissionProviderConfig;
 }
 /**
  * Main provider component for Platform Blocks library
  * Provides theme context and injects CSS variables
  */
-export declare function PlatformBlocksProvider({ children, theme, inherit, withCSSVariables, cssVariablesSelector, colorSchemeMode, withOverlays, withSpotlight, withGlobalCSS, themeModeConfig, spotlightConfig, locale, fallbackLocale, i18nResources, direction, haptics, permissions }: PlatformBlocksProviderProps): React.JSX.Element;
+export declare function PlatformBlocksProvider({ children, theme, inherit, withCSSVariables, cssVariablesSelector, colorSchemeMode, withOverlays, withSpotlight, withGlobalCSS, themeModeConfig, spotlightConfig, locale, fallbackLocale, i18nResources, direction, haptics }: PlatformBlocksProviderProps): React.JSX.Element;
 export declare namespace PlatformBlocksProvider {
     var displayName: string;
 }