@weavix/sdk-react 0.0.1

package/README.md

@@ -0,0 +1,45 @@
+# @weavix/sdk-react
+
+React hooks and components for the Tracker Plugin SDK — Weavix flavor.
+
+> Это external-публикация. Внутренний (Yandex) аналог: `@yandex-data-ui/tracker-plugin-sdk-react`.
+
+## Установка
+
+```bash
+npm install @weavix/sdk-react @weavix/sdk-core @weavix/tracker-api-types react
+# или
+pnpm add @weavix/sdk-react @weavix/sdk-core @weavix/tracker-api-types react
+```
+
+## Что внутри
+
+- `<TrackerPluginProvider>` — провайдер инициализирует плагин.
+- `useTrackerPluginContext()` — реактивные значения (theme, language, slot, slotContext) и `registerHandler`.
+- `useTheme()`, `useLanguage()`, `useUserId()`, `useIsYateam()` — реактивные хуки.
+- `useToaster()`, `useConfirm()` — UI-методы.
+- `useLocalizedString()`, `useContext()` — вспомогательные.
+- `<PluginError>`, `<PluginLoader>` — компоненты для fallback'ов.
+
+API surface идентичен internal flavor'у.
+
+## Пример
+
+```tsx
+import { TrackerPluginProvider, useToaster } from '@weavix/sdk-react';
+
+function App() {
+    const toaster = useToaster();
+    return <button onClick={() => toaster.add({ title: 'Hi' })}>Toast</button>;
+}
+
+root.render(
+    <TrackerPluginProvider>
+        <App />
+    </TrackerPluginProvider>
+);
+```
+
+## License
+
+UNLICENSED.

package/dist/index.d.ts

