@livx.cc/native-kit 0.45.23 → 0.45.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.45.23",
+  "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 } 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

@@ -17,6 +17,25 @@ export interface WebViewOpenOptions {
   bottom?: number;
 }
 
+export interface WebViewFabOptions {
+  show: boolean;
+  bottom?: number;
+  right?: number;
+  size?: number;
+  /** Corner radius (px); default = round. */
+  radius?: number;
+  color?: string;
+  symbol?: string;
+  text?: string;
+  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;
@@ -80,6 +99,26 @@ export class WebViewModule {
     return (await this.kit.invoke<{ result: T }>('webview.eval', { js, ...opts }, { timeoutMs: 35_000 })).result; // (native gives up at 30s)
   }
 
+  /** A round floating button over the app and the overlay (stays tappable while a page is shown) — e.g. an assistant
+   *  button. `bottom`/`right`: CSS px from the app WebView's bottom-right; `color` #rrggbb; `symbol`: an SF Symbol (iOS,
+   *  default 'sparkles'); `text`: its glyph on Android ('✦'); `label`: accessibility. `show:false` hides it. Taps →
+   *  {@link onFab}. Works with or without an open overlay. */
+  fab(opts: WebViewFabOptions): Promise<{ shown: boolean }> {
+    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());
+  }
+
   /** Tear the overlay down (fires {@link onClosed}). */
   close(): Promise<void> {
     return this.kit.invoke('webview.close', {});