@tekton-ui/core 0.2.0

package/dist/layout-tokens/keyboard.d.ts

@@ -0,0 +1,254 @@
+/**
+ * @tekton-ui/core - Keyboard Utilities
+ * Keyboard handling and avoidance utilities for mobile and web platforms
+ * [SPEC-LAYOUT-004] [MILESTONE-4]
+ */
+import type { KeyboardConfig, KeyboardAnimationConfig } from './types.js';
+/**
+ * Keyboard state for tracking visibility and dimensions
+ */
+export interface KeyboardState {
+    /** Whether the keyboard is currently visible */
+    isVisible: boolean;
+    /** Current keyboard height in points/dp (0 if hidden) */
+    height: number;
+    /** Animation progress from 0.0 (hidden) to 1.0 (fully visible) */
+    progress: number;
+}
+/**
+ * Keyboard event types
+ */
+export type KeyboardEventType = 'show' | 'hide' | 'change';
+/**
+ * Keyboard event listener callback
+ */
+export type KeyboardEventListener = (height: number) => void;
+/**
+ * Layout object that can be modified by keyboard avoidance
+ */
+export interface KeyboardAwareLayout {
+    /** Padding values */
+    padding?: {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    };
+    /** Height dimension */
+    height?: number;
+    /** Transform values */
+    transform?: Array<{
+        translateY?: number;
+        [key: string]: unknown;
+    }>;
+    /** Position values */
+    position?: {
+        bottom?: number;
+        top?: number;
+        left?: number;
+        right?: number;
+    };
+    /** Allow additional properties */
+    [key: string]: unknown;
+}
+/**
+ * Get current keyboard height
+ *
+ * @returns Keyboard height in points/dp (0 if hidden or unavailable)
+ *
+ * @example
+ * ```typescript
+ * const keyboardHeight = getKeyboardHeight();
+ * console.log(keyboardHeight); // 336 on iPhone, varies on Android, 0 on web
+ * ```
+ *
+ * @remarks
+ * - On web: Always returns 0 (no software keyboard tracking)
+ * - On iOS: Returns keyboard height from Keyboard API (typically 336pt on iPhone)
+ * - On Android: Returns keyboard height from Keyboard API (varies by device)
+ * - Falls back to 0 if Keyboard API is unavailable
+ */
+export declare function getKeyboardHeight(): number;
+/**
+ * Apply keyboard avoidance strategy to a layout
+ *
+ * @param layout - Layout object to modify
+ * @param config - Keyboard configuration defining avoidance strategy
+ * @returns Modified layout with keyboard avoidance applied
+ *
+ * @example
+ * ```typescript
+ * const layout = { padding: { bottom: 0 }, height: 812 };
+ * const keyboardHeight = 336;
+ * const adjusted = applyKeyboardAvoidance(layout, {
+ *   avoidance: 'padding',
+ *   behavior: 'height',
+ *   animation: { duration: 250, easing: 'keyboard', enabled: true },
+ *   dismissMode: 'interactive'
+ * });
+ * console.log(adjusted.padding.bottom); // 336
+ * ```
+ *
+ * @remarks
+ * Avoidance strategies:
+ * - 'padding': Adds keyboard height to bottom padding
+ * - 'resize': Reduces container height by keyboard height
+ * - 'position': Translates container up by keyboard height
+ * - 'none': Returns layout unchanged
+ *
+ * The behavior property determines how the adjustment is applied:
+ * - 'height': Modifies height property (for resize strategy)
+ * - 'position': Modifies transform/translateY (for position strategy)
+ * - 'padding': Modifies padding (for padding strategy)
+ */
+export declare function applyKeyboardAvoidance(layout: KeyboardAwareLayout, config: KeyboardConfig): KeyboardAwareLayout;
+/**
+ * React Native hook to track keyboard state
+ *
+ * @returns KeyboardState object with isVisible, height, progress
+ *
+ * @example
+ * ```typescript
+ * function MyComponent() {
+ *   const keyboard = useKeyboardAvoidance();
+ *   return (
+ *     <View style={{
+ *       paddingBottom: keyboard.isVisible ? keyboard.height : 0
+ *     }} />
+ *   );
+ * }
+ * ```
+ *
+ * @remarks
+ * This is a placeholder implementation that returns default values.
+ * In production, integrate with react-native-keyboard-controller:
+ *
+ * ```typescript
+ * import { useReanimatedKeyboardAnimation } from 'react-native-keyboard-controller';
+ *
+ * export function useKeyboardAvoidance(): KeyboardState {
+ *   const { height, progress } = useReanimatedKeyboardAnimation();
+ *   return {
+ *     isVisible: height.value > 0,
+ *     height: height.value,
+ *     progress: progress.value,
+ *   };
+ * }
+ * ```
+ *
+ * @see https://github.com/kirillzyusko/react-native-keyboard-controller
+ */
+export declare function useKeyboardAvoidance(): KeyboardState;
+/**
+ * Add keyboard event listener
+ *
+ * @param event - Event type to listen for ('show' | 'hide' | 'change')
+ * @param listener - Callback function receiving keyboard height
+ * @returns Cleanup function to remove listener
+ *
+ * @example
+ * ```typescript
+ * const unsubscribe = addKeyboardListener('show', (height) => {
+ *   console.log('Keyboard shown with height:', height);
+ * });
+ *
+ * // Later: unsubscribe();
+ * ```
+ *
+ * @remarks
+ * - On web: Returns no-op cleanup function (no keyboard events)
+ * - On React Native: Uses Keyboard.addListener() API
+ * - Supported events: 'show', 'hide', 'change'
+ * - Always call the cleanup function to prevent memory leaks
+ */
+export declare function addKeyboardListener(event: KeyboardEventType, listener: KeyboardEventListener): () => void;
+/**
+ * Get platform-specific keyboard animation duration
+ *
+ * @returns Animation duration in milliseconds
+ *
+ * @example
+ * ```typescript
+ * const duration = getKeyboardAnimationDuration();
+ * // iOS: 250, Android: 300, Web: 0
+ * ```
+ *
+ * @remarks
+ * Default animation durations:
+ * - iOS: 250ms (from UIKit keyboard animation)
+ * - Android: 300ms (from WindowInsetsAnimationCompat)
+ * - Web: 0ms (no keyboard animation)
+ */
+export declare function getKeyboardAnimationDuration(): number;
+/**
+ * Calculate keyboard-aware bottom spacing
+ *
+ * @param baseSpacing - Base spacing value in points/dp
+ * @param includeKeyboard - Whether to include keyboard height (default: true)
+ * @returns Total spacing including keyboard height if applicable
+ *
+ * @example
+ * ```typescript
+ * // With keyboard visible (height: 336)
+ * const spacing = getKeyboardAwareBottomSpacing(16, true);
+ * console.log(spacing); // 352 (16 + 336)
+ *
+ * // Without keyboard consideration
+ * const spacing = getKeyboardAwareBottomSpacing(16, false);
+ * console.log(spacing); // 16
+ * ```
+ *
+ * @remarks
+ * Useful for calculating dynamic spacing that accounts for keyboard visibility.
+ * Common use cases:
+ * - Bottom padding for scrollable content
+ * - Bottom margin for floating action buttons
+ * - Bottom inset for safe area + keyboard
+ */
+export declare function getKeyboardAwareBottomSpacing(baseSpacing: number, includeKeyboard?: boolean): number;
+/**
+ * Get default keyboard animation configuration for current platform
+ *
+ * @returns KeyboardAnimationConfig with platform-specific defaults
+ *
+ * @example
+ * ```typescript
+ * const animConfig = getDefaultKeyboardAnimation();
+ * // iOS: { duration: 250, easing: 'keyboard', enabled: true }
+ * // Android: { duration: 300, easing: 'keyboard', enabled: true }
+ * // Web: { duration: 0, easing: 'linear', enabled: false }
+ * ```
+ */
+export declare function getDefaultKeyboardAnimation(): KeyboardAnimationConfig;
+/**
+ * Check if keyboard is currently visible
+ *
+ * @returns True if keyboard is visible, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (isKeyboardVisible()) {
+ *   console.log('Keyboard is visible');
+ * }
+ * ```
+ */
+export declare function isKeyboardVisible(): boolean;
+/**
+ * Get keyboard behavior progress tracking mode
+ *
+ * @returns Progress tracking mode ('binary' for iOS, 'continuous' for Android, 'none' for web)
+ *
+ * @example
+ * ```typescript
+ * const mode = getKeyboardProgressMode();
+ * // iOS: 'binary' (0 or 1 only)
+ * // Android: 'continuous' (0, 0.07, 0.12, ..., 1.0)
+ * // Web: 'none'
+ * ```
+ *
+ * @remarks
+ * iOS keyboard animations have binary progress (0 or 1) due to willShow/willHide notifications.
+ * Android keyboard animations have continuous progress tracking via WindowInsetsAnimationCompat.
+ */
+export declare function getKeyboardProgressMode(): 'binary' | 'continuous' | 'none';
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/layout-tokens/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/layout-tokens/keyboard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAwC1E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IAEnB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IAEf,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uBAAuB;IACvB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IAEnE,sBAAsB;IACtB,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,kCAAkC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CA8B1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,cAAc,GACrB,mBAAmB,CA4CrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,CAQpD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,IAAI,CA8CZ;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAYrD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,UAAO,GAAG,MAAM,CAOjG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,IAAI,uBAAuB,CAwBrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,IAAI,QAAQ,GAAG,YAAY,GAAG,MAAM,CAY1E"}