@@ -0,0 +1,265 @@
+import { ConfirmOptions } from '@weavix/sdk-core';
+import { ConfirmResult } from '@weavix/sdk-core';
+import { ContentSizeUpdateRequest } from '@weavix/sdk-core';
+import type { FC } from 'react';
+import { GetDataResultMap } from '@weavix/sdk-core';
+import { getField } from '@weavix/sdk-core';
+import { getLocalizedString } from '@weavix/sdk-core';
+import { HandlerFunction } from '@weavix/sdk-core';
+import { Handlers } from '@weavix/sdk-core';
+import { hostApi } from '@weavix/sdk-core';
+import { HostEventCallback } from '@weavix/sdk-core';
+import { HostEventContract } from '@weavix/sdk-core';
+import { HostEventMethod } from '@weavix/sdk-core';
+import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { LocalizedString } from '@weavix/sdk-core';
+import { METHOD_NOT_SUPPORTED } from '@weavix/sdk-core';
+import { MISSING_REQUIRED_SCOPE } from '@weavix/sdk-core';
+import { PLUGIN_ID_IS_NOT_CORRECT } from '@weavix/sdk-core';
+import { PLUGIN_ID_OR_SLOT_NOT_PROVIDED } from '@weavix/sdk-core';
+import { PluginActionError } from '@weavix/sdk-core';
+import { ReactNode } from 'react';
+import { SlotContextMap } from '@weavix/sdk-core';
+import { Theme } from '@weavix/sdk-core';
+import { ToastAction } from '@weavix/sdk-core';
+import { ToastOptions } from '@weavix/sdk-core';
+import { TrackerApi } from '@weavix/sdk-core';
+import { trackerApi } from '@weavix/sdk-core';
+import { TrackerApiCallOptions } from '@weavix/sdk-core';
+import { TrackerApiInitOptions } from '@weavix/sdk-core';
+import { TrackerApiV3 } from '@weavix/sdk-core';
+import { TriggerActionData } from '@weavix/sdk-core';
+import { uiApi } from '@weavix/sdk-core';
+import { UNKNOWN_ERROR } from '@weavix/sdk-core';
+import { Unsubscribe } from '@weavix/sdk-core';
+import { VALIDATION_ERROR } from '@weavix/sdk-core';
+
+export { ConfirmOptions }
+
+declare type ConfirmOptions_2 = {
+    title?: string;
+    message: string;
+    textButtonApply?: string;
+    textButtonCancel?: string;
+    theme?: 'normal' | 'danger';
+};
+
+export { ConfirmResult }
+
+declare type ConfirmResult_2 = { confirmed: boolean };
+
+export { ContentSizeUpdateRequest }
+
+export { getField }
+
+export { getLocalizedString }
+
+export { hostApi }
+
+export { HostEventCallback }
+
+export { HostEventContract }
+
+export { HostEventMethod }
+
+export { LocalizedString }
+
+/**
+ * Структурный shape `LocalizedString` — общая база, к которой структурно
+ * совместимы api-types `LocalizedString` обоих flavors. Реальная функция
+ * `getLocalizedString` читает только ключи `ru` и `en`, поэтому более
+ * узкие api-types-варианты (с дополнительными ключами) совместимы.
+ */
+declare type LocalizedString_2 = string | { ru?: string; en?: string };
+
+export { METHOD_NOT_SUPPORTED }
+
+export { MISSING_REQUIRED_SCOPE }
+
+export { PLUGIN_ID_IS_NOT_CORRECT }
+
+export { PLUGIN_ID_OR_SLOT_NOT_PROVIDED }
+
+export { PluginActionError }
+
+/**
+ * Дефолтный компонент для отображения ошибки инициализации плагина
+ */
+export declare const PluginError = PluginErrorImpl as FC<PluginErrorProps>;
+
+export declare interface PluginErrorProps {
+    error: Error;
+}
+
+/**
+ * Простой лоадер для отображения во время инициализации плагина
+ */
+export declare const PluginLoader = PluginLoaderImpl as FC;
+
+/**
+ * Сигнатура registerHandler: для 'getData' тип handler зависит от слота (GetDataResultMap[TSlot]).
+ */
+export declare type RegisterHandlerFunction<TSlot extends keyof SlotContextMap> = <TKey extends keyof Handlers>(methodName: TKey, handler: TKey extends 'getData' ? TSlot extends keyof GetDataResultMap ? () => GetDataResultMap[TSlot] : never : HandlerFunction<TKey>) => void;
+
+export { SlotContextMap }
+
+export { Theme }
+
+export { ToastAction }
+
+declare type ToastAction_2 = {
+    label: string;
+    onClick: () => void;
+};
+
+export { ToastOptions }
+
+declare type ToastOptions_2 = {
+    name?: string;
+    title: string;
+    content?: string;
+    theme?: 'success' | 'danger' | 'warning' | 'info';
+    autoHiding?: number;
+    isClosable?: boolean;
+    actions?: ToastAction_2[];
+};
+
+export { TrackerApi }
+
+export { trackerApi }
+
+export { TrackerApiCallOptions }
+
+export { TrackerApiInitOptions }
+
+export { TrackerApiV3 }
+
+/**
+ * Стабильные данные контекста — не меняются после инициализации.
+ * Реактивные значения (theme, language, slotContext) доступны через useTrackerPluginContext().
+ */
+export declare interface TrackerPluginContextValue<TSlot extends keyof SlotContextMap = keyof SlotContextMap> {
+    /** Текущая тема хоста. Обновляется реактивно при получении theme.changed. */
+    theme: Theme | undefined;
+    /** Текущий язык хоста. Обновляется реактивно при получении language.changed. */
+    language: string | undefined;
+    /** Сервис, в котором открылся плагин. */
+    service: string;
+    /** Id пользователя. */
+    userId?: string;
+    /** Это ятим? */
+    isYateam?: boolean;
+    /** Origin родительского окна (хоста). */
+    origin: string;
+    /** Слот, в котором открыт плагин. */
+    slot: TSlot;
+    /** URL внутри плагина. */
+    innerUrl: string;
+    /** Query-параметры плагина */
+    queryParams: Record<string, string>;
+    /** Контекст страницы. Обновляется реактивно при получении context.changed. */
+    slotContext: SlotContextMap[TSlot] | undefined;
+    /** Регистрация обработчика для ответов на запросы хоста. */
+    registerHandler: RegisterHandlerFunction<TSlot>;
+}
+
+/**
+ * Провайдер для инициализации плагина Tracker.
+ * Оборачивает приложение и управляет жизненным циклом плагина.
+ *
+ * После инициализации тема, язык и контекст страницы доступны через
+ * `useTrackerPluginContext()` и обновляются реактивно при push-событиях от хоста.
+ * @example
+ * ```tsx
+ * root.render(
+ *   <TrackerPluginProvider>
+ *     <App />
+ *   </TrackerPluginProvider>
+ * );
+ * ```
+ */
+export declare function TrackerPluginProvider({ children, autoResize, fallback, errorFallback, autoNotifyReady, }: TrackerPluginProviderProps): JSX_2.Element;
+
+export declare interface TrackerPluginProviderProps {
+    children: ReactNode;
+    /**
+     * Автоматически изменять размер контейнера плагина при изменении содержимого
+     * @default true
+     */
+    autoResize?: boolean;
+    /**
+     * Компонент для отображения во время инициализации
+     * @default <PluginLoader />
+     */
+    fallback?: ReactNode;
+    /**
+     * Компонент для отображения при ошибке инициализации
+     * @default <PluginError error={error} />
+     */
+    errorFallback?: (error: Error) => ReactNode;
+    /**
+     * Автоматически уведомить хост о готовности плагина после инициализации
+     * @default true
+     */
+    autoNotifyReady?: boolean;
+}
+
+export { TriggerActionData }
+
+export { uiApi }
+
+export { UNKNOWN_ERROR }
+
+export { Unsubscribe }
+
+export declare const useConfirm = useConfirmImpl as () => UseConfirmReturn;
+
+declare type UseConfirmReturn = {
+    show: (options: ConfirmOptions_2) => Promise<ConfirmResult_2>;
+};
+
+/**
+ * Хук для получения локализованной строки на основе текущего языка из контекста.
+ */
+export declare const useLocalizedString = useLocalizedStringImpl as (
+fallbackLanguage?: string,
+) => (value: LocalizedString_2) => string;
+
+export declare const useToaster = useToasterImpl as () => UseToasterReturn;
+
+declare type UseToasterReturn = {
+    add: (options: ToastOptions_2) => Promise<{ name: string }>;
+};
+
+/**
+ * Хук для получения темы, языка, слота и контекста слота из TrackerPluginProvider.
+ *
+ * Все значения реактивны — обновляются автоматически при push-событиях от хоста:
+ * - `theme` — при `theme.changed`
+ * - `language` — при `language.changed`
+ * - `slotContext` — при `context.changed`
+ *
+ * Без generic — возвращает union; после проверки `slot === 'issue.action'` и т.п. сужается тип `slotContext`.
+ * С generic — сразу типизирует под один слот: `useTrackerPluginContext<'issue.action'>()`.
+ * @example
+ * ```tsx
+ * // Без generic — сужение через slot
+ * const { slot, slotContext, theme, language } = useTrackerPluginContext();
+ * if (slot === 'issue.action') {
+ *     // slotContext: Issue
+ * }
+ *
+ * // С generic — сразу типизировано
+ * const { slotContext } = useTrackerPluginContext<'issue.action'>();
+ * // slotContext: Issue | undefined
+ * ```
+ */
+export declare function useTrackerPluginContext(): {
+    [K in keyof SlotContextMap]: TrackerPluginContextValue<K>;
+}[keyof SlotContextMap];
+
+export declare function useTrackerPluginContext<TSlot extends keyof SlotContextMap>(): TrackerPluginContextValue<TSlot>;
+
+export { VALIDATION_ERROR }
+
+export { }