@tma.js/sdk-react 0.4.12 → 0.4.14

package/src/lib/qr-scanner/withQRScanner.tsx

@@ -1,18 +1,18 @@
-import React, { type ComponentType } from 'react';
-
-import { useQRScanner } from './useQRScanner.js';
-import type { QRScanner } from './types.js';
-
-/**
- * HOC which passes QRScanner SDK component to wrapped React component.
- * @param Component - component to wrap.
- */
-export function withQRScanner<P extends { qrScanner?: QRScanner }>(
-  Component: ComponentType<P>,
-): ComponentType<Omit<P, 'qrScanner'>> {
-  return function WithQRScanner(props: Omit<P, 'qrScanner'>) {
-    const p = { ...props, qrScanner: useQRScanner() } as P;
-
-    return <Component {...p} />;
-  };
-}
+import React, { type ComponentType } from 'react';
+
+import { useQRScanner } from './useQRScanner.js';
+import type { QRScanner } from './types.js';
+
+/**
+ * HOC which passes QRScanner SDK component to wrapped React component.
+ * @param Component - component to wrap.
+ */
+export function withQRScanner<P extends { qrScanner?: QRScanner }>(
+  Component: ComponentType<P>,
+): ComponentType<Omit<P, 'qrScanner'>> {
+  return function WithQRScanner(props: Omit<P, 'qrScanner'>) {
+    const p = { ...props, qrScanner: useQRScanner() } as P;
+
+    return <Component {...p} />;
+  };
+}

package/src/lib/theme-params.tsx

@@ -1,29 +1,29 @@
-import React, { type ComponentType } from 'react';
-import type { ThemeParams } from '@tma.js/sdk';
-
-import { useUnit } from '../provider/index.js';
-import { useEventsTracking } from './hooks.js';
-
-/**
- * Returns ThemeParams component instance.
- */
-export function useThemeParams(): ThemeParams {
-  const theme = useUnit('themeParams');
-  useEventsTracking(theme, ['changed']);
-
-  return theme;
-}
-
-/**
- * HOC which passes ThemeParams SDK component to wrapped React component.
- * @param Component - component to wrap.
- */
-export function withThemeParams<P extends { themeParams?: ThemeParams }>(
-  Component: ComponentType<P>,
-): ComponentType<Omit<P, 'themeParams'>> {
-  return function WithThemeParams(props: Omit<P, 'themeParams'>) {
-    const p = { ...props, themeParams: useThemeParams() } as P;
-
-    return <Component {...p} />;
-  };
-}
+import React, { type ComponentType } from 'react';
+import type { ThemeParams } from '@tma.js/sdk';
+
+import { useUnit } from '../provider/index.js';
+import { useEventsTracking } from './hooks.js';
+
+/**
+ * Returns ThemeParams component instance.
+ */
+export function useThemeParams(): ThemeParams {
+  const theme = useUnit('themeParams');
+  useEventsTracking(theme, ['changed']);
+
+  return theme;
+}
+
+/**
+ * HOC which passes ThemeParams SDK component to wrapped React component.
+ * @param Component - component to wrap.
+ */
+export function withThemeParams<P extends { themeParams?: ThemeParams }>(
+  Component: ComponentType<P>,
+): ComponentType<Omit<P, 'themeParams'>> {
+  return function WithThemeParams(props: Omit<P, 'themeParams'>) {
+    const p = { ...props, themeParams: useThemeParams() } as P;
+
+    return <Component {...p} />;
+  };
+}

package/src/lib/viewport/index.ts

@@ -1,3 +1,3 @@
-export * from './types.js';
-export * from './useViewport.js';
-export * from './withViewport.js';
+export * from './types.js';
+export * from './useViewport.js';
+export * from './withViewport.js';

package/src/lib/viewport/types.ts

@@ -1 +1 @@
-export type { Viewport } from '@tma.js/sdk';
+export type { Viewport } from '@tma.js/sdk';

package/src/lib/viewport/useViewport.ts

