@tma.js/sdk-react 1.0.3 → 1.1.0

package/dist/dts/DisplayGate.d.ts

@@ -0,0 +1,24 @@
+import { type ComponentType, type PropsWithChildren, type ReactNode } from 'react';
+export interface DisplayGateProps extends PropsWithChildren {
+    /**
+     * Element or component, which will be displayed in case, SDK is not loading, didn't receive
+     * any error during initialization as well as the initialization result.
+     */
+    initial?: ReactNode | ComponentType;
+    /**
+     * Element or component which will be displayed in case, SDK initialization failed.
+     */
+    error?: ReactNode | ComponentType<{
+        error: unknown;
+    }>;
+    /**
+     * Element or component which will be displayed in case, SDK is currently loading.
+     */
+    loading?: ReactNode | ComponentType;
+}
+/**
+ * This component is the layer controlling the application display. It displays application in
+ * case, the SDK is initialized, displays an error if something went wrong, and a loader
+ * if the SDK is warming up.
+ */
+export declare function DisplayGate(props: DisplayGateProps): ReactNode;

package/dist/dts/index.d.ts

@@ -1,3 +1,4 @@
-export { useThemeParams, useInitData, useBackButton, useClosingBehavior, useInitDataRaw, useCloudStorage, useLaunchParams, useMainButton, useHapticFeedback, useInvoice, useMiniApp, usePopup, usePostEvent, useQRScanner, useUtils, useViewport, withBackButton, withClosingBehavior, withCloudStorage, withInitData, withHapticFeedback, withInitDataRaw, withInvoice, withLaunchParams, withMainButton, withMiniApp, withPostEvent, withPopup, withThemeParams, withQRScanner, withUtils, withViewport, } from './tools/index.js';
+export { useThemeParams, useInitData, useBackButton, useClosingBehavior, useInitDataRaw, useCloudStorage, useLaunchParams, useMainButton, useHapticFeedback, useInvoice, useMiniApp, usePopup, usePostEvent, useQRScanner, useSettingsButton, useUtils, useViewport, withBackButton, withClosingBehavior, withCloudStorage, withInitData, withHapticFeedback, withInitDataRaw, withInvoice, withLaunchParams, withMainButton, withMiniApp, withPostEvent, withPopup, withThemeParams, withQRScanner, withSettingsButton, withUtils, withViewport, } from './tools/index.js';
 export { useSDKContext, withSDKContext, SDKProvider, type SDKProviderProps, type SDKContextType, } from './provider/index.js';
+export { DisplayGate, type DisplayGateProps, } from './DisplayGate.js';
 export type { InitOptions, InitResult, } from './types.js';

package/dist/dts/tools/index.d.ts

@@ -10,6 +10,7 @@ export * from './main-button.js';
 export * from './mini-app.js';
 export * from './popup.js';
 export * from './post-event.js';
+export * from './settings-button.js';
 export * from './qr-scanner.js';
 export * from './theme-params.js';
 export * from './utils.js';

