@idealyst/components 1.2.11 → 1.2.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idealyst/components",
-  "version": "1.2.11",
+  "version": "1.2.12",
   "description": "Shared component library for React and React Native",
   "documentation": "https://github.com/IdealystIO/idealyst-framework/tree/main/packages/components#readme",
   "readme": "README.md",
@@ -56,7 +56,7 @@
     "publish:npm": "npm publish"
   },
   "peerDependencies": {
-    "@idealyst/theme": "^1.2.11",
+    "@idealyst/theme": "^1.2.12",
     "@mdi/js": ">=7.0.0",
     "@mdi/react": ">=1.0.0",
     "@react-native-vector-icons/common": ">=12.0.0",
@@ -106,7 +106,7 @@
     }
   },
   "devDependencies": {
-    "@idealyst/theme": "^1.2.11",
+    "@idealyst/theme": "^1.2.12",
     "@idealyst/tooling": "^1.2.4",
     "@mdi/react": "^1.6.1",
     "@types/react": "^19.1.0",

package/src/Platform/Platform.native.ts

@@ -0,0 +1,35 @@
+import { Platform as RNPlatform } from 'react-native';
+import type { PlatformAPI, PlatformSelectSpec, PlatformSystem } from './types';
+
+const system: PlatformSystem = RNPlatform.OS === 'ios' ? 'ios' : 'android';
+
+/**
+ * Platform utility for React Native (iOS and Android)
+ */
+const Platform: PlatformAPI = {
+    system,
+    isWeb: false,
+    isNative: true,
+    isIOS: RNPlatform.OS === 'ios',
+    isAndroid: RNPlatform.OS === 'android',
+
+    select<T>(spec: PlatformSelectSpec<T>): T | undefined {
+        // First check for specific platform
+        if (system === 'ios' && spec.ios !== undefined) {
+            return spec.ios;
+        }
+        if (system === 'android' && spec.android !== undefined) {
+            return spec.android;
+        }
+
+        // Then check for native fallback
+        if (spec.native !== undefined) {
+            return spec.native;
+        }
+
+        // Finally check for default
+        return spec.default;
+    },
+};
+
+export default Platform;

package/src/Platform/Platform.web.ts

@@ -0,0 +1,21 @@
+import type { PlatformAPI, PlatformSelectSpec, PlatformSystem } from './types';
+
+/**
+ * Platform utility for web
+ */
+const Platform: PlatformAPI = {
+    system: 'web' as PlatformSystem,
+    isWeb: true,
+    isNative: false,
+    isIOS: false,
+    isAndroid: false,
+
+    select<T>(spec: PlatformSelectSpec<T>): T | undefined {
+        if (spec.web !== undefined) {
+            return spec.web;
+        }
+        return spec.default;
+    },
+};
+
+export default Platform;

package/src/Platform/index.native.ts

@@ -0,0 +1,2 @@
+export { default } from './Platform.native';
+export * from './types';

package/src/Platform/index.ts

@@ -0,0 +1,2 @@
+export { default } from './Platform.web';
+export * from './types';

package/src/Platform/types.ts

@@ -0,0 +1,65 @@
+/**
+ * Platform system types
+ */
+export type PlatformSystem = 'web' | 'ios' | 'android';
+
+/**
+ * Platform select specification
+ * Allows selecting a value based on the current platform
+ */
+export type PlatformSelectSpec<T> = {
+    web?: T;
+    ios?: T;
+    android?: T;
+    native?: T;  // Fallback for ios and android
+    default?: T; // Fallback for any platform
+};
+
+/**
+ * Platform API interface
+ */
+export interface PlatformAPI {
+    /**
+     * The current platform system: 'web', 'ios', or 'android'
+     */
+    system: PlatformSystem;
+
+    /**
+     * Whether the current platform is web
+     */
+    isWeb: boolean;
+
+    /**
+     * Whether the current platform is native (ios or android)
+     */
+    isNative: boolean;
+
+    /**
+     * Whether the current platform is iOS
+     */
+    isIOS: boolean;
+
+    /**
+     * Whether the current platform is Android
+     */
+    isAndroid: boolean;
+
+    /**
+     * Select a value based on the current platform
+     *
+     * @example
+     * const padding = Platform.select({
+     *   web: 20,
+     *   ios: 16,
+     *   android: 14,
+     *   default: 12,
+     * });
+     *
+     * @example
+     * const fontFamily = Platform.select({
+     *   web: 'Inter',
+     *   native: 'System',
+     * });
+     */
+    select<T>(spec: PlatformSelectSpec<T>): T | undefined;
+}

package/src/index.native.ts

@@ -101,8 +101,11 @@ export * from './Chip/types';
 export { default as Breadcrumb } from './Breadcrumb';
 export * from './Breadcrumb/types';
 
-export { default as Link } from './Link';                                                               
-export * from './Link/types';  
+export { default as Link } from './Link';
+export * from './Link/types';
+
+export { default as Platform } from './Platform';
+export * from './Platform/types';
 
 export type { ButtonProps } from './Button/types';
 export type { TextProps } from './Text/types';
@@ -137,6 +140,7 @@ export type { SkeletonProps, SkeletonGroupProps, SkeletonShape, SkeletonAnimatio
 export type { ChipProps, ChipSize, ChipIntent } from './Chip/types';
 export type { BreadcrumbProps, BreadcrumbItem } from './Breadcrumb/types';
 export type { LinkProps } from './Link/types';
+export type { PlatformAPI, PlatformSystem, PlatformSelectSpec } from './Platform/types';
 
 // Event utilities
 export * from './utils/events';

package/src/index.ts

@@ -109,6 +109,9 @@ export * from './Chip/types';
 export { default as Breadcrumb } from './Breadcrumb';
 export * from './Breadcrumb/types';
 
+export { default as Platform } from './Platform';
+export * from './Platform/types';
+
 export type { ButtonProps } from './Button/types';
 export type { TextProps } from './Text/types';
 export type { ViewProps } from './View/types';
@@ -142,6 +145,7 @@ export type { AlertProps } from './Alert/types';
 export type { SkeletonProps, SkeletonGroupProps, SkeletonShape, SkeletonAnimation } from './Skeleton/types';
 export type { ChipProps, ChipSize, ChipIntent } from './Chip/types';
 export type { BreadcrumbProps, BreadcrumbItem } from './Breadcrumb/types';
+export type { PlatformAPI, PlatformSystem, PlatformSelectSpec } from './Platform/types';
 
 export { useMergeRefs };