package/dist/layout-tokens/keyboard.js

@@ -0,0 +1,407 @@
+/**
+ * @tekton-ui/core - Keyboard Utilities
+ * Keyboard handling and avoidance utilities for mobile and web platforms
+ * [SPEC-LAYOUT-004] [MILESTONE-4]
+ */
+// ============================================================================
+// Platform Detection
+// ============================================================================
+/**
+ * Detect current platform
+ * @internal
+ */
+function detectPlatform() {
+    // Check if running in React Native environment
+    if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {
+        // Detect iOS or Android
+        const globalAny = global;
+        const Platform = globalAny.Platform;
+        if (Platform && Platform.OS) {
+            return Platform.OS === 'ios' ? 'ios' : 'android';
+        }
+    }
+    return 'web';
+}
+/**
+ * Check if React Native Keyboard API is available
+ * @internal
+ */
+function isKeyboardAPIAvailable() {
+    try {
+        const globalAny = global;
+        return typeof globalAny.Keyboard !== 'undefined';
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// Core Functions
+// ============================================================================
+/**
+ * Get current keyboard height
+ *
+ * @returns Keyboard height in points/dp (0 if hidden or unavailable)
+ *
+ * @example
+ * ```typescript
+ * const keyboardHeight = getKeyboardHeight();
+ * console.log(keyboardHeight); // 336 on iPhone, varies on Android, 0 on web
+ * ```
+ *
+ * @remarks
+ * - On web: Always returns 0 (no software keyboard tracking)
+ * - On iOS: Returns keyboard height from Keyboard API (typically 336pt on iPhone)
+ * - On Android: Returns keyboard height from Keyboard API (varies by device)
+ * - Falls back to 0 if Keyboard API is unavailable
+ */
+export function getKeyboardHeight() {
+    const platform = detectPlatform();
+    // Web platform: no keyboard tracking
+    if (platform === 'web') {
+        return 0;
+    }
+    // React Native: try to get keyboard height
+    if (isKeyboardAPIAvailable()) {
+        try {
+            const globalAny = global;
+            const Keyboard = globalAny.Keyboard;
+            // Check if there's an active keyboard metrics method
+            if (typeof Keyboard?.metrics === 'function') {
+                const metrics = Keyboard.metrics();
+                return metrics?.height ?? 0;
+            }
+            // Alternative: check stored keyboard height (if available)
+            // This would require integration with react-native-keyboard-controller
+            // or a custom keyboard state manager
+        }
+        catch (error) {
+            console.warn('[Keyboard] Failed to get keyboard height:', error);
+        }
+    }
+    // Fallback: return 0
+    return 0;
+}
+/**
+ * Apply keyboard avoidance strategy to a layout
+ *
+ * @param layout - Layout object to modify
+ * @param config - Keyboard configuration defining avoidance strategy
+ * @returns Modified layout with keyboard avoidance applied
+ *
+ * @example
+ * ```typescript
+ * const layout = { padding: { bottom: 0 }, height: 812 };
+ * const keyboardHeight = 336;
+ * const adjusted = applyKeyboardAvoidance(layout, {
+ *   avoidance: 'padding',
+ *   behavior: 'height',
+ *   animation: { duration: 250, easing: 'keyboard', enabled: true },
+ *   dismissMode: 'interactive'
+ * });
+ * console.log(adjusted.padding.bottom); // 336
+ * ```
+ *
+ * @remarks
+ * Avoidance strategies:
+ * - 'padding': Adds keyboard height to bottom padding
+ * - 'resize': Reduces container height by keyboard height
+ * - 'position': Translates container up by keyboard height
+ * - 'none': Returns layout unchanged
+ *
+ * The behavior property determines how the adjustment is applied:
+ * - 'height': Modifies height property (for resize strategy)
+ * - 'position': Modifies transform/translateY (for position strategy)
+ * - 'padding': Modifies padding (for padding strategy)
+ */
+export function applyKeyboardAvoidance(layout, config) {
+    const keyboardHeight = getKeyboardHeight();
+    // No keyboard or no avoidance needed
+    if (keyboardHeight === 0 || config.avoidance === 'none') {
+        return layout;
+    }
+    // Create a copy of the layout to avoid mutation
+    const adjustedLayout = { ...layout };
+    // Apply avoidance strategy
+    switch (config.avoidance) {
+        case 'padding': {
+            // Add keyboard height to bottom padding
+            const currentPadding = layout.padding ?? {};
+            adjustedLayout.padding = {
+                ...currentPadding,
+                bottom: (currentPadding.bottom ?? 0) + keyboardHeight,
+            };
+            break;
+        }
+        case 'resize': {
+            // Reduce container height by keyboard height
+            if (typeof layout.height === 'number') {
+                adjustedLayout.height = layout.height - keyboardHeight;
+            }
+            break;
+        }
+        case 'position': {
+            // Translate container up by keyboard height
+            const currentTransform = layout.transform ?? [];
+            adjustedLayout.transform = [...currentTransform, { translateY: -keyboardHeight }];
+            break;
+        }
+        default:
+            // Unknown avoidance strategy, return unchanged
+            break;
+    }
+    return adjustedLayout;
+}
+/**
+ * React Native hook to track keyboard state
+ *
+ * @returns KeyboardState object with isVisible, height, progress
+ *
+ * @example
+ * ```typescript
+ * function MyComponent() {
+ *   const keyboard = useKeyboardAvoidance();
+ *   return (
+ *     <View style={{
+ *       paddingBottom: keyboard.isVisible ? keyboard.height : 0
+ *     }} />
+ *   );
+ * }
+ * ```
+ *
+ * @remarks
+ * This is a placeholder implementation that returns default values.
+ * In production, integrate with react-native-keyboard-controller:
+ *
+ * ```typescript
+ * import { useReanimatedKeyboardAnimation } from 'react-native-keyboard-controller';
+ *
+ * export function useKeyboardAvoidance(): KeyboardState {
+ *   const { height, progress } = useReanimatedKeyboardAnimation();
+ *   return {
+ *     isVisible: height.value > 0,
+ *     height: height.value,
+ *     progress: progress.value,
+ *   };
+ * }
+ * ```
+ *
+ * @see https://github.com/kirillzyusko/react-native-keyboard-controller
+ */
+export function useKeyboardAvoidance() {
+    // Placeholder implementation
+    // In production, use react-native-keyboard-controller or custom hook
+    return {
+        isVisible: false,
+        height: 0,
+        progress: 0,
+    };
+}
+/**
+ * Add keyboard event listener
+ *
+ * @param event - Event type to listen for ('show' | 'hide' | 'change')
+ * @param listener - Callback function receiving keyboard height
+ * @returns Cleanup function to remove listener
+ *
+ * @example
+ * ```typescript
+ * const unsubscribe = addKeyboardListener('show', (height) => {
+ *   console.log('Keyboard shown with height:', height);
+ * });
+ *
+ * // Later: unsubscribe();
+ * ```
+ *
+ * @remarks
+ * - On web: Returns no-op cleanup function (no keyboard events)
+ * - On React Native: Uses Keyboard.addListener() API
+ * - Supported events: 'show', 'hide', 'change'
+ * - Always call the cleanup function to prevent memory leaks
+ */
+export function addKeyboardListener(event, listener) {
+    const platform = detectPlatform();
+    // Web platform: no keyboard events
+    if (platform === 'web') {
+        return () => {
+            // No-op cleanup
+        };
+    }
+    // React Native: try to add listener
+    if (isKeyboardAPIAvailable()) {
+        try {
+            const globalAny = global;
+            const Keyboard = globalAny.Keyboard;
+            // Map event type to React Native event names
+            const eventName = event === 'show'
+                ? 'keyboardDidShow'
+                : event === 'hide'
+                    ? 'keyboardDidHide'
+                    : 'keyboardDidChangeFrame';
+            // Create listener wrapper
+            const wrappedListener = (e) => {
+                const height = e.endCoordinates?.height ?? 0;
+                listener(height);
+            };
+            // Add listener
+            const subscription = Keyboard.addListener(eventName, wrappedListener);
+            // Return cleanup function
+            return () => {
+                subscription?.remove?.();
+            };
+        }
+        catch (error) {
+            console.warn('[Keyboard] Failed to add keyboard listener:', error);
+        }
+    }
+    // Fallback: return no-op cleanup
+    return () => {
+        // No-op cleanup
+    };
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Get platform-specific keyboard animation duration
+ *
+ * @returns Animation duration in milliseconds
+ *
+ * @example
+ * ```typescript
+ * const duration = getKeyboardAnimationDuration();
+ * // iOS: 250, Android: 300, Web: 0
+ * ```
+ *
+ * @remarks
+ * Default animation durations:
+ * - iOS: 250ms (from UIKit keyboard animation)
+ * - Android: 300ms (from WindowInsetsAnimationCompat)
+ * - Web: 0ms (no keyboard animation)
+ */
+export function getKeyboardAnimationDuration() {
+    const platform = detectPlatform();
+    switch (platform) {
+        case 'ios':
+            return 250;
+        case 'android':
+            return 300;
+        case 'web':
+        default:
+            return 0;
+    }
+}
+/**
+ * Calculate keyboard-aware bottom spacing
+ *
+ * @param baseSpacing - Base spacing value in points/dp
+ * @param includeKeyboard - Whether to include keyboard height (default: true)
+ * @returns Total spacing including keyboard height if applicable
+ *
+ * @example
+ * ```typescript
+ * // With keyboard visible (height: 336)
+ * const spacing = getKeyboardAwareBottomSpacing(16, true);
+ * console.log(spacing); // 352 (16 + 336)
+ *
+ * // Without keyboard consideration
+ * const spacing = getKeyboardAwareBottomSpacing(16, false);
+ * console.log(spacing); // 16
+ * ```
+ *
+ * @remarks
+ * Useful for calculating dynamic spacing that accounts for keyboard visibility.
+ * Common use cases:
+ * - Bottom padding for scrollable content
+ * - Bottom margin for floating action buttons
+ * - Bottom inset for safe area + keyboard
+ */
+export function getKeyboardAwareBottomSpacing(baseSpacing, includeKeyboard = true) {
+    if (!includeKeyboard) {
+        return baseSpacing;
+    }
+    const keyboardHeight = getKeyboardHeight();
+    return baseSpacing + keyboardHeight;
+}
+/**
+ * Get default keyboard animation configuration for current platform
+ *
+ * @returns KeyboardAnimationConfig with platform-specific defaults
+ *
+ * @example
+ * ```typescript
+ * const animConfig = getDefaultKeyboardAnimation();
+ * // iOS: { duration: 250, easing: 'keyboard', enabled: true }
+ * // Android: { duration: 300, easing: 'keyboard', enabled: true }
+ * // Web: { duration: 0, easing: 'linear', enabled: false }
+ * ```
+ */
+export function getDefaultKeyboardAnimation() {
+    const platform = detectPlatform();
+    switch (platform) {
+        case 'ios':
+            return {
+                duration: 250,
+                easing: 'keyboard',
+                enabled: true,
+            };
+        case 'android':
+            return {
+                duration: 300,
+                easing: 'keyboard',
+                enabled: true,
+            };
+        case 'web':
+        default:
+            return {
+                duration: 0,
+                easing: 'linear',
+                enabled: false,
+            };
+    }
+}
+/**
+ * Check if keyboard is currently visible
+ *
+ * @returns True if keyboard is visible, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (isKeyboardVisible()) {
+ *   console.log('Keyboard is visible');
+ * }
+ * ```
+ */
+export function isKeyboardVisible() {
+    return getKeyboardHeight() > 0;
+}
+/**
+ * Get keyboard behavior progress tracking mode
+ *
+ * @returns Progress tracking mode ('binary' for iOS, 'continuous' for Android, 'none' for web)
+ *
+ * @example
+ * ```typescript
+ * const mode = getKeyboardProgressMode();
+ * // iOS: 'binary' (0 or 1 only)
+ * // Android: 'continuous' (0, 0.07, 0.12, ..., 1.0)
+ * // Web: 'none'
+ * ```
+ *
+ * @remarks
+ * iOS keyboard animations have binary progress (0 or 1) due to willShow/willHide notifications.
+ * Android keyboard animations have continuous progress tracking via WindowInsetsAnimationCompat.
+ */
+export function getKeyboardProgressMode() {
+    const platform = detectPlatform();
+    switch (platform) {
+        case 'ios':
+            return 'binary';
+        case 'android':
+            return 'continuous';
+        case 'web':
+        default:
+            return 'none';
+    }
+}
+//# sourceMappingURL=keyboard.js.map

package/dist/layout-tokens/keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../../src/layout-tokens/keyboard.ts"],"names":[],"mappings":"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"}