package/dist/dts/tools/settings-button.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hook to retrieve SettingsButton component.
+ */
+export declare const useSettingsButton: import("../createHook.js").Hook<"settingsButton">;
+/**
+ * HOC to wrap specified component to pass SettingsButton instance.
+ */
+export declare const withSettingsButton: import("../createHoc.js").Hoc<"settingsButton">;

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("react"),p=require("@tma.js/sdk");function o(t,e){return s=>{function a(r){const c={...r,[t]:e()};return n.createElement(s,{...c})}return Object.defineProperty(a,"name",{value:`With${t[0].toUpperCase()}${t.slice(1)}`}),a}}const u=n.createContext({loading:!1});u.displayName="SDKContext";function O({options:t,children:e}){const[s,a]=n.useState(!1),[r,c]=n.useState(),[h,A]=n.useState();n.useEffect(()=>{a(!0),p.init({...t,async:!0}).then(A).catch(c).finally(()=>a(!1))},[]);const K=n.useMemo(()=>{const l={loading:s};return r&&(l.error=r),h&&(l.initResult=h),l},[s,h,r]);return n.createElement(u.Provider,{value:K},e)}function F({options:t={},children:e}){const s=n.useMemo(()=>{const a={loading:!1};try{a.initResult=p.init({...t,async:!1})}catch(r){a.error=r}return a},[]);return n.createElement(u.Provider,{value:s},e)}function H(t){var e;return(e=t.options)!=null&&e.async?n.createElement(O,{...t}):n.createElement(F,{...t})}function w(){return n.useContext(u)}function f(t){const{initResult:e}=w();if(!e)throw new Error(`Unable to get init result key "${t}" as long as SDK is not initialized`);return e[t]}function m(t){return Object.create(Object.getPrototypeOf(t),Object.getOwnPropertyDescriptors(t))}function L(t){const e=f(t),[s,a]=n.useState(m(e));return n.useEffect(()=>e.on("change",()=>{a(m(e))}),[e]),s}function U(t){return function(s){const a={...s,sdk:w()};return n.createElement(t,{...a})}}function i(t,e){return e?()=>L(t):()=>f(t)}const v=i("backButton",!0),V=o("backButton",v),P=i("closingBehavior",!0),j=o("closingBehavior",P),d=i("cloudStorage"),T=o("cloudStorage",d),S=i("hapticFeedback"),q=o("hapticFeedback",S),D=i("initData"),Q=o("initData",D),g=i("initDataRaw"),W=o("initDataRaw",g),B=i("invoice",!0),$=o("invoice",B);function C(){return n.useMemo(()=>p.retrieveLaunchData().launchParams,[])}function z(t){return function(s){return n.createElement(t,{...s,launchParams:C()})}}const E=i("mainButton",!0),N=o("mainButton",E),I=i("miniApp",!0),G=o("miniApp",I),b=i("popup",!0),J=o("popup",b),k=i("postEvent"),X=o("postEvent",k),R=i("qrScanner",!0),Y=o("qrScanner",R),y=i("themeParams",!0),Z=o("themeParams",y),M=i("utils"),_=o("utils",M),x=i("viewport",!0),tt=o("viewport",x);exports.SDKProvider=H;exports.useBackButton=v;exports.useClosingBehavior=P;exports.useCloudStorage=d;exports.useHapticFeedback=S;exports.useInitData=D;exports.useInitDataRaw=g;exports.useInvoice=B;exports.useLaunchParams=C;exports.useMainButton=E;exports.useMiniApp=I;exports.usePopup=b;exports.usePostEvent=k;exports.useQRScanner=R;exports.useSDKContext=w;exports.useThemeParams=y;exports.useUtils=M;exports.useViewport=x;exports.withBackButton=V;exports.withClosingBehavior=j;exports.withCloudStorage=T;exports.withHapticFeedback=q;exports.withInitData=Q;exports.withInitDataRaw=W;exports.withInvoice=$;exports.withLaunchParams=z;exports.withMainButton=N;exports.withMiniApp=G;exports.withPopup=J;exports.withPostEvent=X;exports.withQRScanner=Y;exports.withSDKContext=U;exports.withThemeParams=Z;exports.withUtils=_;exports.withViewport=tt;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("react"),p=require("@tma.js/sdk");function o(t,e){return a=>{function i(r){const h={...r,[t]:e()};return n.createElement(a,{...h})}return Object.defineProperty(i,"name",{value:`With${t[0].toUpperCase()}${t.slice(1)}`}),i}}const u=n.createContext({loading:!1});u.displayName="SDKContext";function H({options:t,children:e}){const[a,i]=n.useState(!1),[r,h]=n.useState(),[l,O]=n.useState();n.useEffect(()=>{i(!0),p.init({...t,async:!0}).then(O).catch(h).finally(()=>i(!1))},[]);const F=n.useMemo(()=>{const w={loading:a};return r&&(w.error=r),l&&(w.initResult=l),w},[a,l,r]);return n.createElement(u.Provider,{value:F},e)}function L({options:t={},children:e}){const a=n.useMemo(()=>{const i={loading:!1};try{i.initResult=p.init({...t,async:!1})}catch(r){i.error=r}return i},[]);return n.createElement(u.Provider,{value:a},e)}function U(t){var e;return(e=t.options)!=null&&e.async?n.createElement(H,{...t}):n.createElement(L,{...t})}function c(){return n.useContext(u)}function d(t){const{initResult:e}=c();if(!e)throw new Error(`Unable to get init result key "${t}" as long as SDK is not initialized`);return e[t]}function f(t){return Object.create(Object.getPrototypeOf(t),Object.getOwnPropertyDescriptors(t))}function V(t){const e=d(t),[a,i]=n.useState(f(e));return n.useEffect(()=>e.on("change",()=>{i(f(e))}),[e]),a}function j(t){return function(a){const i={...a,sdk:c()};return n.createElement(t,{...i})}}function s(t,e){return e?()=>V(t):()=>d(t)}const S=s("backButton",!0),T=o("backButton",S),g=s("closingBehavior",!0),q=o("closingBehavior",g),v=s("cloudStorage"),Q=o("cloudStorage",v),P=s("hapticFeedback"),W=o("hapticFeedback",P),B=s("initData"),$=o("initData",B),D=s("initDataRaw"),G=o("initDataRaw",D),C=s("invoice",!0),z=o("invoice",C);function E(){return n.useMemo(()=>p.retrieveLaunchData().launchParams,[])}function N(t){return function(a){return n.createElement(t,{...a,launchParams:E()})}}const y=s("mainButton",!0),J=o("mainButton",y),I=s("miniApp",!0),X=o("miniApp",I),R=s("popup",!0),Y=o("popup",R),b=s("postEvent"),Z=o("postEvent",b),k=s("settingsButton",!0),_=o("settingsButton",k),M=s("qrScanner",!0),tt=o("qrScanner",M),x=s("themeParams",!0),et=o("themeParams",x),A=s("utils"),nt=o("utils",A),K=s("viewport",!0),it=o("viewport",K);function m(t,e={}){return typeof t=="function"?n.createElement(t,{...e}):t}function ot(t){const{loading:e,initResult:a,error:i}=c();return a?t.children:i?m(t.error,{error:i}):m(e?t.loading:t.initial)}exports.DisplayGate=ot;exports.SDKProvider=U;exports.useBackButton=S;exports.useClosingBehavior=g;exports.useCloudStorage=v;exports.useHapticFeedback=P;exports.useInitData=B;exports.useInitDataRaw=D;exports.useInvoice=C;exports.useLaunchParams=E;exports.useMainButton=y;exports.useMiniApp=I;exports.usePopup=R;exports.usePostEvent=b;exports.useQRScanner=M;exports.useSDKContext=c;exports.useSettingsButton=k;exports.useThemeParams=x;exports.useUtils=A;exports.useViewport=K;exports.withBackButton=T;exports.withClosingBehavior=q;exports.withCloudStorage=Q;exports.withHapticFeedback=W;exports.withInitData=$;exports.withInitDataRaw=G;exports.withInvoice=z;exports.withLaunchParams=N;exports.withMainButton=J;exports.withMiniApp=X;exports.withPopup=Y;exports.withPostEvent=Z;exports.withQRScanner=tt;exports.withSDKContext=j;exports.withSettingsButton=_;exports.withThemeParams=et;exports.withUtils=nt;exports.withViewport=it;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/createHoc.tsx","../src/provider/SDKContext.ts","../src/provider/SDKProvider.tsx","../src/provider/useSDKContext.ts","../src/provider/useInitResultValue.ts","../src/provider/useInitResultDynamicValue.ts","../src/provider/withSDKContext.tsx","../src/createHook.ts","../src/tools/back-button.ts","../src/tools/closing-behavior.ts","../src/tools/cloud-storage.ts","../src/tools/haptic-feedback.ts","../src/tools/init-data.ts","../src/tools/init-data-raw.ts","../src/tools/invoice.ts","../src/tools/launch-params.tsx","../src/tools/main-button.ts","../src/tools/mini-app.ts","../src/tools/popup.ts","../src/tools/post-event.ts","../src/tools/qr-scanner.ts","../src/tools/theme-params.ts","../src/tools/utils.ts","../src/tools/viewport.ts"],"sourcesContent":["import React, { type ComponentType } from 'react';\n\nimport type { Hook } from './createHook.js';\nimport type { InitResultKey, InitResultValue } from './types.js';\n\nexport type Hoc<K extends InitResultKey> = <P extends { [Key in K]?: InitResultValue<K> }>(\n  Component: ComponentType<P>,\n) => ComponentType<P>;\n\n/**\n * Creates HOC for static init result value.\n * @param initResultKey - init result key.\n * @param hook - hook which returns init result value.\n */\nexport function createHoc<K extends InitResultKey>(initResultKey: K, hook: Hook<K>): Hoc<K> {\n  return (Component: ComponentType<any>) => {\n    function Wrapper(props: Record<string, unknown>) {\n      const wrappedProps = {\n        ...props,\n        [initResultKey]: hook(),\n      };\n\n      return <Component {...wrappedProps} />;\n    }\n\n    Object.defineProperty(Wrapper, 'name', {\n      value: `With${initResultKey[0].toUpperCase()}${initResultKey.slice(1)}`,\n    });\n\n    return Wrapper;\n  };\n}\n","import { createContext } from 'react';\n\nimport type { SDKContextType } from './types.js';\n\nexport const SDKContext = createContext<SDKContextType>({\n  loading: false,\n});\n\nSDKContext.displayName = 'SDKContext';\n","import { init } from '@tma.js/sdk';\nimport React, { useEffect, useMemo, useState } from 'react';\n\nimport { SDKContext } from './SDKContext.js';\nimport type { SDKContextType, SDKProviderProps } from './types.js';\nimport type { InitResult } from '../types.js';\n\nfunction AsyncProvider({ options, children }: SDKProviderProps) {\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<unknown | undefined>();\n  const [initResult, setInitResult] = useState<InitResult | undefined>();\n\n  useEffect(() => {\n    setLoading(true);\n\n    init({ ...options, async: true })\n      .then(setInitResult)\n      .catch(setError)\n      .finally(() => setLoading(false));\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  const context = useMemo<SDKContextType>(() => {\n    const result: SDKContextType = { loading };\n    if (error) {\n      result.error = error;\n    }\n\n    if (initResult) {\n      result.initResult = initResult;\n    }\n\n    return result;\n  }, [loading, initResult, error]);\n\n  return <SDKContext.Provider value={context}>{children}</SDKContext.Provider>;\n}\n\nfunction SyncProvider({ options = {}, children }: SDKProviderProps) {\n  const context = useMemo<SDKContextType>(() => {\n    const result: SDKContextType = { loading: false };\n\n    try {\n      result.initResult = init({ ...options, async: false });\n    } catch (e) {\n      result.error = e;\n    }\n\n    return result;\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return <SDKContext.Provider value={context}>{children}</SDKContext.Provider>;\n}\n\n/**\n * Component which provides access to SDK initialization state.\n */\nexport function SDKProvider(props: SDKProviderProps) {\n  // eslint-disable-next-line react/destructuring-assignment\n  return props.options?.async\n    ? <AsyncProvider {...props} />\n    : <SyncProvider {...props} />;\n}\n","import { useContext } from 'react';\n\nimport { SDKContext } from './SDKContext.js';\nimport type { SDKContextType } from './types.js';\n\n/**\n * Returns current SDK information.\n */\nexport function useSDKContext(): SDKContextType {\n  return useContext(SDKContext);\n}\n","import { useSDKContext } from './useSDKContext.js';\nimport type { InitResultKey, InitResultValue } from '../types.js';\n\n/**\n * Returns value by its field name from SDK init result.\n * @param key - init result key.\n * @throws {Error} SDK is not initialized.\n */\nexport function useInitResultValue<K extends InitResultKey>(key: K): InitResultValue<K> {\n  const { initResult } = useSDKContext();\n\n  if (!initResult) {\n    throw new Error(`Unable to get init result key \"${key}\" as long as SDK is not initialized`);\n  }\n  return initResult[key];\n}\n","import { useEffect, useState } from 'react';\n\nimport { useInitResultValue } from './useInitResultValue.js';\nimport type {\n  DynamicInitResultKey,\n  InitResultValue,\n  Trackable,\n} from '../types.js';\n\nfunction shallowCopy<T>(value: T): T {\n  return Object.create(\n    Object.getPrototypeOf(value),\n    Object.getOwnPropertyDescriptors(value),\n  );\n}\n\nexport function useInitResultDynamicValue<K extends DynamicInitResultKey>(\n  initResultKey: K,\n): InitResultValue<K> {\n  // Extract init result value.\n  const initial = useInitResultValue(initResultKey);\n\n  // Create value which will be returned to the external environment.\n  const [copy, setCopy] = useState(shallowCopy(initial));\n\n  // Effect which listens to change event and calls update.\n  useEffect(() => {\n    return (initial as Trackable).on('change', () => {\n      setCopy(shallowCopy(initial));\n    });\n  }, [initial]);\n\n  return copy;\n}\n","import React, { type ComponentType } from 'react';\n\nimport type { SDKContextType } from './types.js';\nimport { useSDKContext } from './useSDKContext.js';\n\n/**\n * HOC which passes SDK context to wrapped React component.\n * @param Component - component to wrap.\n */\nexport function withSDKContext<P extends { sdk?: SDKContextType }>(\n  Component: ComponentType<P>,\n): ComponentType<Omit<P, 'sdk'>> {\n  return function WithSDKContext(props: Omit<P, 'sdk'>) {\n    const p = {\n      ...props,\n      sdk: useSDKContext(),\n    } as P;\n\n    return <Component {...p} />;\n  };\n}\n","import { useInitResultDynamicValue, useInitResultValue } from './provider/index.js';\nimport type {\n  DynamicInitResultKey,\n  InitResultKey,\n  InitResultValue,\n  StaticInitResultKey,\n} from './types.js';\n\nexport type Hook<K extends InitResultKey> = () => InitResultValue<K>;\n\n/**\n * Creates hook to retrieve static init result value.\n * @param initResultKey - init result key.\n */\nexport function createHook<K extends StaticInitResultKey>(initResultKey: K): Hook<K>;\n\n/**\n * Creates hook to retrieve dynamic init result value.\n * @param initResultKey - init result key.\n * @param dynamic - flag to let function know this init result value is dynamic.\n */\nexport function createHook<K extends DynamicInitResultKey>(\n  initResultKey: K,\n  dynamic: true,\n): Hook<K>;\n\nexport function createHook(initResultKey: InitResultKey, dynamic?: true): Hook<any> {\n  return dynamic\n    ? () => useInitResultDynamicValue(initResultKey as DynamicInitResultKey)\n    : () => useInitResultValue(initResultKey);\n}\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve BackButton component.\n */\nexport const useBackButton = createHook('backButton', true);\n\n/**\n * HOC to wrap specified component to pass BackButton instance.\n */\nexport const withBackButton = createHoc('backButton', useBackButton);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve ClosingBehavior component.\n */\nexport const useClosingBehavior = createHook('closingBehavior', true);\n\n/**\n * HOC to wrap specified component to pass ClosingBehavior instance.\n */\nexport const withClosingBehavior = createHoc('closingBehavior', useClosingBehavior);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve CloudStorage component.\n */\nexport const useCloudStorage = createHook('cloudStorage');\n\n/**\n * HOC to wrap specified component to pass CloudStorage instance.\n */\nexport const withCloudStorage = createHoc('cloudStorage', useCloudStorage);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve HapticFeedback component.\n */\nexport const useHapticFeedback = createHook('hapticFeedback');\n\n/**\n * HOC to wrap specified component to pass HapticFeedback instance.\n */\nexport const withHapticFeedback = createHoc('hapticFeedback', useHapticFeedback);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve InitData component.\n */\nexport const useInitData = createHook('initData');\n\n/**\n * HOC to wrap specified component to pass InitData instance.\n */\nexport const withInitData = createHoc('initData', useInitData);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve init data raw representation.\n */\nexport const useInitDataRaw = createHook('initDataRaw');\n\n/**\n * HOC to wrap specified component to pass init data raw representation.\n */\nexport const withInitDataRaw = createHoc('initDataRaw', useInitDataRaw);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Invoice component.\n */\nexport const useInvoice = createHook('invoice', true);\n\n/**\n * HOC to wrap specified component to pass Invoice instance.\n */\nexport const withInvoice = createHoc('invoice', useInvoice);\n","import { type LaunchParams, retrieveLaunchData } from '@tma.js/sdk';\nimport React, { type ComponentType, useMemo } from 'react';\n\n/**\n * Hooks to retrieve launch parameters.\n */\nexport function useLaunchParams(): LaunchParams {\n  return useMemo(() => retrieveLaunchData().launchParams, []);\n}\n\n/**\n * HOC to wrap specified component to pass launch parameters.\n * @param Component - wrapped component.\n */\nexport function withLaunchParams<P extends { launchParams?: LaunchParams }>(\n  Component: ComponentType<P>,\n) {\n  return function WithInvoice(props: P) {\n    return <Component {...props} launchParams={useLaunchParams()} />;\n  };\n}\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve MainButton component.\n */\nexport const useMainButton = createHook('mainButton', true);\n\n/**\n * HOC to wrap specified component to pass MainButton instance.\n */\nexport const withMainButton = createHoc('mainButton', useMainButton);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve MiniApp component.\n */\nexport const useMiniApp = createHook('miniApp', true);\n\n/**\n * HOC to wrap specified component to pass MiniApp instance.\n */\nexport const withMiniApp = createHoc('miniApp', useMiniApp);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Popup component.\n */\nexport const usePopup = createHook('popup', true);\n\n/**\n * HOC to wrap specified component to pass Popup instance.\n */\nexport const withPopup = createHoc('popup', usePopup);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve postEvent function.\n */\nexport const usePostEvent = createHook('postEvent');\n\n/**\n * HOC to wrap specified component to pass postEvent function.\n */\nexport const withPostEvent = createHoc('postEvent', usePostEvent);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve QRScanner component.\n */\nexport const useQRScanner = createHook('qrScanner', true);\n\n/**\n * HOC to wrap specified component to pass QRScanner instance.\n */\nexport const withQRScanner = createHoc('qrScanner', useQRScanner);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve ThemeParams component.\n */\nexport const useThemeParams = createHook('themeParams', true);\n\n/**\n * HOC to wrap specified component to pass ThemeParams instance.\n */\nexport const withThemeParams = createHoc('themeParams', useThemeParams);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Utils component.\n */\nexport const useUtils = createHook('utils');\n\n/**\n * HOC to wrap specified component to pass Utils instance.\n */\nexport const withUtils = createHoc('utils', useUtils);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Viewport component.\n */\nexport const useViewport = createHook('viewport', true);\n\n/**\n * HOC to wrap specified component to pass Viewport instance.\n */\nexport const withViewport = createHoc('viewport', useViewport);\n"],"names":["createHoc","initResultKey","hook","Component","Wrapper","props","wrappedProps","React","SDKContext","createContext","AsyncProvider","options","children","loading","setLoading","useState","error","setError","initResult","setInitResult","useEffect","init","context","useMemo","result","SyncProvider","e","SDKProvider","_a","useSDKContext","useContext","useInitResultValue","key","shallowCopy","value","useInitResultDynamicValue","initial","copy","setCopy","withSDKContext","p","createHook","dynamic","useBackButton","withBackButton","useClosingBehavior","withClosingBehavior","useCloudStorage","withCloudStorage","useHapticFeedback","withHapticFeedback","useInitData","withInitData","useInitDataRaw","withInitDataRaw","useInvoice","withInvoice","useLaunchParams","retrieveLaunchData","withLaunchParams","useMainButton","withMainButton","useMiniApp","withMiniApp","usePopup","withPopup","usePostEvent","withPostEvent","useQRScanner","withQRScanner","useThemeParams","withThemeParams","useUtils","withUtils","useViewport","withViewport"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/createHoc.tsx","../src/provider/SDKContext.ts","../src/provider/SDKProvider.tsx","../src/provider/useSDKContext.ts","../src/provider/useInitResultValue.ts","../src/provider/useInitResultDynamicValue.ts","../src/provider/withSDKContext.tsx","../src/createHook.ts","../src/tools/back-button.ts","../src/tools/closing-behavior.ts","../src/tools/cloud-storage.ts","../src/tools/haptic-feedback.ts","../src/tools/init-data.ts","../src/tools/init-data-raw.ts","../src/tools/invoice.ts","../src/tools/launch-params.tsx","../src/tools/main-button.ts","../src/tools/mini-app.ts","../src/tools/popup.ts","../src/tools/post-event.ts","../src/tools/settings-button.ts","../src/tools/qr-scanner.ts","../src/tools/theme-params.ts","../src/tools/utils.ts","../src/tools/viewport.ts","../src/DisplayGate.tsx"],"sourcesContent":["import React, { type ComponentType } from 'react';\n\nimport type { Hook } from './createHook.js';\nimport type { InitResultKey, InitResultValue } from './types.js';\n\nexport type Hoc<K extends InitResultKey> = <P extends { [Key in K]?: InitResultValue<K> }>(\n  Component: ComponentType<P>,\n) => ComponentType<P>;\n\n/**\n * Creates HOC for static init result value.\n * @param initResultKey - init result key.\n * @param hook - hook which returns init result value.\n */\nexport function createHoc<K extends InitResultKey>(initResultKey: K, hook: Hook<K>): Hoc<K> {\n  return (Component: ComponentType<any>) => {\n    function Wrapper(props: Record<string, unknown>) {\n      const wrappedProps = {\n        ...props,\n        [initResultKey]: hook(),\n      };\n\n      return <Component {...wrappedProps} />;\n    }\n\n    Object.defineProperty(Wrapper, 'name', {\n      value: `With${initResultKey[0].toUpperCase()}${initResultKey.slice(1)}`,\n    });\n\n    return Wrapper;\n  };\n}\n","import { createContext } from 'react';\n\nimport type { SDKContextType } from './types.js';\n\nexport const SDKContext = createContext<SDKContextType>({\n  loading: false,\n});\n\nSDKContext.displayName = 'SDKContext';\n","import { init } from '@tma.js/sdk';\nimport React, { useEffect, useMemo, useState } from 'react';\n\nimport { SDKContext } from './SDKContext.js';\nimport type { SDKContextType, SDKProviderProps } from './types.js';\nimport type { InitResult } from '../types.js';\n\nfunction AsyncProvider({ options, children }: SDKProviderProps) {\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<unknown | undefined>();\n  const [initResult, setInitResult] = useState<InitResult | undefined>();\n\n  useEffect(() => {\n    setLoading(true);\n\n    init({ ...options, async: true })\n      .then(setInitResult)\n      .catch(setError)\n      .finally(() => setLoading(false));\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  const context = useMemo<SDKContextType>(() => {\n    const result: SDKContextType = { loading };\n    if (error) {\n      result.error = error;\n    }\n\n    if (initResult) {\n      result.initResult = initResult;\n    }\n\n    return result;\n  }, [loading, initResult, error]);\n\n  return <SDKContext.Provider value={context}>{children}</SDKContext.Provider>;\n}\n\nfunction SyncProvider({ options = {}, children }: SDKProviderProps) {\n  const context = useMemo<SDKContextType>(() => {\n    const result: SDKContextType = { loading: false };\n\n    try {\n      result.initResult = init({ ...options, async: false });\n    } catch (e) {\n      result.error = e;\n    }\n\n    return result;\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return <SDKContext.Provider value={context}>{children}</SDKContext.Provider>;\n}\n\n/**\n * Component which provides access to SDK initialization state.\n */\nexport function SDKProvider(props: SDKProviderProps) {\n  // eslint-disable-next-line react/destructuring-assignment\n  return props.options?.async\n    ? <AsyncProvider {...props} />\n    : <SyncProvider {...props} />;\n}\n","import { useContext } from 'react';\n\nimport { SDKContext } from './SDKContext.js';\nimport type { SDKContextType } from './types.js';\n\n/**\n * Returns current SDK information.\n */\nexport function useSDKContext(): SDKContextType {\n  return useContext(SDKContext);\n}\n","import { useSDKContext } from './useSDKContext.js';\nimport type { InitResultKey, InitResultValue } from '../types.js';\n\n/**\n * Returns value by its field name from SDK init result.\n * @param key - init result key.\n * @throws {Error} SDK is not initialized.\n */\nexport function useInitResultValue<K extends InitResultKey>(key: K): InitResultValue<K> {\n  const { initResult } = useSDKContext();\n\n  if (!initResult) {\n    throw new Error(`Unable to get init result key \"${key}\" as long as SDK is not initialized`);\n  }\n  return initResult[key];\n}\n","import { useEffect, useState } from 'react';\n\nimport { useInitResultValue } from './useInitResultValue.js';\nimport type {\n  DynamicInitResultKey,\n  InitResultValue,\n  Trackable,\n} from '../types.js';\n\nfunction shallowCopy<T>(value: T): T {\n  return Object.create(\n    Object.getPrototypeOf(value),\n    Object.getOwnPropertyDescriptors(value),\n  );\n}\n\nexport function useInitResultDynamicValue<K extends DynamicInitResultKey>(\n  initResultKey: K,\n): InitResultValue<K> {\n  // Extract init result value.\n  const initial = useInitResultValue(initResultKey);\n\n  // Create value which will be returned to the external environment.\n  const [copy, setCopy] = useState(shallowCopy(initial));\n\n  // Effect which listens to change event and calls update.\n  useEffect(() => {\n    return (initial as Trackable).on('change', () => {\n      setCopy(shallowCopy(initial));\n    });\n  }, [initial]);\n\n  return copy;\n}\n","import React, { type ComponentType } from 'react';\n\nimport type { SDKContextType } from './types.js';\nimport { useSDKContext } from './useSDKContext.js';\n\n/**\n * HOC which passes SDK context to wrapped React component.\n * @param Component - component to wrap.\n */\nexport function withSDKContext<P extends { sdk?: SDKContextType }>(\n  Component: ComponentType<P>,\n): ComponentType<Omit<P, 'sdk'>> {\n  return function WithSDKContext(props: Omit<P, 'sdk'>) {\n    const p = {\n      ...props,\n      sdk: useSDKContext(),\n    } as P;\n\n    return <Component {...p} />;\n  };\n}\n","import { useInitResultDynamicValue, useInitResultValue } from './provider/index.js';\nimport type {\n  DynamicInitResultKey,\n  InitResultKey,\n  InitResultValue,\n  StaticInitResultKey,\n} from './types.js';\n\nexport type Hook<K extends InitResultKey> = () => InitResultValue<K>;\n\n/**\n * Creates hook to retrieve static init result value.\n * @param initResultKey - init result key.\n */\nexport function createHook<K extends StaticInitResultKey>(initResultKey: K): Hook<K>;\n\n/**\n * Creates hook to retrieve dynamic init result value.\n * @param initResultKey - init result key.\n * @param dynamic - flag to let function know this init result value is dynamic.\n */\nexport function createHook<K extends DynamicInitResultKey>(\n  initResultKey: K,\n  dynamic: true,\n): Hook<K>;\n\nexport function createHook(initResultKey: InitResultKey, dynamic?: true): Hook<any> {\n  return dynamic\n    ? () => useInitResultDynamicValue(initResultKey as DynamicInitResultKey)\n    : () => useInitResultValue(initResultKey);\n}\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve BackButton component.\n */\nexport const useBackButton = createHook('backButton', true);\n\n/**\n * HOC to wrap specified component to pass BackButton instance.\n */\nexport const withBackButton = createHoc('backButton', useBackButton);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve ClosingBehavior component.\n */\nexport const useClosingBehavior = createHook('closingBehavior', true);\n\n/**\n * HOC to wrap specified component to pass ClosingBehavior instance.\n */\nexport const withClosingBehavior = createHoc('closingBehavior', useClosingBehavior);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve CloudStorage component.\n */\nexport const useCloudStorage = createHook('cloudStorage');\n\n/**\n * HOC to wrap specified component to pass CloudStorage instance.\n */\nexport const withCloudStorage = createHoc('cloudStorage', useCloudStorage);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve HapticFeedback component.\n */\nexport const useHapticFeedback = createHook('hapticFeedback');\n\n/**\n * HOC to wrap specified component to pass HapticFeedback instance.\n */\nexport const withHapticFeedback = createHoc('hapticFeedback', useHapticFeedback);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve InitData component.\n */\nexport const useInitData = createHook('initData');\n\n/**\n * HOC to wrap specified component to pass InitData instance.\n */\nexport const withInitData = createHoc('initData', useInitData);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve init data raw representation.\n */\nexport const useInitDataRaw = createHook('initDataRaw');\n\n/**\n * HOC to wrap specified component to pass init data raw representation.\n */\nexport const withInitDataRaw = createHoc('initDataRaw', useInitDataRaw);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Invoice component.\n */\nexport const useInvoice = createHook('invoice', true);\n\n/**\n * HOC to wrap specified component to pass Invoice instance.\n */\nexport const withInvoice = createHoc('invoice', useInvoice);\n","import { type LaunchParams, retrieveLaunchData } from '@tma.js/sdk';\nimport React, { type ComponentType, useMemo } from 'react';\n\n/**\n * Hooks to retrieve launch parameters.\n */\nexport function useLaunchParams(): LaunchParams {\n  return useMemo(() => retrieveLaunchData().launchParams, []);\n}\n\n/**\n * HOC to wrap specified component to pass launch parameters.\n * @param Component - wrapped component.\n */\nexport function withLaunchParams<P extends { launchParams?: LaunchParams }>(\n  Component: ComponentType<P>,\n) {\n  return function WithInvoice(props: P) {\n    return <Component {...props} launchParams={useLaunchParams()} />;\n  };\n}\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve MainButton component.\n */\nexport const useMainButton = createHook('mainButton', true);\n\n/**\n * HOC to wrap specified component to pass MainButton instance.\n */\nexport const withMainButton = createHoc('mainButton', useMainButton);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve MiniApp component.\n */\nexport const useMiniApp = createHook('miniApp', true);\n\n/**\n * HOC to wrap specified component to pass MiniApp instance.\n */\nexport const withMiniApp = createHoc('miniApp', useMiniApp);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Popup component.\n */\nexport const usePopup = createHook('popup', true);\n\n/**\n * HOC to wrap specified component to pass Popup instance.\n */\nexport const withPopup = createHoc('popup', usePopup);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve postEvent function.\n */\nexport const usePostEvent = createHook('postEvent');\n\n/**\n * HOC to wrap specified component to pass postEvent function.\n */\nexport const withPostEvent = createHoc('postEvent', usePostEvent);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve SettingsButton component.\n */\nexport const useSettingsButton = createHook('settingsButton', true);\n\n/**\n * HOC to wrap specified component to pass SettingsButton instance.\n */\nexport const withSettingsButton = createHoc('settingsButton', useSettingsButton);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve QRScanner component.\n */\nexport const useQRScanner = createHook('qrScanner', true);\n\n/**\n * HOC to wrap specified component to pass QRScanner instance.\n */\nexport const withQRScanner = createHoc('qrScanner', useQRScanner);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve ThemeParams component.\n */\nexport const useThemeParams = createHook('themeParams', true);\n\n/**\n * HOC to wrap specified component to pass ThemeParams instance.\n */\nexport const withThemeParams = createHoc('themeParams', useThemeParams);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Utils component.\n */\nexport const useUtils = createHook('utils');\n\n/**\n * HOC to wrap specified component to pass Utils instance.\n */\nexport const withUtils = createHoc('utils', useUtils);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Viewport component.\n */\nexport const useViewport = createHook('viewport', true);\n\n/**\n * HOC to wrap specified component to pass Viewport instance.\n */\nexport const withViewport = createHoc('viewport', useViewport);\n","import React, { type ComponentType, type PropsWithChildren, type ReactNode } from 'react';\n\nimport { useSDKContext } from './provider/index.js';\n\nexport interface DisplayGateProps extends PropsWithChildren {\n  /**\n   * Element or component, which will be displayed in case, SDK is not loading, didn't receive\n   * any error during initialization as well as the initialization result.\n   */\n  initial?: ReactNode | ComponentType;\n\n  /**\n   * Element or component which will be displayed in case, SDK initialization failed.\n   */\n  error?: ReactNode | ComponentType<{ error: unknown }>;\n\n  /**\n   * Element or component which will be displayed in case, SDK is currently loading.\n   */\n  loading?: ReactNode | ComponentType;\n}\n\nfunction render(Component: ReactNode | ComponentType): ReactNode;\nfunction render<T extends object>(Component: ReactNode | ComponentType<T>, props: T): ReactNode;\nfunction render(Component: ReactNode | ComponentType, props = {}): ReactNode {\n  return typeof Component === 'function' ? <Component {...props}/> : Component;\n}\n\n/**\n * This component is the layer controlling the application display. It displays application in\n * case, the SDK is initialized, displays an error if something went wrong, and a loader\n * if the SDK is warming up.\n */\nexport function DisplayGate(props: DisplayGateProps): ReactNode {\n  const { loading, initResult, error } = useSDKContext();\n\n  return initResult\n    ? props.children\n    : error\n      ? render(props.error, { error })\n      : render(loading ? props.loading : props.initial);\n}"],"names":["createHoc","initResultKey","hook","Component","Wrapper","props","wrappedProps","React","SDKContext","createContext","AsyncProvider","options","children","loading","setLoading","useState","error","setError","initResult","setInitResult","useEffect","init","context","useMemo","result","SyncProvider","e","SDKProvider","_a","useSDKContext","useContext","useInitResultValue","key","shallowCopy","value","useInitResultDynamicValue","initial","copy","setCopy","withSDKContext","p","createHook","dynamic","useBackButton","withBackButton","useClosingBehavior","withClosingBehavior","useCloudStorage","withCloudStorage","useHapticFeedback","withHapticFeedback","useInitData","withInitData","useInitDataRaw","withInitDataRaw","useInvoice","withInvoice","useLaunchParams","retrieveLaunchData","withLaunchParams","useMainButton","withMainButton","useMiniApp","withMiniApp","usePopup","withPopup","usePostEvent","withPostEvent","useSettingsButton","withSettingsButton","useQRScanner","withQRScanner","useThemeParams","withThemeParams","useUtils","withUtils","useViewport","withViewport","render","DisplayGate"],"mappings":"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"}

package/dist/index.mjs

@@ -1,128 +1,138 @@
-import a, { createContext as S, useState as s, useEffect as w, useMemo as m, useContext as B } from "react";
-import { init as v, retrieveLaunchData as C } from "@tma.js/sdk";
-function n(t, e) {
+import c, { createContext as B, useState as a, useEffect as g, useMemo as f, useContext as E } from "react";
+import { init as v, retrieveLaunchData as y } from "@tma.js/sdk";
+function o(t, e) {
   return (i) => {
-    function r(c) {
+    function n(s) {
       const l = {
-        ...c,
+        ...s,
         [t]: e()
       };
-      return /* @__PURE__ */ a.createElement(i, { ...l });
+      return /* @__PURE__ */ c.createElement(i, { ...l });
     }
-    return Object.defineProperty(r, "name", {
+    return Object.defineProperty(n, "name", {
       value: `With${t[0].toUpperCase()}${t.slice(1)}`
-    }), r;
+    }), n;
   };
 }
-const u = S({
+const u = B({
   loading: !1
 });
 u.displayName = "SDKContext";
-function E({ options: t, children: e }) {
-  const [i, r] = s(!1), [c, l] = s(), [p, D] = s();
-  w(() => {
-    r(!0), v({ ...t, async: !0 }).then(D).catch(l).finally(() => r(!1));
+function C({ options: t, children: e }) {
+  const [i, n] = a(!1), [s, l] = a(), [h, D] = a();
+  g(() => {
+    n(!0), v({ ...t, async: !0 }).then(D).catch(l).finally(() => n(!1));
   }, []);
-  const g = m(() => {
-    const h = { loading: i };
-    return c && (h.error = c), p && (h.initResult = p), h;
-  }, [i, p, c]);
-  return /* @__PURE__ */ a.createElement(u.Provider, { value: g }, e);
+  const S = f(() => {
+    const p = { loading: i };
+    return s && (p.error = s), h && (p.initResult = h), p;
+  }, [i, h, s]);
+  return /* @__PURE__ */ c.createElement(u.Provider, { value: S }, e);
 }
-function y({ options: t = {}, children: e }) {
-  const i = m(() => {
-    const r = { loading: !1 };
+function R({ options: t = {}, children: e }) {
+  const i = f(() => {
+    const n = { loading: !1 };
     try {
-      r.initResult = v({ ...t, async: !1 });
-    } catch (c) {
-      r.error = c;
+      n.initResult = v({ ...t, async: !1 });
+    } catch (s) {
+      n.error = s;
     }
-    return r;
+    return n;
   }, []);
-  return /* @__PURE__ */ a.createElement(u.Provider, { value: i }, e);
+  return /* @__PURE__ */ c.createElement(u.Provider, { value: i }, e);
 }
-function T(t) {
+function G(t) {
   var e;
-  return (e = t.options) != null && e.async ? /* @__PURE__ */ a.createElement(E, { ...t }) : /* @__PURE__ */ a.createElement(y, { ...t });
+  return (e = t.options) != null && e.async ? /* @__PURE__ */ c.createElement(C, { ...t }) : /* @__PURE__ */ c.createElement(R, { ...t });
 }
-function d() {
-  return B(u);
+function w() {
+  return E(u);
 }
 function P(t) {
-  const { initResult: e } = d();
+  const { initResult: e } = w();
   if (!e)
     throw new Error(`Unable to get init result key "${t}" as long as SDK is not initialized`);
   return e[t];
 }
-function f(t) {
+function m(t) {
   return Object.create(
     Object.getPrototypeOf(t),
     Object.getOwnPropertyDescriptors(t)
   );
 }
 function b(t) {
-  const e = P(t), [i, r] = s(f(e));
-  return w(() => e.on("change", () => {
-    r(f(e));
+  const e = P(t), [i, n] = a(m(e));
+  return g(() => e.on("change", () => {
+    n(m(e));
   }), [e]), i;
 }
-function z(t) {
+function N(t) {
   return function(i) {
-    const r = {
+    const n = {
       ...i,
-      sdk: d()
+      sdk: w()
     };
-    return /* @__PURE__ */ a.createElement(t, { ...r });
+    return /* @__PURE__ */ c.createElement(t, { ...n });
   };
 }
-function o(t, e) {
+function r(t, e) {
   return e ? () => b(t) : () => P(t);
 }
-const R = o("backButton", !0), N = n("backButton", R), k = o("closingBehavior", !0), G = n("closingBehavior", k), x = o("cloudStorage"), J = n("cloudStorage", x), I = o("hapticFeedback"), X = n("hapticFeedback", I), O = o("initData"), Y = n("initData", O), A = o("initDataRaw"), Z = n("initDataRaw", A), M = o("invoice", !0), _ = n("invoice", M);
-function j() {
-  return m(() => C().launchParams, []);
+const k = r("backButton", !0), J = o("backButton", k), x = r("closingBehavior", !0), X = o("closingBehavior", x), I = r("cloudStorage"), Y = o("cloudStorage", I), O = r("hapticFeedback"), Z = o("hapticFeedback", O), A = r("initData"), _ = o("initData", A), M = r("initDataRaw"), tt = o("initDataRaw", M), j = r("invoice", !0), et = o("invoice", j);
+function F() {
+  return f(() => y().launchParams, []);
 }
-function tt(t) {
+function nt(t) {
   return function(i) {
-    return /* @__PURE__ */ a.createElement(t, { ...i, launchParams: j() });
+    return /* @__PURE__ */ c.createElement(t, { ...i, launchParams: F() });
   };
 }
-const F = o("mainButton", !0), et = n("mainButton", F), H = o("miniApp", !0), nt = n("miniApp", H), K = o("popup", !0), ot = n("popup", K), L = o("postEvent"), rt = n("postEvent", L), U = o("qrScanner", !0), it = n("qrScanner", U), V = o("themeParams", !0), ct = n("themeParams", V), W = o("utils"), at = n("utils", W), $ = o("viewport", !0), st = n("viewport", $);
+const H = r("mainButton", !0), ot = o("mainButton", H), K = r("miniApp", !0), rt = o("miniApp", K), L = r("popup", !0), it = o("popup", L), U = r("postEvent"), ct = o("postEvent", U), V = r("settingsButton", !0), st = o("settingsButton", V), W = r("qrScanner", !0), at = o("qrScanner", W), $ = r("themeParams", !0), ut = o("themeParams", $), q = r("utils"), lt = o("utils", q), Q = r("viewport", !0), ht = o("viewport", Q);
+function d(t, e = {}) {
+  return typeof t == "function" ? /* @__PURE__ */ c.createElement(t, { ...e }) : t;
+}
+function pt(t) {
+  const { loading: e, initResult: i, error: n } = w();
+  return i ? t.children : n ? d(t.error, { error: n }) : d(e ? t.loading : t.initial);
+}
 export {
-  T as SDKProvider,
-  R as useBackButton,
-  k as useClosingBehavior,
-  x as useCloudStorage,
-  I as useHapticFeedback,
-  O as useInitData,
-  A as useInitDataRaw,
-  M as useInvoice,
-  j as useLaunchParams,
-  F as useMainButton,
-  H as useMiniApp,
-  K as usePopup,
-  L as usePostEvent,
-  U as useQRScanner,
-  d as useSDKContext,
-  V as useThemeParams,
-  W as useUtils,
-  $ as useViewport,
-  N as withBackButton,
-  G as withClosingBehavior,
-  J as withCloudStorage,
-  X as withHapticFeedback,
-  Y as withInitData,
-  Z as withInitDataRaw,
-  _ as withInvoice,
-  tt as withLaunchParams,
-  et as withMainButton,
-  nt as withMiniApp,
-  ot as withPopup,
-  rt as withPostEvent,
-  it as withQRScanner,
-  z as withSDKContext,
-  ct as withThemeParams,
-  at as withUtils,
-  st as withViewport
+  pt as DisplayGate,
+  G as SDKProvider,
+  k as useBackButton,
+  x as useClosingBehavior,
+  I as useCloudStorage,
+  O as useHapticFeedback,
+  A as useInitData,
+  M as useInitDataRaw,
+  j as useInvoice,
+  F as useLaunchParams,
+  H as useMainButton,
+  K as useMiniApp,
+  L as usePopup,
+  U as usePostEvent,
+  W as useQRScanner,
+  w as useSDKContext,
+  V as useSettingsButton,
+  $ as useThemeParams,
+  q as useUtils,
+  Q as useViewport,
+  J as withBackButton,
+  X as withClosingBehavior,
+  Y as withCloudStorage,
+  Z as withHapticFeedback,
+  _ as withInitData,
+  tt as withInitDataRaw,
+  et as withInvoice,
+  nt as withLaunchParams,
+  ot as withMainButton,
+  rt as withMiniApp,
+  it as withPopup,
+  ct as withPostEvent,
+  at as withQRScanner,
+  N as withSDKContext,
+  st as withSettingsButton,
+  ut as withThemeParams,
+  lt as withUtils,
+  ht as withViewport
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/createHoc.tsx","../src/provider/SDKContext.ts","../src/provider/SDKProvider.tsx","../src/provider/useSDKContext.ts","../src/provider/useInitResultValue.ts","../src/provider/useInitResultDynamicValue.ts","../src/provider/withSDKContext.tsx","../src/createHook.ts","../src/tools/back-button.ts","../src/tools/closing-behavior.ts","../src/tools/cloud-storage.ts","../src/tools/haptic-feedback.ts","../src/tools/init-data.ts","../src/tools/init-data-raw.ts","../src/tools/invoice.ts","../src/tools/launch-params.tsx","../src/tools/main-button.ts","../src/tools/mini-app.ts","../src/tools/popup.ts","../src/tools/post-event.ts","../src/tools/qr-scanner.ts","../src/tools/theme-params.ts","../src/tools/utils.ts","../src/tools/viewport.ts"],"sourcesContent":["import React, { type ComponentType } from 'react';\n\nimport type { Hook } from './createHook.js';\nimport type { InitResultKey, InitResultValue } from './types.js';\n\nexport type Hoc<K extends InitResultKey> = <P extends { [Key in K]?: InitResultValue<K> }>(\n  Component: ComponentType<P>,\n) => ComponentType<P>;\n\n/**\n * Creates HOC for static init result value.\n * @param initResultKey - init result key.\n * @param hook - hook which returns init result value.\n */\nexport function createHoc<K extends InitResultKey>(initResultKey: K, hook: Hook<K>): Hoc<K> {\n  return (Component: ComponentType<any>) => {\n    function Wrapper(props: Record<string, unknown>) {\n      const wrappedProps = {\n        ...props,\n        [initResultKey]: hook(),\n      };\n\n      return <Component {...wrappedProps} />;\n    }\n\n    Object.defineProperty(Wrapper, 'name', {\n      value: `With${initResultKey[0].toUpperCase()}${initResultKey.slice(1)}`,\n    });\n\n    return Wrapper;\n  };\n}\n","import { createContext } from 'react';\n\nimport type { SDKContextType } from './types.js';\n\nexport const SDKContext = createContext<SDKContextType>({\n  loading: false,\n});\n\nSDKContext.displayName = 'SDKContext';\n","import { init } from '@tma.js/sdk';\nimport React, { useEffect, useMemo, useState } from 'react';\n\nimport { SDKContext } from './SDKContext.js';\nimport type { SDKContextType, SDKProviderProps } from './types.js';\nimport type { InitResult } from '../types.js';\n\nfunction AsyncProvider({ options, children }: SDKProviderProps) {\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<unknown | undefined>();\n  const [initResult, setInitResult] = useState<InitResult | undefined>();\n\n  useEffect(() => {\n    setLoading(true);\n\n    init({ ...options, async: true })\n      .then(setInitResult)\n      .catch(setError)\n      .finally(() => setLoading(false));\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  const context = useMemo<SDKContextType>(() => {\n    const result: SDKContextType = { loading };\n    if (error) {\n      result.error = error;\n    }\n\n    if (initResult) {\n      result.initResult = initResult;\n    }\n\n    return result;\n  }, [loading, initResult, error]);\n\n  return <SDKContext.Provider value={context}>{children}</SDKContext.Provider>;\n}\n\nfunction SyncProvider({ options = {}, children }: SDKProviderProps) {\n  const context = useMemo<SDKContextType>(() => {\n    const result: SDKContextType = { loading: false };\n\n    try {\n      result.initResult = init({ ...options, async: false });\n    } catch (e) {\n      result.error = e;\n    }\n\n    return result;\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return <SDKContext.Provider value={context}>{children}</SDKContext.Provider>;\n}\n\n/**\n * Component which provides access to SDK initialization state.\n */\nexport function SDKProvider(props: SDKProviderProps) {\n  // eslint-disable-next-line react/destructuring-assignment\n  return props.options?.async\n    ? <AsyncProvider {...props} />\n    : <SyncProvider {...props} />;\n}\n","import { useContext } from 'react';\n\nimport { SDKContext } from './SDKContext.js';\nimport type { SDKContextType } from './types.js';\n\n/**\n * Returns current SDK information.\n */\nexport function useSDKContext(): SDKContextType {\n  return useContext(SDKContext);\n}\n","import { useSDKContext } from './useSDKContext.js';\nimport type { InitResultKey, InitResultValue } from '../types.js';\n\n/**\n * Returns value by its field name from SDK init result.\n * @param key - init result key.\n * @throws {Error} SDK is not initialized.\n */\nexport function useInitResultValue<K extends InitResultKey>(key: K): InitResultValue<K> {\n  const { initResult } = useSDKContext();\n\n  if (!initResult) {\n    throw new Error(`Unable to get init result key \"${key}\" as long as SDK is not initialized`);\n  }\n  return initResult[key];\n}\n","import { useEffect, useState } from 'react';\n\nimport { useInitResultValue } from './useInitResultValue.js';\nimport type {\n  DynamicInitResultKey,\n  InitResultValue,\n  Trackable,\n} from '../types.js';\n\nfunction shallowCopy<T>(value: T): T {\n  return Object.create(\n    Object.getPrototypeOf(value),\n    Object.getOwnPropertyDescriptors(value),\n  );\n}\n\nexport function useInitResultDynamicValue<K extends DynamicInitResultKey>(\n  initResultKey: K,\n): InitResultValue<K> {\n  // Extract init result value.\n  const initial = useInitResultValue(initResultKey);\n\n  // Create value which will be returned to the external environment.\n  const [copy, setCopy] = useState(shallowCopy(initial));\n\n  // Effect which listens to change event and calls update.\n  useEffect(() => {\n    return (initial as Trackable).on('change', () => {\n      setCopy(shallowCopy(initial));\n    });\n  }, [initial]);\n\n  return copy;\n}\n","import React, { type ComponentType } from 'react';\n\nimport type { SDKContextType } from './types.js';\nimport { useSDKContext } from './useSDKContext.js';\n\n/**\n * HOC which passes SDK context to wrapped React component.\n * @param Component - component to wrap.\n */\nexport function withSDKContext<P extends { sdk?: SDKContextType }>(\n  Component: ComponentType<P>,\n): ComponentType<Omit<P, 'sdk'>> {\n  return function WithSDKContext(props: Omit<P, 'sdk'>) {\n    const p = {\n      ...props,\n      sdk: useSDKContext(),\n    } as P;\n\n    return <Component {...p} />;\n  };\n}\n","import { useInitResultDynamicValue, useInitResultValue } from './provider/index.js';\nimport type {\n  DynamicInitResultKey,\n  InitResultKey,\n  InitResultValue,\n  StaticInitResultKey,\n} from './types.js';\n\nexport type Hook<K extends InitResultKey> = () => InitResultValue<K>;\n\n/**\n * Creates hook to retrieve static init result value.\n * @param initResultKey - init result key.\n */\nexport function createHook<K extends StaticInitResultKey>(initResultKey: K): Hook<K>;\n\n/**\n * Creates hook to retrieve dynamic init result value.\n * @param initResultKey - init result key.\n * @param dynamic - flag to let function know this init result value is dynamic.\n */\nexport function createHook<K extends DynamicInitResultKey>(\n  initResultKey: K,\n  dynamic: true,\n): Hook<K>;\n\nexport function createHook(initResultKey: InitResultKey, dynamic?: true): Hook<any> {\n  return dynamic\n    ? () => useInitResultDynamicValue(initResultKey as DynamicInitResultKey)\n    : () => useInitResultValue(initResultKey);\n}\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve BackButton component.\n */\nexport const useBackButton = createHook('backButton', true);\n\n/**\n * HOC to wrap specified component to pass BackButton instance.\n */\nexport const withBackButton = createHoc('backButton', useBackButton);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve ClosingBehavior component.\n */\nexport const useClosingBehavior = createHook('closingBehavior', true);\n\n/**\n * HOC to wrap specified component to pass ClosingBehavior instance.\n */\nexport const withClosingBehavior = createHoc('closingBehavior', useClosingBehavior);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve CloudStorage component.\n */\nexport const useCloudStorage = createHook('cloudStorage');\n\n/**\n * HOC to wrap specified component to pass CloudStorage instance.\n */\nexport const withCloudStorage = createHoc('cloudStorage', useCloudStorage);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve HapticFeedback component.\n */\nexport const useHapticFeedback = createHook('hapticFeedback');\n\n/**\n * HOC to wrap specified component to pass HapticFeedback instance.\n */\nexport const withHapticFeedback = createHoc('hapticFeedback', useHapticFeedback);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve InitData component.\n */\nexport const useInitData = createHook('initData');\n\n/**\n * HOC to wrap specified component to pass InitData instance.\n */\nexport const withInitData = createHoc('initData', useInitData);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve init data raw representation.\n */\nexport const useInitDataRaw = createHook('initDataRaw');\n\n/**\n * HOC to wrap specified component to pass init data raw representation.\n */\nexport const withInitDataRaw = createHoc('initDataRaw', useInitDataRaw);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Invoice component.\n */\nexport const useInvoice = createHook('invoice', true);\n\n/**\n * HOC to wrap specified component to pass Invoice instance.\n */\nexport const withInvoice = createHoc('invoice', useInvoice);\n","import { type LaunchParams, retrieveLaunchData } from '@tma.js/sdk';\nimport React, { type ComponentType, useMemo } from 'react';\n\n/**\n * Hooks to retrieve launch parameters.\n */\nexport function useLaunchParams(): LaunchParams {\n  return useMemo(() => retrieveLaunchData().launchParams, []);\n}\n\n/**\n * HOC to wrap specified component to pass launch parameters.\n * @param Component - wrapped component.\n */\nexport function withLaunchParams<P extends { launchParams?: LaunchParams }>(\n  Component: ComponentType<P>,\n) {\n  return function WithInvoice(props: P) {\n    return <Component {...props} launchParams={useLaunchParams()} />;\n  };\n}\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve MainButton component.\n */\nexport const useMainButton = createHook('mainButton', true);\n\n/**\n * HOC to wrap specified component to pass MainButton instance.\n */\nexport const withMainButton = createHoc('mainButton', useMainButton);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve MiniApp component.\n */\nexport const useMiniApp = createHook('miniApp', true);\n\n/**\n * HOC to wrap specified component to pass MiniApp instance.\n */\nexport const withMiniApp = createHoc('miniApp', useMiniApp);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Popup component.\n */\nexport const usePopup = createHook('popup', true);\n\n/**\n * HOC to wrap specified component to pass Popup instance.\n */\nexport const withPopup = createHoc('popup', usePopup);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve postEvent function.\n */\nexport const usePostEvent = createHook('postEvent');\n\n/**\n * HOC to wrap specified component to pass postEvent function.\n */\nexport const withPostEvent = createHoc('postEvent', usePostEvent);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve QRScanner component.\n */\nexport const useQRScanner = createHook('qrScanner', true);\n\n/**\n * HOC to wrap specified component to pass QRScanner instance.\n */\nexport const withQRScanner = createHoc('qrScanner', useQRScanner);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve ThemeParams component.\n */\nexport const useThemeParams = createHook('themeParams', true);\n\n/**\n * HOC to wrap specified component to pass ThemeParams instance.\n */\nexport const withThemeParams = createHoc('themeParams', useThemeParams);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Utils component.\n */\nexport const useUtils = createHook('utils');\n\n/**\n * HOC to wrap specified component to pass Utils instance.\n */\nexport const withUtils = createHoc('utils', useUtils);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Viewport component.\n */\nexport const useViewport = createHook('viewport', true);\n\n/**\n * HOC to wrap specified component to pass Viewport instance.\n */\nexport const withViewport = createHoc('viewport', useViewport);\n"],"names":["createHoc","initResultKey","hook","Component","Wrapper","props","wrappedProps","React","SDKContext","createContext","AsyncProvider","options","children","loading","setLoading","useState","error","setError","initResult","setInitResult","useEffect","init","context","useMemo","result","SyncProvider","e","SDKProvider","_a","useSDKContext","useContext","useInitResultValue","key","shallowCopy","value","useInitResultDynamicValue","initial","copy","setCopy","withSDKContext","p","createHook","dynamic","useBackButton","withBackButton","useClosingBehavior","withClosingBehavior","useCloudStorage","withCloudStorage","useHapticFeedback","withHapticFeedback","useInitData","withInitData","useInitDataRaw","withInitDataRaw","useInvoice","withInvoice","useLaunchParams","retrieveLaunchData","withLaunchParams","useMainButton","withMainButton","useMiniApp","withMiniApp","usePopup","withPopup","usePostEvent","withPostEvent","useQRScanner","withQRScanner","useThemeParams","withThemeParams","useUtils","withUtils","useViewport","withViewport"],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["../src/createHoc.tsx","../src/provider/SDKContext.ts","../src/provider/SDKProvider.tsx","../src/provider/useSDKContext.ts","../src/provider/useInitResultValue.ts","../src/provider/useInitResultDynamicValue.ts","../src/provider/withSDKContext.tsx","../src/createHook.ts","../src/tools/back-button.ts","../src/tools/closing-behavior.ts","../src/tools/cloud-storage.ts","../src/tools/haptic-feedback.ts","../src/tools/init-data.ts","../src/tools/init-data-raw.ts","../src/tools/invoice.ts","../src/tools/launch-params.tsx","../src/tools/main-button.ts","../src/tools/mini-app.ts","../src/tools/popup.ts","../src/tools/post-event.ts","../src/tools/settings-button.ts","../src/tools/qr-scanner.ts","../src/tools/theme-params.ts","../src/tools/utils.ts","../src/tools/viewport.ts","../src/DisplayGate.tsx"],"sourcesContent":["import React, { type ComponentType } from 'react';\n\nimport type { Hook } from './createHook.js';\nimport type { InitResultKey, InitResultValue } from './types.js';\n\nexport type Hoc<K extends InitResultKey> = <P extends { [Key in K]?: InitResultValue<K> }>(\n  Component: ComponentType<P>,\n) => ComponentType<P>;\n\n/**\n * Creates HOC for static init result value.\n * @param initResultKey - init result key.\n * @param hook - hook which returns init result value.\n */\nexport function createHoc<K extends InitResultKey>(initResultKey: K, hook: Hook<K>): Hoc<K> {\n  return (Component: ComponentType<any>) => {\n    function Wrapper(props: Record<string, unknown>) {\n      const wrappedProps = {\n        ...props,\n        [initResultKey]: hook(),\n      };\n\n      return <Component {...wrappedProps} />;\n    }\n\n    Object.defineProperty(Wrapper, 'name', {\n      value: `With${initResultKey[0].toUpperCase()}${initResultKey.slice(1)}`,\n    });\n\n    return Wrapper;\n  };\n}\n","import { createContext } from 'react';\n\nimport type { SDKContextType } from './types.js';\n\nexport const SDKContext = createContext<SDKContextType>({\n  loading: false,\n});\n\nSDKContext.displayName = 'SDKContext';\n","import { init } from '@tma.js/sdk';\nimport React, { useEffect, useMemo, useState } from 'react';\n\nimport { SDKContext } from './SDKContext.js';\nimport type { SDKContextType, SDKProviderProps } from './types.js';\nimport type { InitResult } from '../types.js';\n\nfunction AsyncProvider({ options, children }: SDKProviderProps) {\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<unknown | undefined>();\n  const [initResult, setInitResult] = useState<InitResult | undefined>();\n\n  useEffect(() => {\n    setLoading(true);\n\n    init({ ...options, async: true })\n      .then(setInitResult)\n      .catch(setError)\n      .finally(() => setLoading(false));\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  const context = useMemo<SDKContextType>(() => {\n    const result: SDKContextType = { loading };\n    if (error) {\n      result.error = error;\n    }\n\n    if (initResult) {\n      result.initResult = initResult;\n    }\n\n    return result;\n  }, [loading, initResult, error]);\n\n  return <SDKContext.Provider value={context}>{children}</SDKContext.Provider>;\n}\n\nfunction SyncProvider({ options = {}, children }: SDKProviderProps) {\n  const context = useMemo<SDKContextType>(() => {\n    const result: SDKContextType = { loading: false };\n\n    try {\n      result.initResult = init({ ...options, async: false });\n    } catch (e) {\n      result.error = e;\n    }\n\n    return result;\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return <SDKContext.Provider value={context}>{children}</SDKContext.Provider>;\n}\n\n/**\n * Component which provides access to SDK initialization state.\n */\nexport function SDKProvider(props: SDKProviderProps) {\n  // eslint-disable-next-line react/destructuring-assignment\n  return props.options?.async\n    ? <AsyncProvider {...props} />\n    : <SyncProvider {...props} />;\n}\n","import { useContext } from 'react';\n\nimport { SDKContext } from './SDKContext.js';\nimport type { SDKContextType } from './types.js';\n\n/**\n * Returns current SDK information.\n */\nexport function useSDKContext(): SDKContextType {\n  return useContext(SDKContext);\n}\n","import { useSDKContext } from './useSDKContext.js';\nimport type { InitResultKey, InitResultValue } from '../types.js';\n\n/**\n * Returns value by its field name from SDK init result.\n * @param key - init result key.\n * @throws {Error} SDK is not initialized.\n */\nexport function useInitResultValue<K extends InitResultKey>(key: K): InitResultValue<K> {\n  const { initResult } = useSDKContext();\n\n  if (!initResult) {\n    throw new Error(`Unable to get init result key \"${key}\" as long as SDK is not initialized`);\n  }\n  return initResult[key];\n}\n","import { useEffect, useState } from 'react';\n\nimport { useInitResultValue } from './useInitResultValue.js';\nimport type {\n  DynamicInitResultKey,\n  InitResultValue,\n  Trackable,\n} from '../types.js';\n\nfunction shallowCopy<T>(value: T): T {\n  return Object.create(\n    Object.getPrototypeOf(value),\n    Object.getOwnPropertyDescriptors(value),\n  );\n}\n\nexport function useInitResultDynamicValue<K extends DynamicInitResultKey>(\n  initResultKey: K,\n): InitResultValue<K> {\n  // Extract init result value.\n  const initial = useInitResultValue(initResultKey);\n\n  // Create value which will be returned to the external environment.\n  const [copy, setCopy] = useState(shallowCopy(initial));\n\n  // Effect which listens to change event and calls update.\n  useEffect(() => {\n    return (initial as Trackable).on('change', () => {\n      setCopy(shallowCopy(initial));\n    });\n  }, [initial]);\n\n  return copy;\n}\n","import React, { type ComponentType } from 'react';\n\nimport type { SDKContextType } from './types.js';\nimport { useSDKContext } from './useSDKContext.js';\n\n/**\n * HOC which passes SDK context to wrapped React component.\n * @param Component - component to wrap.\n */\nexport function withSDKContext<P extends { sdk?: SDKContextType }>(\n  Component: ComponentType<P>,\n): ComponentType<Omit<P, 'sdk'>> {\n  return function WithSDKContext(props: Omit<P, 'sdk'>) {\n    const p = {\n      ...props,\n      sdk: useSDKContext(),\n    } as P;\n\n    return <Component {...p} />;\n  };\n}\n","import { useInitResultDynamicValue, useInitResultValue } from './provider/index.js';\nimport type {\n  DynamicInitResultKey,\n  InitResultKey,\n  InitResultValue,\n  StaticInitResultKey,\n} from './types.js';\n\nexport type Hook<K extends InitResultKey> = () => InitResultValue<K>;\n\n/**\n * Creates hook to retrieve static init result value.\n * @param initResultKey - init result key.\n */\nexport function createHook<K extends StaticInitResultKey>(initResultKey: K): Hook<K>;\n\n/**\n * Creates hook to retrieve dynamic init result value.\n * @param initResultKey - init result key.\n * @param dynamic - flag to let function know this init result value is dynamic.\n */\nexport function createHook<K extends DynamicInitResultKey>(\n  initResultKey: K,\n  dynamic: true,\n): Hook<K>;\n\nexport function createHook(initResultKey: InitResultKey, dynamic?: true): Hook<any> {\n  return dynamic\n    ? () => useInitResultDynamicValue(initResultKey as DynamicInitResultKey)\n    : () => useInitResultValue(initResultKey);\n}\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve BackButton component.\n */\nexport const useBackButton = createHook('backButton', true);\n\n/**\n * HOC to wrap specified component to pass BackButton instance.\n */\nexport const withBackButton = createHoc('backButton', useBackButton);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve ClosingBehavior component.\n */\nexport const useClosingBehavior = createHook('closingBehavior', true);\n\n/**\n * HOC to wrap specified component to pass ClosingBehavior instance.\n */\nexport const withClosingBehavior = createHoc('closingBehavior', useClosingBehavior);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve CloudStorage component.\n */\nexport const useCloudStorage = createHook('cloudStorage');\n\n/**\n * HOC to wrap specified component to pass CloudStorage instance.\n */\nexport const withCloudStorage = createHoc('cloudStorage', useCloudStorage);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve HapticFeedback component.\n */\nexport const useHapticFeedback = createHook('hapticFeedback');\n\n/**\n * HOC to wrap specified component to pass HapticFeedback instance.\n */\nexport const withHapticFeedback = createHoc('hapticFeedback', useHapticFeedback);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve InitData component.\n */\nexport const useInitData = createHook('initData');\n\n/**\n * HOC to wrap specified component to pass InitData instance.\n */\nexport const withInitData = createHoc('initData', useInitData);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve init data raw representation.\n */\nexport const useInitDataRaw = createHook('initDataRaw');\n\n/**\n * HOC to wrap specified component to pass init data raw representation.\n */\nexport const withInitDataRaw = createHoc('initDataRaw', useInitDataRaw);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Invoice component.\n */\nexport const useInvoice = createHook('invoice', true);\n\n/**\n * HOC to wrap specified component to pass Invoice instance.\n */\nexport const withInvoice = createHoc('invoice', useInvoice);\n","import { type LaunchParams, retrieveLaunchData } from '@tma.js/sdk';\nimport React, { type ComponentType, useMemo } from 'react';\n\n/**\n * Hooks to retrieve launch parameters.\n */\nexport function useLaunchParams(): LaunchParams {\n  return useMemo(() => retrieveLaunchData().launchParams, []);\n}\n\n/**\n * HOC to wrap specified component to pass launch parameters.\n * @param Component - wrapped component.\n */\nexport function withLaunchParams<P extends { launchParams?: LaunchParams }>(\n  Component: ComponentType<P>,\n) {\n  return function WithInvoice(props: P) {\n    return <Component {...props} launchParams={useLaunchParams()} />;\n  };\n}\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve MainButton component.\n */\nexport const useMainButton = createHook('mainButton', true);\n\n/**\n * HOC to wrap specified component to pass MainButton instance.\n */\nexport const withMainButton = createHoc('mainButton', useMainButton);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve MiniApp component.\n */\nexport const useMiniApp = createHook('miniApp', true);\n\n/**\n * HOC to wrap specified component to pass MiniApp instance.\n */\nexport const withMiniApp = createHoc('miniApp', useMiniApp);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Popup component.\n */\nexport const usePopup = createHook('popup', true);\n\n/**\n * HOC to wrap specified component to pass Popup instance.\n */\nexport const withPopup = createHoc('popup', usePopup);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve postEvent function.\n */\nexport const usePostEvent = createHook('postEvent');\n\n/**\n * HOC to wrap specified component to pass postEvent function.\n */\nexport const withPostEvent = createHoc('postEvent', usePostEvent);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve SettingsButton component.\n */\nexport const useSettingsButton = createHook('settingsButton', true);\n\n/**\n * HOC to wrap specified component to pass SettingsButton instance.\n */\nexport const withSettingsButton = createHoc('settingsButton', useSettingsButton);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve QRScanner component.\n */\nexport const useQRScanner = createHook('qrScanner', true);\n\n/**\n * HOC to wrap specified component to pass QRScanner instance.\n */\nexport const withQRScanner = createHoc('qrScanner', useQRScanner);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve ThemeParams component.\n */\nexport const useThemeParams = createHook('themeParams', true);\n\n/**\n * HOC to wrap specified component to pass ThemeParams instance.\n */\nexport const withThemeParams = createHoc('themeParams', useThemeParams);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Utils component.\n */\nexport const useUtils = createHook('utils');\n\n/**\n * HOC to wrap specified component to pass Utils instance.\n */\nexport const withUtils = createHoc('utils', useUtils);\n","import { createHoc } from '../createHoc.js';\nimport { createHook } from '../createHook.js';\n\n/**\n * Hook to retrieve Viewport component.\n */\nexport const useViewport = createHook('viewport', true);\n\n/**\n * HOC to wrap specified component to pass Viewport instance.\n */\nexport const withViewport = createHoc('viewport', useViewport);\n","import React, { type ComponentType, type PropsWithChildren, type ReactNode } from 'react';\n\nimport { useSDKContext } from './provider/index.js';\n\nexport interface DisplayGateProps extends PropsWithChildren {\n  /**\n   * Element or component, which will be displayed in case, SDK is not loading, didn't receive\n   * any error during initialization as well as the initialization result.\n   */\n  initial?: ReactNode | ComponentType;\n\n  /**\n   * Element or component which will be displayed in case, SDK initialization failed.\n   */\n  error?: ReactNode | ComponentType<{ error: unknown }>;\n\n  /**\n   * Element or component which will be displayed in case, SDK is currently loading.\n   */\n  loading?: ReactNode | ComponentType;\n}\n\nfunction render(Component: ReactNode | ComponentType): ReactNode;\nfunction render<T extends object>(Component: ReactNode | ComponentType<T>, props: T): ReactNode;\nfunction render(Component: ReactNode | ComponentType, props = {}): ReactNode {\n  return typeof Component === 'function' ? <Component {...props}/> : Component;\n}\n\n/**\n * This component is the layer controlling the application display. It displays application in\n * case, the SDK is initialized, displays an error if something went wrong, and a loader\n * if the SDK is warming up.\n */\nexport function DisplayGate(props: DisplayGateProps): ReactNode {\n  const { loading, initResult, error } = useSDKContext();\n\n  return initResult\n    ? props.children\n    : error\n      ? render(props.error, { error })\n      : render(loading ? props.loading : props.initial);\n}"],"names":["createHoc","initResultKey","hook","Component","Wrapper","props","wrappedProps","React","SDKContext","createContext","AsyncProvider","options","children","loading","setLoading","useState","error","setError","initResult","setInitResult","useEffect","init","context","useMemo","result","SyncProvider","e","SDKProvider","_a","useSDKContext","useContext","useInitResultValue","key","shallowCopy","value","useInitResultDynamicValue","initial","copy","setCopy","withSDKContext","p","createHook","dynamic","useBackButton","withBackButton","useClosingBehavior","withClosingBehavior","useCloudStorage","withCloudStorage","useHapticFeedback","withHapticFeedback","useInitData","withInitData","useInitDataRaw","withInitDataRaw","useInvoice","withInvoice","useLaunchParams","retrieveLaunchData","withLaunchParams","useMainButton","withMainButton","useMiniApp","withMiniApp","usePopup","withPopup","usePostEvent","withPostEvent","useSettingsButton","withSettingsButton","useQRScanner","withQRScanner","useThemeParams","withThemeParams","useUtils","withUtils","useViewport","withViewport","render","DisplayGate"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tma.js/sdk-react",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "React bindings for Mini Apps client SDK. Contains hooks, components and other useful tools which allow usage of React along with Mini Apps client SDK.",
   "author": "Vladislav Kibenko <wolfram.deus@gmail.com>",
   "homepage": "https://github.com/Telegram-Mini-Apps/tma.js#readme",
@@ -46,7 +46,7 @@
     }
   },
   "dependencies": {
-    "@tma.js/sdk": "1.1.0"
+    "@tma.js/sdk": "1.2.0"
   },
   "devDependencies": {
     "build-utils": "0.0.1",

package/src/DisplayGate.tsx

@@ -0,0 +1,42 @@
+import React, { type ComponentType, type PropsWithChildren, type ReactNode } from 'react';
+
+import { useSDKContext } from './provider/index.js';
+
+export interface DisplayGateProps extends PropsWithChildren {
+  /**
+   * Element or component, which will be displayed in case, SDK is not loading, didn't receive
+   * any error during initialization as well as the initialization result.
+   */
+  initial?: ReactNode | ComponentType;
+
+  /**
+   * Element or component which will be displayed in case, SDK initialization failed.
+   */
+  error?: ReactNode | ComponentType<{ error: unknown }>;
+
+  /**
+   * Element or component which will be displayed in case, SDK is currently loading.
+   */
+  loading?: ReactNode | ComponentType;
+}
+
+function render(Component: ReactNode | ComponentType): ReactNode;
+function render<T extends object>(Component: ReactNode | ComponentType<T>, props: T): ReactNode;
+function render(Component: ReactNode | ComponentType, props = {}): ReactNode {
+  return typeof Component === 'function' ? <Component {...props}/> : Component;
+}
+
+/**
+ * This component is the layer controlling the application display. It displays application in
+ * case, the SDK is initialized, displays an error if something went wrong, and a loader
+ * if the SDK is warming up.
+ */
+export function DisplayGate(props: DisplayGateProps): ReactNode {
+  const { loading, initResult, error } = useSDKContext();
+
+  return initResult
+    ? props.children
+    : error
+      ? render(props.error, { error })
+      : render(loading ? props.loading : props.initial);
+}

package/src/index.ts

@@ -13,6 +13,7 @@ export {
   usePopup,
   usePostEvent,
   useQRScanner,
+  useSettingsButton,
   useUtils,
   useViewport,
   withBackButton,
@@ -29,6 +30,7 @@ export {
   withPopup,
   withThemeParams,
   withQRScanner,
+  withSettingsButton,
   withUtils,
   withViewport,
 } from './tools/index.js';
@@ -39,6 +41,10 @@ export {
   type SDKProviderProps,
   type SDKContextType,
 } from './provider/index.js';
+export {
+  DisplayGate,
+  type DisplayGateProps,
+} from './DisplayGate.js';
 export type {
   InitOptions,
   InitResult,

package/src/tools/index.ts

@@ -10,6 +10,7 @@ export * from './main-button.js';
 export * from './mini-app.js';
 export * from './popup.js';
 export * from './post-event.js';
+export * from './settings-button.js';
 export * from './qr-scanner.js';
 export * from './theme-params.js';
 export * from './utils.js';

package/src/tools/settings-button.ts

@@ -0,0 +1,12 @@
+import { createHoc } from '../createHoc.js';
+import { createHook } from '../createHook.js';
+
+/**
+ * Hook to retrieve SettingsButton component.
+ */
+export const useSettingsButton = createHook('settingsButton', true);
+
+/**
+ * HOC to wrap specified component to pass SettingsButton instance.
+ */
+export const withSettingsButton = createHoc('settingsButton', useSettingsButton);