@livx.cc/native-kit 0.45.24 → 0.45.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.45.24",
+  "version": "0.45.25",
   "description": "Isomorphic native-capabilities kit for PWAs — same API in browser and in an appwrap native shell. Zero dependencies.",
   "license": "MIT",
   "author": "Elya Livshitz",

package/src/index.ts

@@ -43,7 +43,7 @@ export { isScanResult } from './modules/scanner';
 export type { SpeechVoice, SpeakOptions, ListenOptions, SpeechPartial } from './modules/speech';
 export type { CalendarEventOptions } from './modules/calendar';
 export type { BrowserOptions } from './modules/browser';
-export type { WebViewState, WebViewOpenOptions, WebViewNavOp, WebViewFabOptions } from './modules/webview';
+export type { WebViewState, WebViewOpenOptions, WebViewNavOp, WebViewFabOptions, WebViewFloatOptions } from './modules/webview';
 export type { OAuthAuthorizeParams, OAuthResult } from './modules/oauth';
 export type { TrackingStatus } from './modules/tracking';
 export type {

package/src/modules/webview.ts

@@ -30,6 +30,12 @@ export interface WebViewFabOptions {
   label?: string;
 }
 
+export interface WebViewFloatOptions {
+  on: boolean;
+  /** The app's touchable boxes over the page (CSS px from the app WebView's top-left). */
+  hit?: { x: number; y: number; w: number; h: number }[];
+}
+
 /** A cookie as data; `expires` = unix seconds, absent/null = session cookie. A leading-dot `domain` = domain cookie. */
 export interface WebViewCookie {
   name: string;
@@ -101,6 +107,14 @@ export class WebViewModule {
     return this.kit.invoke('webview.fab', { ...opts });
   }
 
+  /** Float the app's WebView OVER the overlay: it draws on top (transparent wherever the app's own page is — give the
+   *  area over the overlay no background), so e.g. chat bubbles float over a shown page without resizing it. Touches
+   *  inside `hit` (app CSS px, viewport coords) go to the app; everywhere else to the page. Call again to move the rects;
+   *  `on:false` restores. iOS; elsewhere resolves `{floating:false}` — keep a fallback (e.g. inset the page). */
+  float(opts: WebViewFloatOptions): Promise<{ floating: boolean }> {
+    return this.kit.invoke('webview.float', { ...opts });
+  }
+
   onFab(cb: () => void): Unsubscribe {
     return this.kit.on('webview.fab', () => cb());
   }