@serhii.olishevskyi/docs 1.0.1 → 1.0.2

package/dist/index.d.mts

@@ -1,9 +1,34 @@
-import * as React from 'react';
+import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
-import { TextFieldProps, Theme } from '@mui/material';
+import { TextFieldProps, TooltipProps, Theme } from '@mui/material';
 import { SupabaseClient } from '@supabase/supabase-js';
 
-type TextfieldComponentProps = TextFieldProps & {
+interface UrlValue {
+    url: string;
+    title?: string;
+}
+interface UrlComponentProps {
+    overrideNamespace?: string;
+    label: string;
+    value: UrlValue | string;
+    onChange?: (value: UrlValue) => void;
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    error?: boolean;
+    helperText?: string;
+    description?: string;
+    fullWidth?: boolean;
+    openInNewTab?: boolean;
+    showLock?: boolean;
+    lockTooltip?: string;
+    sx?: any;
+}
+declare function UrlComponent({ overrideNamespace, label, value, onChange, disabled, readOnly, required, error, helperText, description, fullWidth, openInNewTab, showLock, lockTooltip, sx, }: UrlComponentProps): React__default.JSX.Element;
+
+type TextFieldComponentProps = TextFieldProps & {
+    overrideNamespace?: string;
+    label?: ReactNode;
     copyTooltip?: string;
     copiedTooltip?: string;
     clearTooltip?: string;
@@ -13,7 +38,8 @@ type TextfieldComponentProps = TextFieldProps & {
     disableClearButton?: boolean;
 };
 
-type NumberInputComponentProps = Omit<TextfieldComponentProps, 'onChange' | 'type'> & {
+type NumberInputComponentProps = Omit<TextFieldComponentProps, 'onChange' | 'type'> & {
+    overrideNamespace?: string;
     value: number | string | null | undefined;
     onChange?: (value: number | null, stringValue: string) => void;
     allowNegative?: boolean;
@@ -27,13 +53,93 @@ type NumberInputComponentProps = Omit<TextfieldComponentProps, 'onChange' | 'typ
     highlightNegative?: boolean;
 };
 
-declare const CardForm: {
+type EmailInputComponentProps = Omit<TextFieldComponentProps, 'type'> & {
+    /**
+     * Текст ошибки валидации (ключ для перевода или обычная строка)
+     * @default 'Invalid email address'
+     */
+    invalidEmailError?: string;
+    /**
+     * Отключает внутреннюю валидацию (если нужно использовать внешний контроллер валидации)
+     */
+    disableValidation?: boolean;
+    /**
+     * Колбэк для передачи состояния валидности родительскому компоненту
+     */
+    onValidationChange?: (isValid: boolean) => void;
+};
+
+interface TranslatableTooltipComponentProps extends Omit<TooltipProps, 'children'> {
+    overrideNamespace?: string;
+    disableSpan?: boolean;
+    children: React__default.ReactElement;
+}
+
+declare const UI: {
     Inputs: {
-        TextField: React.FC<TextfieldComponentProps>;
-        NumberField: React.FC<NumberInputComponentProps>;
+        TextField: React$1.FC<TextFieldComponentProps>;
+        NumberField: React$1.FC<NumberInputComponentProps>;
+        EmailField: React$1.FC<EmailInputComponentProps>;
+        Url: typeof UrlComponent;
+    };
+    DataDisplay: {
+        TranslatableTooltip: React$1.FC<TranslatableTooltipComponentProps>;
     };
 };
 
+type AIProviderType = 'gemini' | 'openai';
+interface AIGenerateOptions {
+    prompt: string;
+    systemInstruction?: string;
+    jsonMode?: boolean;
+    temperature?: number;
+}
+interface AIConfig {
+    apiKey?: string;
+    provider?: AIProviderType;
+    modelName?: string;
+}
+interface AIContextType {
+    apiKey?: string;
+    provider: AIProviderType;
+    modelName: string;
+    /** Универсальный метод генерации (текст или JSON) */
+    generate: <T = string>(options: AIGenerateOptions) => Promise<T | null>;
+}
+interface AIProviderProps {
+    children: React__default.ReactNode;
+    config?: AIConfig;
+    apiKey?: string;
+}
+declare const AIProvider: React__default.FC<AIProviderProps>;
+declare const useAI: () => AIContextType;
+
+type DialogSeverity = 'error' | 'warning' | 'info' | 'success';
+type ConfirmResult = 'yes' | 'no' | 'cancel';
+interface ConfirmOptions {
+    title?: ReactNode;
+    message: ReactNode;
+    type?: DialogSeverity;
+    showNoButton?: boolean;
+    showCancelButton?: boolean;
+    confirmText?: ReactNode;
+    noText?: ReactNode;
+    cancelText?: ReactNode;
+    confirmColor?: 'primary' | 'secondary' | 'error' | 'warning' | 'info' | 'success';
+}
+interface ConfirmationProviderProps {
+    children: ReactNode;
+}
+declare const ConfirmationProvider: React__default.FC<ConfirmationProviderProps>;
+declare const useConfirmation: () => ((options: ConfirmOptions) => Promise<ConfirmResult>);
+
+interface TranslateProviderProps {
+    namespace: string;
+    children: React__default.ReactNode;
+}
+declare const TranslateProvider: React__default.FC<TranslateProviderProps>;
+declare const useTranslationNamespace: (overrideNamespace?: string) => string;
+
 interface SupabaseConfig {
     url: string;
     anonKey: string;
@@ -49,14 +155,8 @@ declare const SupabaseProvider: React__default.FC<SupabaseProviderProps>;
 /** Хук для доступа к Supabase из любого компонента */
 declare const useSupabase: () => SupabaseClient;
 
-interface TranslateProviderProps {
-    namespace: string;
-    children: React__default.ReactNode;
-}
-declare const TranslateProvider: React__default.FC<TranslateProviderProps>;
-declare const useTranslationNamespace: (overrideNamespace?: string) => string;
-
 interface TranslateTextProps {
+    overrideNamespace?: string;
     children: string;
     values?: Record<string, any>;
 }
@@ -173,50 +273,26 @@ declare const ToastProvider: React__default.FC<{
 }>;
 declare const useToast: () => ToastContextType;
 
-type DialogSeverity = 'error' | 'warning' | 'info' | 'success';
-type ConfirmResult = 'yes' | 'no' | 'cancel';
-interface ConfirmOptions {
-    title?: ReactNode;
-    message: ReactNode;
-    type?: DialogSeverity;
-    showNoButton?: boolean;
-    showCancelButton?: boolean;
-    confirmText?: ReactNode;
-    noText?: ReactNode;
-    cancelText?: ReactNode;
-    confirmColor?: 'primary' | 'secondary' | 'error' | 'warning' | 'info' | 'success';
-}
-interface ConfirmationProviderProps {
-    children: ReactNode;
-}
-declare const ConfirmationProvider: React__default.FC<ConfirmationProviderProps>;
-declare const useConfirmation: () => ((options: ConfirmOptions) => Promise<ConfirmResult>);
-
-type AIProviderType = 'gemini' | 'openai';
-interface AIGenerateOptions {
-    prompt: string;
-    systemInstruction?: string;
-    jsonMode?: boolean;
-    temperature?: number;
-}
-interface AIConfig {
-    apiKey?: string;
-    provider?: AIProviderType;
-    modelName?: string;
-}
-interface AIContextType {
-    apiKey?: string;
-    provider: AIProviderType;
-    modelName: string;
-    /** Универсальный метод генерации (текст или JSON) */
-    generate: <T = string>(options: AIGenerateOptions) => Promise<T | null>;
-}
-interface AIProviderProps {
-    children: React__default.ReactNode;
-    config?: AIConfig;
-    apiKey?: string;
-}
-declare const AIProvider: React__default.FC<AIProviderProps>;
-declare const useAI: () => AIContextType;
+declare const Providers: {
+    readonly Supabase: React$1.FC<SupabaseProviderProps>;
+    readonly Translate: React$1.FC<TranslateProviderProps>;
+    readonly TranslationEdit: React$1.FC<{
+        children: React.ReactNode;
+    }>;
+    readonly Localization: React$1.FC<{
+        children: React$1.ReactNode;
+    }>;
+    readonly Theme: React$1.FC<{
+        children: React.ReactNode;
+    }>;
+    readonly Breadcrumb: React$1.FC<{
+        children: React.ReactNode;
+    }>;
+    readonly Toast: React$1.FC<{
+        children: React.ReactNode;
+    }>;
+    readonly Confirmation: React$1.FC<ConfirmationProviderProps>;
+    readonly AI: React$1.FC<AIProviderProps>;
+};
 
-export { type AIConfig, type AIGenerateOptions, AIProvider, type AIProviderProps, type AIProviderType, BreadcrumbProvider, CardForm, type ConfirmOptions, type ConfirmResult, ConfirmationProvider, type ConfirmationProviderProps, type DialogSeverity, type DisplayState, type Language, LocalizationProvider, type NumberInputComponentProps, type SupabaseConfig, SupabaseProvider, type SupabaseProviderProps, type TextfieldComponentProps, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, ToastProvider, type ToastType, TranslateProvider, TranslateText, TranslationEditProvider, type TypographyConfig, useAI, useAppTheme, useBreadcrumb, useConfirmation, useLocalization, useSupabase, useToast, useTranslationEdit, useTranslationNamespace };
+export { type AIConfig, type AIGenerateOptions, AIProvider, type AIProviderProps, type AIProviderType, BreadcrumbProvider, type ConfirmOptions, type ConfirmResult, ConfirmationProvider, type ConfirmationProviderProps, type DialogSeverity, type DisplayState, type EmailInputComponentProps as EmailInputProps, type Language, LocalizationProvider, type NumberInputComponentProps as NumberInputProps, Providers, type SupabaseConfig, SupabaseProvider, type SupabaseProviderProps, type TextFieldComponentProps as TextFieldProps, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, ToastProvider, type ToastType, type TranslatableTooltipComponentProps as TranslatableTooltipProps, TranslateProvider, TranslateText, TranslationEditProvider, type TypographyConfig, UI, type UrlComponentProps as UrlProps, useAI, useAppTheme, useBreadcrumb, useConfirmation, useLocalization, useSupabase, useToast, useTranslationEdit, useTranslationNamespace };

package/dist/index.d.ts

@@ -1,9 +1,34 @@
-import * as React from 'react';
+import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
-import { TextFieldProps, Theme } from '@mui/material';
+import { TextFieldProps, TooltipProps, Theme } from '@mui/material';
 import { SupabaseClient } from '@supabase/supabase-js';
 
-type TextfieldComponentProps = TextFieldProps & {
+interface UrlValue {
+    url: string;
+    title?: string;
+}
+interface UrlComponentProps {
+    overrideNamespace?: string;
+    label: string;
+    value: UrlValue | string;
+    onChange?: (value: UrlValue) => void;
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    error?: boolean;
+    helperText?: string;
+    description?: string;
+    fullWidth?: boolean;
+    openInNewTab?: boolean;
+    showLock?: boolean;
+    lockTooltip?: string;
+    sx?: any;
+}
+declare function UrlComponent({ overrideNamespace, label, value, onChange, disabled, readOnly, required, error, helperText, description, fullWidth, openInNewTab, showLock, lockTooltip, sx, }: UrlComponentProps): React__default.JSX.Element;
+
+type TextFieldComponentProps = TextFieldProps & {
+    overrideNamespace?: string;
+    label?: ReactNode;
     copyTooltip?: string;
     copiedTooltip?: string;
     clearTooltip?: string;
@@ -13,7 +38,8 @@ type TextfieldComponentProps = TextFieldProps & {
     disableClearButton?: boolean;
 };
 
-type NumberInputComponentProps = Omit<TextfieldComponentProps, 'onChange' | 'type'> & {
+type NumberInputComponentProps = Omit<TextFieldComponentProps, 'onChange' | 'type'> & {
+    overrideNamespace?: string;
     value: number | string | null | undefined;
     onChange?: (value: number | null, stringValue: string) => void;
     allowNegative?: boolean;
@@ -27,13 +53,93 @@ type NumberInputComponentProps = Omit<TextfieldComponentProps, 'onChange' | 'typ
     highlightNegative?: boolean;
 };
 
-declare const CardForm: {
+type EmailInputComponentProps = Omit<TextFieldComponentProps, 'type'> & {
+    /**
+     * Текст ошибки валидации (ключ для перевода или обычная строка)
+     * @default 'Invalid email address'
+     */
+    invalidEmailError?: string;
+    /**
+     * Отключает внутреннюю валидацию (если нужно использовать внешний контроллер валидации)
+     */
+    disableValidation?: boolean;
+    /**
+     * Колбэк для передачи состояния валидности родительскому компоненту
+     */
+    onValidationChange?: (isValid: boolean) => void;
+};
+
+interface TranslatableTooltipComponentProps extends Omit<TooltipProps, 'children'> {
+    overrideNamespace?: string;
+    disableSpan?: boolean;
+    children: React__default.ReactElement;
+}
+
+declare const UI: {
     Inputs: {
-        TextField: React.FC<TextfieldComponentProps>;
-        NumberField: React.FC<NumberInputComponentProps>;
+        TextField: React$1.FC<TextFieldComponentProps>;
+        NumberField: React$1.FC<NumberInputComponentProps>;
+        EmailField: React$1.FC<EmailInputComponentProps>;
+        Url: typeof UrlComponent;
+    };
+    DataDisplay: {
+        TranslatableTooltip: React$1.FC<TranslatableTooltipComponentProps>;
     };
 };
 
+type AIProviderType = 'gemini' | 'openai';
+interface AIGenerateOptions {
+    prompt: string;
+    systemInstruction?: string;
+    jsonMode?: boolean;
+    temperature?: number;
+}
+interface AIConfig {
+    apiKey?: string;
+    provider?: AIProviderType;
+    modelName?: string;
+}
+interface AIContextType {
+    apiKey?: string;
+    provider: AIProviderType;
+    modelName: string;
+    /** Универсальный метод генерации (текст или JSON) */
+    generate: <T = string>(options: AIGenerateOptions) => Promise<T | null>;
+}
+interface AIProviderProps {
+    children: React__default.ReactNode;
+    config?: AIConfig;
+    apiKey?: string;
+}
+declare const AIProvider: React__default.FC<AIProviderProps>;
+declare const useAI: () => AIContextType;
+
+type DialogSeverity = 'error' | 'warning' | 'info' | 'success';
+type ConfirmResult = 'yes' | 'no' | 'cancel';
+interface ConfirmOptions {
+    title?: ReactNode;
+    message: ReactNode;
+    type?: DialogSeverity;
+    showNoButton?: boolean;
+    showCancelButton?: boolean;
+    confirmText?: ReactNode;
+    noText?: ReactNode;
+    cancelText?: ReactNode;
+    confirmColor?: 'primary' | 'secondary' | 'error' | 'warning' | 'info' | 'success';
+}
+interface ConfirmationProviderProps {
+    children: ReactNode;
+}
+declare const ConfirmationProvider: React__default.FC<ConfirmationProviderProps>;
+declare const useConfirmation: () => ((options: ConfirmOptions) => Promise<ConfirmResult>);
+
+interface TranslateProviderProps {
+    namespace: string;
+    children: React__default.ReactNode;
+}
+declare const TranslateProvider: React__default.FC<TranslateProviderProps>;
+declare const useTranslationNamespace: (overrideNamespace?: string) => string;
+
 interface SupabaseConfig {
     url: string;
     anonKey: string;
@@ -49,14 +155,8 @@ declare const SupabaseProvider: React__default.FC<SupabaseProviderProps>;
 /** Хук для доступа к Supabase из любого компонента */
 declare const useSupabase: () => SupabaseClient;
 
-interface TranslateProviderProps {
-    namespace: string;
-    children: React__default.ReactNode;
-}
-declare const TranslateProvider: React__default.FC<TranslateProviderProps>;
-declare const useTranslationNamespace: (overrideNamespace?: string) => string;
-
 interface TranslateTextProps {
+    overrideNamespace?: string;
     children: string;
     values?: Record<string, any>;
 }
@@ -173,50 +273,26 @@ declare const ToastProvider: React__default.FC<{
 }>;
 declare const useToast: () => ToastContextType;
 
-type DialogSeverity = 'error' | 'warning' | 'info' | 'success';
-type ConfirmResult = 'yes' | 'no' | 'cancel';
-interface ConfirmOptions {
-    title?: ReactNode;
-    message: ReactNode;
-    type?: DialogSeverity;
-    showNoButton?: boolean;
-    showCancelButton?: boolean;
-    confirmText?: ReactNode;
-    noText?: ReactNode;
-    cancelText?: ReactNode;
-    confirmColor?: 'primary' | 'secondary' | 'error' | 'warning' | 'info' | 'success';
-}
-interface ConfirmationProviderProps {
-    children: ReactNode;
-}
-declare const ConfirmationProvider: React__default.FC<ConfirmationProviderProps>;
-declare const useConfirmation: () => ((options: ConfirmOptions) => Promise<ConfirmResult>);
-
-type AIProviderType = 'gemini' | 'openai';
-interface AIGenerateOptions {
-    prompt: string;
-    systemInstruction?: string;
-    jsonMode?: boolean;
-    temperature?: number;
-}
-interface AIConfig {
-    apiKey?: string;
-    provider?: AIProviderType;
-    modelName?: string;
-}
-interface AIContextType {
-    apiKey?: string;
-    provider: AIProviderType;
-    modelName: string;
-    /** Универсальный метод генерации (текст или JSON) */
-    generate: <T = string>(options: AIGenerateOptions) => Promise<T | null>;
-}
-interface AIProviderProps {
-    children: React__default.ReactNode;
-    config?: AIConfig;
-    apiKey?: string;
-}
-declare const AIProvider: React__default.FC<AIProviderProps>;
-declare const useAI: () => AIContextType;
+declare const Providers: {
+    readonly Supabase: React$1.FC<SupabaseProviderProps>;
+    readonly Translate: React$1.FC<TranslateProviderProps>;
+    readonly TranslationEdit: React$1.FC<{
+        children: React.ReactNode;
+    }>;
+    readonly Localization: React$1.FC<{
+        children: React$1.ReactNode;
+    }>;
+    readonly Theme: React$1.FC<{
+        children: React.ReactNode;
+    }>;
+    readonly Breadcrumb: React$1.FC<{
+        children: React.ReactNode;
+    }>;
+    readonly Toast: React$1.FC<{
+        children: React.ReactNode;
+    }>;
+    readonly Confirmation: React$1.FC<ConfirmationProviderProps>;
+    readonly AI: React$1.FC<AIProviderProps>;
+};
 
-export { type AIConfig, type AIGenerateOptions, AIProvider, type AIProviderProps, type AIProviderType, BreadcrumbProvider, CardForm, type ConfirmOptions, type ConfirmResult, ConfirmationProvider, type ConfirmationProviderProps, type DialogSeverity, type DisplayState, type Language, LocalizationProvider, type NumberInputComponentProps, type SupabaseConfig, SupabaseProvider, type SupabaseProviderProps, type TextfieldComponentProps, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, ToastProvider, type ToastType, TranslateProvider, TranslateText, TranslationEditProvider, type TypographyConfig, useAI, useAppTheme, useBreadcrumb, useConfirmation, useLocalization, useSupabase, useToast, useTranslationEdit, useTranslationNamespace };
+export { type AIConfig, type AIGenerateOptions, AIProvider, type AIProviderProps, type AIProviderType, BreadcrumbProvider, type ConfirmOptions, type ConfirmResult, ConfirmationProvider, type ConfirmationProviderProps, type DialogSeverity, type DisplayState, type EmailInputComponentProps as EmailInputProps, type Language, LocalizationProvider, type NumberInputComponentProps as NumberInputProps, Providers, type SupabaseConfig, SupabaseProvider, type SupabaseProviderProps, type TextFieldComponentProps as TextFieldProps, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, ToastProvider, type ToastType, type TranslatableTooltipComponentProps as TranslatableTooltipProps, TranslateProvider, TranslateText, TranslationEditProvider, type TypographyConfig, UI, type UrlComponentProps as UrlProps, useAI, useAppTheme, useBreadcrumb, useConfirmation, useLocalization, useSupabase, useToast, useTranslationEdit, useTranslationNamespace };