@@ -1,15 +1,15 @@
-import { useUnit } from '../../provider/index.js';
-import { useEventsTracking } from '../hooks.js';
-import type { Viewport } from './types.js';
-
-/**
- * Returns Viewport component instance.
- */
-export function useViewport(): Viewport {
-  const viewport = useUnit('viewport');
-  useEventsTracking(viewport, [
-    'stableHeightChanged', 'isExpandedChanged', 'heightChanged', 'widthChanged',
-  ]);
-
-  return viewport;
-}
+import { useUnit } from '../../provider/index.js';
+import { useEventsTracking } from '../hooks.js';
+import type { Viewport } from './types.js';
+
+/**
+ * Returns Viewport component instance.
+ */
+export function useViewport(): Viewport {
+  const viewport = useUnit('viewport');
+  useEventsTracking(viewport, [
+    'stableHeightChanged', 'isExpandedChanged', 'heightChanged', 'widthChanged',
+  ]);
+
+  return viewport;
+}

package/src/lib/viewport/withViewport.tsx

@@ -1,18 +1,18 @@
-import React, { type ComponentType } from 'react';
-
-import { useViewport } from './useViewport.js';
-import type { Viewport } from './types.js';
-
-/**
- * HOC which passes Viewport SDK component to wrapped React component.
- * @param Component - component to wrap.
- */
-export function withViewport<P extends { viewport?: Viewport }>(
-  Component: ComponentType<P>,
-): ComponentType<Omit<P, 'viewport'>> {
-  return function WithViewport(props: Omit<P, 'viewport'>) {
-    const p = { ...props, viewport: useViewport() } as P;
-
-    return <Component {...p} />;
-  };
-}
+import React, { type ComponentType } from 'react';
+
+import { useViewport } from './useViewport.js';
+import type { Viewport } from './types.js';
+
+/**
+ * HOC which passes Viewport SDK component to wrapped React component.
+ * @param Component - component to wrap.
+ */
+export function withViewport<P extends { viewport?: Viewport }>(
+  Component: ComponentType<P>,
+): ComponentType<Omit<P, 'viewport'>> {
+  return function WithViewport(props: Omit<P, 'viewport'>) {
+    const p = { ...props, viewport: useViewport() } as P;
+
+    return <Component {...p} />;
+  };
+}

package/src/lib/web-app/index.ts

@@ -1,3 +1,3 @@
-export * from './types.js';
-export * from './useWebApp.js';
-export * from './withWebApp.js';
+export * from './types.js';
+export * from './useWebApp.js';
+export * from './withWebApp.js';

package/src/lib/web-app/types.ts

@@ -1 +1 @@
-export type { WebApp } from '@tma.js/sdk';
+export type { WebApp } from '@tma.js/sdk';

package/src/lib/web-app/useWebApp.ts

@@ -1,13 +1,13 @@
-import { useUnit } from '../../provider/index.js';
-import type { WebApp } from './types.js';
-import { useEventsTracking } from '../hooks.js';
-
-/**
- * Returns WebApp component instance.
- */
-export function useWebApp(): WebApp {
-  const webApp = useUnit('webApp');
-  useEventsTracking(webApp, ['headerColorChanged', 'backgroundColorChanged']);
-
-  return webApp;
-}
+import { useUnit } from '../../provider/index.js';
+import type { WebApp } from './types.js';
+import { useEventsTracking } from '../hooks.js';
+
+/**
+ * Returns WebApp component instance.
+ */
+export function useWebApp(): WebApp {
+  const webApp = useUnit('webApp');
+  useEventsTracking(webApp, ['headerColorChanged', 'backgroundColorChanged']);
+
+  return webApp;
+}

package/src/lib/web-app/withWebApp.tsx

@@ -1,18 +1,18 @@
-import React, { type ComponentType } from 'react';
-
-import { useWebApp } from './useWebApp.js';
-import type { WebApp } from './types.js';
-
-/**
- * HOC which passes WebApp SDK component to wrapped React component.
- * @param Component - component to wrap.
- */
-export function withWebApp<P extends { webApp?: WebApp }>(
-  Component: ComponentType<P>,
-): ComponentType<Omit<P, 'webApp'>> {
-  return function WithWebApp(props: Omit<P, 'webApp'>) {
-    const p = { ...props, webApp: useWebApp() } as P;
-
-    return <Component {...p} />;
-  };
-}
+import React, { type ComponentType } from 'react';
+
+import { useWebApp } from './useWebApp.js';
+import type { WebApp } from './types.js';
+
+/**
+ * HOC which passes WebApp SDK component to wrapped React component.
+ * @param Component - component to wrap.
+ */
+export function withWebApp<P extends { webApp?: WebApp }>(
+  Component: ComponentType<P>,
+): ComponentType<Omit<P, 'webApp'>> {
+  return function WithWebApp(props: Omit<P, 'webApp'>) {
+    const p = { ...props, webApp: useWebApp() } as P;
+
+    return <Component {...p} />;
+  };
+}

