native-fn 1.0.38 → 1.0.39

package/dist/src/plugin/app/types/app.d.ts

@@ -1,19 +1,8 @@
-import { OS } from '../../../constants/platform';
-import { AppOpenState, Messengers } from '../constants/app';
-export declare interface EventListenerUtil {
-    useStd: boolean;
-    add: (target: any, eventListenerOptions: EventListenerOptions) => void;
-    remove: (target: any, eventListenerOptions: EventListenerOptions) => void;
-    withVender: (target: any, type?: string) => string;
-}
-export declare interface EventListenerOptions {
-    type?: string;
-    callback: EventListenerOrEventListenerObject | null;
-    options?: AddEventListenerOptions | boolean;
-}
+import { OS } from "../../../constants/platform";
+import { AppOpenState, MessengerType } from "../constants/app";
 export declare interface AppInfo {
     scheme?: URLCandidate;
-    fallback?: URLCandidate | (() => any);
+    fallback?: URLCandidateOrFallback;
     timeout?: number;
     allowWebStore?: boolean;
 }
@@ -38,6 +27,8 @@ export declare interface AppOpenOptions {
     [OS.MacOS]?: MacOSAppInfo;
 }
 export declare type URLCandidate = URL | string;
+export declare type URLCandidateOrFallback = URLCandidate | (() => any);
+export declare type URLStringOrFallback = string | (() => any);
 export declare type Stringifiable = string | number | boolean | HTMLElement | null | undefined;
 export declare type StringifiableSequence = Stringifiable[] | NodeList | NodeListOf<Node> | HTMLCollectionBase;
 export declare type MessengerOpenOptions = {
@@ -47,8 +38,8 @@ export declare type MessengerOpenOptions = {
     subject?: Stringifiable;
     body?: Stringifiable;
 } | HTMLFormElement | FormData;
-export declare type Messenger = Record<Messengers, (options: MessengerOpenOptions) => Promise<void>>;
+export declare type Messenger = Record<MessengerType, (options: MessengerOpenOptions) => Promise<void>>;
 export declare interface AppInstance {
-    open: (options: AppOpenOptions) => Promise<AppOpenState>;
+    open(options: AppOpenOptions): Promise<AppOpenState>;
     messenger: Messenger;
 }

package/dist/src/plugin/app/types/index.d.ts

@@ -1,6 +1,6 @@
-export * from './app';
-import type { AppInstance } from './app';
-import { AppOpenState, Messengers } from "../constants/app";
+export * from "./app";
+import type { AppInstance } from "./app";
+import { AppOpenState, MessengerType } from "../constants/app";
 import { URLOpenError } from "../errors/url-open-error";
 declare module 'native-fn' {
     interface NativePlugins {
@@ -8,7 +8,7 @@ declare module 'native-fn' {
     }
     interface NativeConstants {
         AppOpenState: typeof AppOpenState;
-        Messengers: typeof Messengers;
+        Messengers: typeof MessengerType;
     }
     interface NativeErrors {
         URLOpenError: typeof URLOpenError;

package/dist/src/plugin/camera/constants/camera.d.ts

@@ -0,0 +1,4 @@
+export declare enum CameraType {
+    Image = "image",
+    Video = "video"
+}

package/dist/src/plugin/camera/cores/camera.d.ts

@@ -0,0 +1,3 @@
+import { CameraInstance } from "../types";
+declare const Camera: CameraInstance;
+export default Camera;

package/dist/src/plugin/camera/index.d.ts

@@ -0,0 +1,8 @@
+import type { NativePlugin } from "../../types";
+import type { CameraInstance } from "./types";
+import { CameraType } from "./constants/camera";
+export * from "./types";
+declare const NativeMediaPlugin: NativePlugin<'Camera', CameraInstance, {
+    CameraType: typeof CameraType;
+}, {}>;
+export default NativeMediaPlugin;

package/dist/src/plugin/camera/types/camera.d.ts

@@ -0,0 +1,4 @@
+import { CameraType } from "../constants/camera";
+export declare interface CameraInstance {
+    open(type: CameraType): void;
+}

package/dist/src/plugin/camera/types/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./camera";
+import type { CameraInstance } from "./camera";
+import { CameraType } from "../constants/camera";
+declare module 'native-fn' {
+    interface NativePlugins {
+        Camera: CameraInstance;
+    }
+    interface NativeConstants {
+        CameraType: CameraType;
+    }
+    interface NativeErrors {
+    }
+}

package/dist/src/plugin/camera/utils/try-open-camera.d.ts

@@ -0,0 +1,2 @@
+import { CameraType } from "../constants/camera";
+export default function tryOpenCamera(type: CameraType): void;

package/dist/src/plugin/clipboard/constants/clipboard.d.ts

@@ -0,0 +1,4 @@
+export declare enum ClipboardType {
+    Text = "text/plain",
+    HTML = "text/html"
+}

package/dist/src/plugin/clipboard/cores/clipboard.d.ts

@@ -0,0 +1,3 @@
+import { ClipboardInstance } from "../types";
+declare const Clipboard: ClipboardInstance;
+export default Clipboard;

package/dist/src/plugin/clipboard/errors/unsupported-color-error.d.ts

@@ -0,0 +1,2 @@
+declare const UnsupportedClipboardData: ErrorConstructor;
+export { UnsupportedClipboardData, };

package/dist/src/plugin/clipboard/index.d.ts

@@ -0,0 +1,5 @@
+import type { NativePlugin } from "../../types";
+import type { ClipboardInstance } from "./types";
+export * from "./types";
+declare const NativeClipboardPlugin: NativePlugin<'Clipboard', ClipboardInstance, {}, {}>;
+export default NativeClipboardPlugin;

package/dist/src/plugin/clipboard/types/clipboard.d.ts

@@ -0,0 +1,4 @@
+export declare interface ClipboardInstance {
+    copy(item: any): Promise<boolean>;
+    paste(): Promise<string>;
+}

package/dist/src/plugin/clipboard/types/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./clipboard";
+import type { ClipboardInstance } from "./clipboard";
+declare module 'native-fn' {
+    interface NativePlugins {
+        Clipboard: ClipboardInstance;
+    }
+    interface NativeConstants {
+    }
+    interface NativeErrors {
+    }
+}

package/dist/src/plugin/clipboard/utils/copy.d.ts

@@ -0,0 +1 @@
+export default function copy(item: unknown): Promise<boolean>;

package/dist/src/plugin/clipboard/utils/html-string-to-plain-string.d.ts

@@ -0,0 +1 @@
+export default function htmlStringToPlainString(string: string): string;

package/dist/src/plugin/fullscreen/cores/fullscreen.d.ts

@@ -0,0 +1,3 @@
+import { FullscreenInstance } from "../types";
+declare const Fullscreen: FullscreenInstance;
+export default Fullscreen;

package/dist/src/plugin/fullscreen/index.d.ts

@@ -0,0 +1,5 @@
+import type { NativePlugin } from "../../types";
+import type { FullscreenInstance } from "./types";
+export * from "./types";
+declare const NativeFullscreenPlugin: NativePlugin<'Fullscreen', FullscreenInstance, {}, {}>;
+export default NativeFullscreenPlugin;

package/dist/src/plugin/fullscreen/types/fullscreen.d.ts

@@ -0,0 +1,10 @@
+export declare interface FullscreenInstance {
+    enabled: boolean;
+    element: Element | null;
+    isFullscreen: boolean;
+    request(target: Element, options?: FullscreenOptions): Promise<void>;
+    exit(): Promise<void>;
+    toggle(target: Element, options?: FullscreenOptions): Promise<void>;
+    onChange(handler: (event: Event) => void): () => void;
+    onError(handler: (event: Event) => void): () => void;
+}

package/dist/src/plugin/fullscreen/types/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./fullscreen";
+import type { FullscreenInstance } from "./fullscreen";
+declare module 'native-fn' {
+    interface NativePlugins {
+        Fullscreen: FullscreenInstance;
+    }
+    interface NativeConstants {
+    }
+    interface NativeErrors {
+    }
+}

package/dist/src/plugin/media/constants/media.d.ts

@@ -0,0 +1,5 @@
+export declare enum MediaType {
+    Image = "image",
+    Video = "video",
+    Audio = "audio"
+}

package/dist/src/plugin/media/cores/media.d.ts

@@ -0,0 +1,3 @@
+import { MediaInstance } from "../types";
+declare const Media: MediaInstance;
+export default Media;

package/dist/src/plugin/media/index.d.ts

@@ -0,0 +1,5 @@
+import type { NativePlugin } from "../../types";
+import type { MediaInstance } from "./types";
+export * from "./types";
+declare const NativeMediaPlugin: NativePlugin<'Media', MediaInstance, {}, {}>;
+export default NativeMediaPlugin;

package/dist/src/plugin/media/types/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./media";
+import type { MediaInstance } from "./media";
+import { MediaType } from "../constants/media";
+declare module 'native-fn' {
+    interface NativePlugins {
+        App: MediaInstance;
+    }
+    interface NativeConstants {
+        MediaType: MediaType;
+    }
+    interface NativeErrors {
+    }
+}

package/dist/src/plugin/media/types/media.d.ts

@@ -0,0 +1,4 @@
+import { MediaType } from "../constants/media";
+export declare interface MediaInstance {
+    open(type: MediaType): void;
+}

package/dist/src/plugin/media/utils/try-open-camera.d.ts

@@ -0,0 +1,2 @@
+import { MediaType } from "../constants/media";
+export default function tryOpenCamera(type: MediaType): void;

package/dist/src/plugin/platform/cores/platform.d.ts

@@ -1,3 +1,3 @@
-import type { PlatformInstance } from '../types';
+import type { PlatformInstance } from "../types";
 declare const Platform: PlatformInstance;
 export default Platform;

package/dist/src/plugin/platform/index.d.ts

@@ -1,5 +1,11 @@
-import type { NativePlugin } from '../../types';
+import type { NativePlugin } from "../../types";
 import type { PlatformInstance } from "./types";
-export * from './types';
-declare const NativePlatformPlugin: NativePlugin<'Platform', PlatformInstance, {}, {}>;
+import { Browsers, Devices, Engines, OS } from "../../constants/platform";
+export * from "./types";
+declare const NativePlatformPlugin: NativePlugin<'Platform', PlatformInstance, {
+    OS: typeof OS;
+    Devices: typeof Devices;
+    Engines: typeof Engines;
+    Browsers: typeof Browsers;
+}, {}>;
 export default NativePlatformPlugin;

package/dist/src/plugin/platform/types/index.d.ts

@@ -1,5 +1,5 @@
-export * from './platform';
-import type { PlatformInstance } from './platform';
+export * from "./platform";
+import type { PlatformInstance } from "./platform";
 declare module 'native-fn' {
     interface NativePlugins {
         Platform: PlatformInstance;

package/dist/src/plugin/platform/types/platform.d.ts

@@ -1,10 +1,12 @@
-import { Devices, Engines, OS } from '../../../constants/platform';
+import { Devices, Engines, Browsers, OS } from "../../../constants/platform";
 export declare interface PlatformInstance {
     os: OS;
     device: Devices;
     engine: Engines;
+    browser: Browsers;
     osVersion: string;
     engineVersion: string;
+    browserVersion: string;
     renderer: string;
     isWebview: boolean;
     isStandalone: boolean;

package/dist/src/plugin/theme/constants/theme.d.ts

@@ -1,16 +1,14 @@
-import type { ListenerEntry } from '../types';
+import type { ListenerEntry } from "../types";
 export declare enum Appearances {
     Unknown = "unknown",
     Light = "light",
     Dark = "dark"
 }
-export declare const CHROME_VERSION: number;
 export declare const MEDIA_QUERY_LIST: MediaQueryList;
 export declare const SUPPORT_PREFERS_COLOR_SCHEME: boolean;
 export declare const IS_FULL_SUPPORT_THEME_COLOR: boolean;
 export declare const CONTEXT: CanvasRenderingContext2D | null;
 export declare const SVG_PIXEL_DATA_URL: string;
-export declare const IS_SAMSUNG: boolean;
 export declare const IS_IE_MOBILE: boolean;
 export declare const IS_WINDOWS_PHONE: boolean;
 export declare const ENTRIES: ListenerEntry[];

package/dist/src/plugin/theme/cores/theme.d.ts

@@ -1,3 +1,3 @@
-import type { ThemeInstance } from '../types';
+import type { ThemeInstance } from "../types";
 declare const Theme: ThemeInstance;
 export default Theme;

package/dist/src/plugin/theme/index.d.ts

@@ -1,9 +1,9 @@
-import type { NativePlugin } from '../../types';
+import type { NativePlugin } from "../../types";
 import type { ThemeInstance } from "./types";
-import { Appearances } from './constants/theme';
-import { EasingError, UnsupportedEasingFunctionError, StepSyntaxError, LinearSyntaxError, CubicBezierSyntaxError } from './errors/easing-error';
-import { UnsupportedColorError } from './errors/unsupported-color-error';
-export * from './types';
+import { Appearances } from "./constants/theme";
+import { EasingError, UnsupportedEasingFunctionError, StepSyntaxError, LinearSyntaxError, CubicBezierSyntaxError } from "./errors/easing-error";
+import { UnsupportedColorError } from "./errors/unsupported-color-error";
+export * from "./types";
 declare const NativeThemePlugin: NativePlugin<'Theme', ThemeInstance, {
     Appearances: typeof Appearances;
 }, {

package/dist/src/plugin/theme/types/index.d.ts

@@ -1,7 +1,7 @@
-export * from './color';
-export * from './easing-syntax';
-export * from './theme';
-import type { ThemeInstance } from './theme';
+export * from "./color";
+export * from "./easing-syntax";
+export * from "./theme";
+import type { ThemeInstance } from "./theme";
 import { Appearances } from "../constants/theme";
 import { UnsupportedColorError } from "../errors/unsupported-color-error";
 import { CubicBezierSyntaxError, EasingError, LinearSyntaxError, StepSyntaxError, UnsupportedEasingFunctionError } from "../errors/easing-error";

package/dist/src/plugin/theme/types/theme.d.ts

@@ -1,5 +1,5 @@
-import { Appearances } from '../constants/theme';
-import type { EasingKeyword, EasingSyntax, Color } from '../types';
+import { Appearances } from "../constants/theme";
+import type { EasingKeyword, EasingSyntax, Color } from "../types";
 export declare interface ListenerEntry {
     fn: (appearance: Appearances) => any;
     capture: boolean;
@@ -15,9 +15,9 @@ export declare interface SetThemeColorOptions {
     defaultColor?: string;
 }
 export declare interface ThemeInstance {
-    setThemeColor: (color: Color, options?: SetThemeColorOptions) => Promise<string | undefined>;
-    getThemeColor: () => Color | undefined;
-    removeThemeColor: (appearance?: ThemeColorMetaAppearanceKeys) => void;
-    detectAppearance: () => Promise<Appearances>;
-    onAppearanceChange: (listener: (appearance?: Appearances) => any, options?: boolean | AddEventListenerOptions) => () => void;
+    setThemeColor(color: Color, options?: SetThemeColorOptions): Promise<string | undefined>;
+    getThemeColor(): Color | undefined;
+    removeThemeColor(appearance?: ThemeColorMetaAppearanceKeys): void;
+    detectAppearance(): Promise<Appearances>;
+    onAppearanceChange(listener: (appearance?: Appearances) => any, options?: boolean | AddEventListenerOptions): () => void;
 }

package/dist/src/plugin/theme/utils/parse-color.d.ts

@@ -1,2 +1,2 @@
-import type { RGBA } from '../types';
+import type { RGBA } from "../types";
 export default function parseColor(color: string): RGBA;

package/dist/src/plugin/theme/utils/parse-easing-function.d.ts

@@ -1,2 +1,2 @@
-import type { EasingFunction, EasingKeyword, EasingSyntax } from '../types';
+import type { EasingFunction, EasingKeyword, EasingSyntax } from "../types";
 export default function parseEasingFunction(easingFunction: EasingSyntax | EasingKeyword): EasingFunction;

package/dist/src/types/clipboard-utils.d.ts

@@ -0,0 +1,4 @@
+export declare interface ClipboardUtils {
+    copy(item: string): Promise<boolean>;
+    paste(): Promise<string>;
+}

package/dist/src/types/event-listener-util.d.ts

@@ -0,0 +1,11 @@
+export declare interface EventListenerUtil {
+    useStd: boolean;
+    add<T extends EventTarget | undefined, E extends Event = Event>(target: T, eventListenerOptions: EventListenerOptions<NonNullable<T>, E>): void;
+    remove<T extends EventTarget | undefined, E extends Event = Event>(target: T, eventListenerOptions: EventListenerOptions<NonNullable<T>, E>): void;
+    withVender(target: any, type?: string): string;
+}
+export declare interface EventListenerOptions<T extends EventTarget = EventTarget, E extends Event = Event> {
+    type?: string | undefined;
+    callback: ((this: T, event: E) => void) | EventListenerObject | null;
+    options?: AddEventListenerOptions | boolean;
+}

package/dist/src/types/index.d.ts

@@ -1 +1 @@
-export * from './native';
+export * from "./native";

package/dist/src/types/native.d.ts

@@ -1,8 +1,10 @@
+import { PluginNotExtendedError } from "../errors/plugin-not-extended-error";
 export interface NativePlugins {
 }
 export interface NativeConstants extends Record<string, any> {
 }
 export interface NativeErrors extends Record<string, ErrorConstructor> {
+    PluginNotExtendedError: typeof PluginNotExtendedError;
 }
 export declare interface NativePlugin<Key extends string, Module, Constants extends Record<string, any> = Record<string, any>, Errors extends Record<string, ErrorConstructor> = Record<string, ErrorConstructor>> {
     installed: boolean;
@@ -11,6 +13,9 @@ export declare interface NativePlugin<Key extends string, Module, Constants exte
     Constants: Constants;
     Errors: Errors;
 }
+export type ExtendedNativeBase<Key extends string, Module, Constants extends Record<string, any> = Record<string, any>, Errors extends Record<string, ErrorConstructor> = Record<string, ErrorConstructor>> = NativeBase<NativePlugins & {
+    [Plugin in Key]: Module;
+}, NativeConstants & Constants, NativeErrors & Errors>;
 export type NativeBase<Plugins, AssignedConstants extends Record<string, any> = Record<string, any>, AssignedErrors extends Record<string, ErrorConstructor> = Record<string, ErrorConstructor>> = {
     Version: string;
     Constants: AssignedConstants;

package/dist/src/utils/clipboard-utils.d.ts

@@ -0,0 +1,4 @@
+import { ClipboardUtils } from "../types/clipboard-utils";
+export declare function paste(): Promise<string>;
+declare const ClipboardUtils: ClipboardUtils;
+export default ClipboardUtils;

package/dist/src/utils/compare-version.d.ts

@@ -0,0 +1 @@
+export default function compareVersion(lhs: string, rhs: string): -1 | 0 | 1;

package/dist/src/utils/create-hidden-element.d.ts

@@ -0,0 +1 @@
+export default function createHiddenElement<K extends keyof HTMLElementTagNameMap>(tagName: K, focusable?: boolean): HTMLElementTagNameMap[K];

package/dist/src/utils/dispatch-click-event.d.ts

@@ -0,0 +1 @@
+export default function dispatchClickEvent(element: HTMLElement, view?: WindowProxy): void;

package/dist/src/utils/event-listener-utils.d.ts

@@ -0,0 +1,3 @@
+import type { EventListenerUtil } from "../types/event-listener-util";
+declare const EventListenerUtils: EventListenerUtil;
+export default EventListenerUtils;

package/dist/src/utils/fullscreen-utils.d.ts

@@ -0,0 +1,44 @@
+declare global {
+    interface HTMLVideoElement {
+        webkitEnterFullscreen?: () => void;
+        webkitExitFullscreen?: () => void;
+        webkitSupportsFullscreen?: boolean;
+        webkitDisplayingFullscreen?: boolean;
+        __fsBridged__?: boolean;
+    }
+    interface Document {
+        readonly fullscreenEnabled: boolean;
+        fullscreenElement?: Element | null;
+        exitFullscreen: () => Promise<void>;
+        readonly webkitFullscreenEnabled?: boolean;
+        webkitFullscreenElement?: Element | null;
+        webkitCurrentFullScreenElement?: Element | null;
+        webkitExitFullscreen?: () => Promise<void>;
+        webkitCancelFullScreen?: () => Promise<void>;
+        readonly mozFullScreenEnabled?: boolean;
+        mozFullScreenElement?: Element | null;
+        mozCancelFullScreen?: () => Promise<void>;
+        readonly msFullscreenEnabled?: boolean;
+        msFullscreenElement?: Element | null;
+        msExitFullscreen?: () => Promise<void>;
+    }
+    interface Element {
+        requestFullscreen: (options?: FullscreenOptions) => Promise<void>;
+        webkitRequestFullscreen?: (options?: FullscreenOptions) => Promise<void>;
+        webkitRequestFullScreen?: (options?: FullscreenOptions) => Promise<void>;
+        mozRequestFullScreen?: () => Promise<void>;
+        msRequestFullscreen?: () => Promise<void>;
+    }
+}
+interface FullscreenUtils {
+    enabled: boolean;
+    element: Element | null;
+    isFullscreen: boolean;
+    request: (target: Element, options?: FullscreenOptions) => Promise<void>;
+    exit: () => Promise<void>;
+    toggle: (target: Element, options?: FullscreenOptions) => Promise<void>;
+    onChange: (handler: (event: Event) => void) => () => void;
+    onError: (handler: (event: Event) => void) => () => void;
+}
+export declare const FullscreenUtils: FullscreenUtils;
+export default FullscreenUtils;

package/dist/src/utils/get-tag-name.d.ts

@@ -0,0 +1 @@
+export default function getTagName(item: unknown): string;

package/dist/src/utils/get-topmost-window.d.ts

@@ -0,0 +1 @@
+export default function getTopmostWindow(): WindowProxy;

package/dist/src/utils/is-secure-context.d.ts

@@ -0,0 +1 @@
+export default function isSecureContext(): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "native-fn",
-  "version": "1.0.38",
+  "version": "1.0.39",
   "description": " ",
   "type": "module",
 
@@ -33,6 +33,24 @@
       "import": "./dist/plugin/platform/index.mjs",
       "require": "./dist/plugin/platform/index.cjs",
       "default": "./dist/plugin/platform/index.mjs"
+    },
+    "./plugin/camera": {
+      "types": "./dist/plugin/camera/index.d.ts",
+      "import": "./dist/plugin/camera/index.mjs",
+      "require": "./dist/plugin/camera/index.cjs",
+      "default": "./dist/plugin/camera/index.mjs"
+    },
+    "./plugin/clipboard": {
+      "types": "./dist/plugin/clipboard/index.d.ts",
+      "import": "./dist/plugin/clipboard/index.mjs",
+      "require": "./dist/plugin/clipboard/index.cjs",
+      "default": "./dist/plugin/clipboard/index.mjs"
+    },
+    "./plugin/fullscreen": {
+      "types": "./dist/plugin/fullscreen/index.d.ts",
+      "import": "./dist/plugin/fullscreen/index.mjs",
+      "require": "./dist/plugin/fullscreen/index.cjs",
+      "default": "./dist/plugin/fullscreen/index.mjs"
     }
   },
 
@@ -41,6 +59,9 @@
       "plugin/app": ["dist/plugin/app/index.d.ts"],
       "plugin/theme": ["dist/plugin/theme/index.d.ts"],
       "plugin/platform": ["dist/plugin/platform/index.d.ts"],
+      "plugin/camera": ["dist/plugin/camera/index.d.ts"],
+      "plugin/clipboard": ["dist/plugin/clipboard/index.d.ts"],
+      "plugin/fullscreen": ["dist/plugin/fullscreen/index.d.ts"],
       "dist/*": ["dist/*"]
     }
   },