@thelacanians/vue-native-runtime 0.2.0 → 0.4.0

package/dist/index.d.cts

@@ -602,6 +602,10 @@ declare const VButton: _vue_runtime_core.DefineComponent<_vue_runtime_core.Extra
  * The component maps `modelValue` to the native `text` prop and listens
  * for `changetext` events from the native side to update the model.
  *
+ * Handles CJK IME composition correctly: during composition, model updates
+ * are deferred until the user commits the composed character to avoid
+ * v-model desync.
+ *
  * @example
  * ```vue
  * <VInput
@@ -845,6 +849,11 @@ declare const VScrollView: _vue_runtime_core.DefineComponent<_vue_runtime_core.E
         default: boolean;
     };
     contentContainerStyle: PropType<ViewStyle>;
+    /** Minimum interval in ms between scroll event emissions. Default: 16 (~60fps) */
+    scrollEventThrottle: {
+        type: NumberConstructor;
+        default: number;
+    };
     /** Whether the pull-to-refresh indicator is active */
     refreshing: {
         type: BooleanConstructor;
@@ -883,6 +892,11 @@ declare const VScrollView: _vue_runtime_core.DefineComponent<_vue_runtime_core.E
         default: boolean;
     };
     contentContainerStyle: PropType<ViewStyle>;
+    /** Minimum interval in ms between scroll event emissions. Default: 16 (~60fps) */
+    scrollEventThrottle: {
+        type: NumberConstructor;
+        default: number;
+    };
     /** Whether the pull-to-refresh indicator is active */
     refreshing: {
         type: BooleanConstructor;
@@ -903,6 +917,7 @@ declare const VScrollView: _vue_runtime_core.DefineComponent<_vue_runtime_core.E
     scrollEnabled: boolean;
     bounces: boolean;
     pagingEnabled: boolean;
+    scrollEventThrottle: number;
     refreshing: boolean;
 }, {}, {}, {}, string, _vue_runtime_core.ComponentProvideOptions, true, {}, any>;
 
@@ -912,6 +927,9 @@ declare const VScrollView: _vue_runtime_core.DefineComponent<_vue_runtime_core.E
  * Maps to UIImageView on iOS. Loads images from URIs asynchronously
  * with built-in caching. Supports various resize modes.
  *
+ * Exposes a reactive `loading` ref (via template ref) that is `true`
+ * while the image is being fetched and `false` once it loads or errors.
+ *
  * @example
  * ```vue
  * <VImage