package/src/provider/SDKProvider.tsx

@@ -1,47 +1,47 @@
-import React, {
-  memo,
-  useEffect,
-  useMemo,
-  useState,
-  type PropsWithChildren,
-} from 'react';
-import { init, type InitOptions } from '@tma.js/sdk';
-
-import { sdkContext } from './context.js';
-import type { SDKComponents, SDKContext } from './types.js';
-
-export type SDKInitOptions = InitOptions;
-
-export type SDKProviderProps = PropsWithChildren<{ initOptions?: SDKInitOptions }>;
-
-/**
- * Component which provides access to SDK components.
- */
-export const SDKProvider = memo<SDKProviderProps>((props) => {
-  const { children, initOptions } = props;
-  const [didInit, setDidInit] = useState(false);
-  const [error, setError] = useState<null | unknown>(null);
-  const [components, setComponents] = useState<SDKComponents | null>(null);
-
-  // Initialize SDK on DOM attach.
-  useEffect(() => {
-    // Update init status.
-    setDidInit(true);
-
-    // Init SDK.
-    init(initOptions)
-      .then(setComponents)
-      .catch(setError);
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, []);
-
-  const context = useMemo<SDKContext>(() => ({
-    components,
-    didInit,
-    error,
-  }), [didInit, components, error]);
-
-  return <sdkContext.Provider value={context}>{children}</sdkContext.Provider>;
-});
-
-SDKProvider.displayName = 'SDKProvider';
+import React, {
+  memo,
+  useEffect,
+  useMemo,
+  useState,
+  type PropsWithChildren,
+} from 'react';
+import { init, type InitOptions } from '@tma.js/sdk';
+
+import { sdkContext } from './context.js';
+import type { SDKComponents, SDKContext } from './types.js';
+
+export type SDKInitOptions = InitOptions;
+
+export type SDKProviderProps = PropsWithChildren<{ initOptions?: SDKInitOptions }>;
+
+/**
+ * Component which provides access to SDK components.
+ */
+export const SDKProvider = memo<SDKProviderProps>((props) => {
+  const { children, initOptions } = props;
+  const [didInit, setDidInit] = useState(false);
+  const [error, setError] = useState<null | unknown>(null);
+  const [components, setComponents] = useState<SDKComponents | null>(null);
+
+  // Initialize SDK on DOM attach.
+  useEffect(() => {
+    // Update init status.
+    setDidInit(true);
+
+    // Init SDK.
+    init(initOptions)
+      .then(setComponents)
+      .catch(setError);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  const context = useMemo<SDKContext>(() => ({
+    components,
+    didInit,
+    error,
+  }), [didInit, components, error]);
+
+  return <sdkContext.Provider value={context}>{children}</sdkContext.Provider>;
+});
+
+SDKProvider.displayName = 'SDKProvider';

package/src/provider/context.ts

@@ -1,11 +1,11 @@
-import { createContext } from 'react';
-
-import type { SDKContext } from './types.js';
-
-export const sdkContext = createContext<SDKContext>({
-  components: null,
-  didInit: false,
-  error: null,
-});
-
-sdkContext.displayName = 'SDKContext';
+import { createContext } from 'react';
+
+import type { SDKContext } from './types.js';
+
+export const sdkContext = createContext<SDKContext>({
+  components: null,
+  didInit: false,
+  error: null,
+});
+
+sdkContext.displayName = 'SDKContext';

package/src/provider/hocs.tsx

@@ -1,18 +1,18 @@
-import React, { type ComponentType } from 'react';
-
-import type { SDKContext } from './types.js';
-import { useSDK } from './hooks.js';
-
-/**
- * HOC which passes SDK context to wrapped React component.
- * @param Component - component to wrap.
- */
-export function withSDK<P extends { sdk?: SDKContext }>(
-  Component: ComponentType<P>,
-): ComponentType<Omit<P, 'sdk'>> {
-  return function WithLaunchParams(props: Omit<P, 'sdk'>) {
-    const p = { ...props, sdk: useSDK() } as P;
-
-    return <Component {...p} />;
-  };
-}
+import React, { type ComponentType } from 'react';
+
+import type { SDKContext } from './types.js';
+import { useSDK } from './hooks.js';
+
+/**
+ * HOC which passes SDK context to wrapped React component.
+ * @param Component - component to wrap.
+ */
+export function withSDK<P extends { sdk?: SDKContext }>(
+  Component: ComponentType<P>,
+): ComponentType<Omit<P, 'sdk'>> {
+  return function WithLaunchParams(props: Omit<P, 'sdk'>) {
+    const p = { ...props, sdk: useSDK() } as P;
+
+    return <Component {...p} />;
+  };
+}

package/src/provider/hooks.ts

@@ -1,23 +1,23 @@
-import { useContext } from 'react';
-
-import { sdkContext } from './context.js';
-import type { SDKComponent, SDKComponentName } from './types.js';
-
-/**
- * Returns current SDK information.
- */
-export const useSDK = () => useContext(sdkContext);
-
-/**
- * Returns value by its field name from SDK init result.
- * @param name - component name.
- * @throws {Error} SDK is not initialized.
- */
-export function useUnit<N extends SDKComponentName>(name: N): SDKComponent<N> {
-  const { components } = useSDK();
-
-  if (components === null) {
-    throw new Error(`Unable to get unit "${name}" as long as SDK is not initialized.`);
-  }
-  return components[name];
-}
+import { useContext } from 'react';
+
+import { sdkContext } from './context.js';
+import type { SDKComponent, SDKComponentName } from './types.js';
+
+/**
+ * Returns current SDK information.
+ */
+export const useSDK = () => useContext(sdkContext);
+
+/**
+ * Returns value by its field name from SDK init result.
+ * @param name - component name.
+ * @throws {Error} SDK is not initialized.
+ */
+export function useUnit<N extends SDKComponentName>(name: N): SDKComponent<N> {
+  const { components } = useSDK();
+
+  if (components === null) {
+    throw new Error(`Unable to get unit "${name}" as long as SDK is not initialized.`);
+  }
+  return components[name];
+}

package/src/provider/index.ts

@@ -1,5 +1,5 @@
-export * from './context.js';
-export * from './hocs.js';
-export * from './hooks.js';
-export * from './SDKProvider.js';
-export * from './types.js';
+export * from './context.js';
+export * from './hocs.js';
+export * from './hooks.js';
+export * from './SDKProvider.js';
+export * from './types.js';

package/src/provider/types.ts

@@ -1,34 +1,34 @@
-import type { InitResult } from '@tma.js/sdk';
-
-/**
- * List of provided SDK components.
- */
-export type SDKComponents = InitResult;
-
-/**
- * Known SDK component name.
- */
-export type SDKComponentName = keyof SDKComponents;
-
-/**
- * Returns SDK component type by its name.
- */
-export type SDKComponent<N extends SDKComponentName> = SDKComponents[N];
-
-export interface SDKContext {
-  /**
-   * Components ready to use. This value will be null until initialization
-   * is done.
-   */
-  components: SDKComponents | null;
-
-  /**
-   * States, that SDK called `init()` method.
-   */
-  didInit: boolean;
-
-  /**
-   * Error occurred during initialization.
-   */
-  error: unknown | null;
-}
+import type { InitResult } from '@tma.js/sdk';
+
+/**
+ * List of provided SDK components.
+ */
+export type SDKComponents = InitResult;
+
+/**
+ * Known SDK component name.
+ */
+export type SDKComponentName = keyof SDKComponents;
+
+/**
+ * Returns SDK component type by its name.
+ */
+export type SDKComponent<N extends SDKComponentName> = SDKComponents[N];
+
+export interface SDKContext {
+  /**
+   * Components ready to use. This value will be null until initialization
+   * is done.
+   */
+  components: SDKComponents | null;
+
+  /**
+   * States, that SDK called `init()` method.
+   */
+  didInit: boolean;
+
+  /**
+   * Error occurred during initialization.
+   */
+  error: unknown | null;
+}