@@ -1306,6 +1324,9 @@ interface WebViewSource {
 /**
  * Embedded web view component backed by WKWebView.
  *
+ * URI sources are validated to block dangerous schemes such as `javascript:`
+ * and `data:text/html` which could lead to XSS.
+ *
  * @example
  * <VWebView :source="{ uri: 'https://example.com' }" style="flex: 1" @load="onLoad" />
  */
@@ -2179,6 +2200,8 @@ declare function useHaptics(): {
  * Async key-value storage composable backed by UserDefaults.
  *
  * All operations are Promise-based and run on a background thread.
+ * Write operations (setItem, removeItem) are serialized per key to
+ * prevent race conditions from concurrent access.
  *
  * @example
  * ```ts
@@ -3474,8 +3497,13 @@ declare class NativeBridgeImpl {
     private eventHandlers;
     /** Pending async callbacks from native module invocations */
     private pendingCallbacks;
-    /** Auto-incrementing callback ID for async native module calls */
+    /** Auto-incrementing callback ID for async native module calls.
+     *  Wraps around at MAX_SAFE_CALLBACK_ID to prevent overflow. */
     private nextCallbackId;
+    /** Maximum callback ID before wraparound (safe for 32-bit signed int) */
+    private static readonly MAX_CALLBACK_ID;
+    /** Maximum number of pending callbacks before evicting the oldest */
+    private static readonly MAX_PENDING_CALLBACKS;
     /** Global event listeners: eventName -> Set of callbacks */
     private globalEventHandlers;
     /**

package/dist/index.d.ts

@@ -602,6 +602,10 @@ declare const VButton: _vue_runtime_core.DefineComponent<_vue_runtime_core.Extra
  * The component maps `modelValue` to the native `text` prop and listens
  * for `changetext` events from the native side to update the model.
  *
+ * Handles CJK IME composition correctly: during composition, model updates
+ * are deferred until the user commits the composed character to avoid
+ * v-model desync.
+ *
  * @example
  * ```vue
  * <VInput
@@ -845,6 +849,11 @@ declare const VScrollView: _vue_runtime_core.DefineComponent<_vue_runtime_core.E
         default: boolean;
     };
     contentContainerStyle: PropType<ViewStyle>;
+    /** Minimum interval in ms between scroll event emissions. Default: 16 (~60fps) */
+    scrollEventThrottle: {
+        type: NumberConstructor;
+        default: number;
+    };
     /** Whether the pull-to-refresh indicator is active */
     refreshing: {
         type: BooleanConstructor;
@@ -883,6 +892,11 @@ declare const VScrollView: _vue_runtime_core.DefineComponent<_vue_runtime_core.E
         default: boolean;
     };
     contentContainerStyle: PropType<ViewStyle>;
+    /** Minimum interval in ms between scroll event emissions. Default: 16 (~60fps) */
+    scrollEventThrottle: {
+        type: NumberConstructor;
+        default: number;
+    };
     /** Whether the pull-to-refresh indicator is active */
     refreshing: {
         type: BooleanConstructor;
@@ -903,6 +917,7 @@ declare const VScrollView: _vue_runtime_core.DefineComponent<_vue_runtime_core.E
     scrollEnabled: boolean;
     bounces: boolean;
     pagingEnabled: boolean;
+    scrollEventThrottle: number;
     refreshing: boolean;
 }, {}, {}, {}, string, _vue_runtime_core.ComponentProvideOptions, true, {}, any>;
 
@@ -912,6 +927,9 @@ declare const VScrollView: _vue_runtime_core.DefineComponent<_vue_runtime_core.E
  * Maps to UIImageView on iOS. Loads images from URIs asynchronously
  * with built-in caching. Supports various resize modes.
  *
+ * Exposes a reactive `loading` ref (via template ref) that is `true`
+ * while the image is being fetched and `false` once it loads or errors.
+ *
  * @example
  * ```vue
  * <VImage
@@ -1306,6 +1324,9 @@ interface WebViewSource {
 /**
  * Embedded web view component backed by WKWebView.
  *
+ * URI sources are validated to block dangerous schemes such as `javascript:`
+ * and `data:text/html` which could lead to XSS.
+ *
  * @example
  * <VWebView :source="{ uri: 'https://example.com' }" style="flex: 1" @load="onLoad" />
  */
@@ -2179,6 +2200,8 @@ declare function useHaptics(): {
  * Async key-value storage composable backed by UserDefaults.
  *
  * All operations are Promise-based and run on a background thread.
+ * Write operations (setItem, removeItem) are serialized per key to
+ * prevent race conditions from concurrent access.
  *
  * @example
  * ```ts
@@ -3474,8 +3497,13 @@ declare class NativeBridgeImpl {
     private eventHandlers;
     /** Pending async callbacks from native module invocations */
     private pendingCallbacks;
-    /** Auto-incrementing callback ID for async native module calls */
+    /** Auto-incrementing callback ID for async native module calls.
+     *  Wraps around at MAX_SAFE_CALLBACK_ID to prevent overflow. */
     private nextCallbackId;
+    /** Maximum callback ID before wraparound (safe for 32-bit signed int) */
+    private static readonly MAX_CALLBACK_ID;
+    /** Maximum number of pending callbacks before evicting the oldest */
+    private static readonly MAX_PENDING_CALLBACKS;
     /** Global event listeners: eventName -> Set of callbacks */
     private globalEventHandlers;
     /**