@serhii.olishevskyi/docs 1.2.1 → 1.2.3

package/dist/{UserPopoverComponent-FZF757NQ.mjs → UserPopoverComponent-K7CJNYYL.mjs}

@@ -1,7 +1,7 @@
 import {
   UserPopoverComponent,
   UserPopoverComponent_default
-} from "./chunk-FYNGJLO7.mjs";
+} from "./chunk-FRDK4RQX.mjs";
 export {
   UserPopoverComponent,
   UserPopoverComponent_default as default

package/dist/{chunk-FYNGJLO7.mjs → chunk-FRDK4RQX.mjs}

@@ -182,8 +182,28 @@ _SupabaseCacheBackend.type = "backend";
 _SupabaseCacheBackend.manifest = {};
 _SupabaseCacheBackend.isManifestLoaded = false;
 var SupabaseCacheBackend = _SupabaseCacheBackend;
+var customCacheBackend_default = SupabaseCacheBackend;
 
 // src/i18n/config.ts
+var initI18n = ({
+  supabase,
+  defaultLang = "uk",
+  fallbackLang = "en",
+  namespaces = ["common", "landing", "auth-widget", "form_components"]
+}) => {
+  if (!i18n.isInitialized) {
+    i18n.use(new customCacheBackend_default(supabase)).use(initReactI18next).init({
+      lng: defaultLang,
+      fallbackLng: fallbackLang,
+      ns: namespaces,
+      defaultNS: "common",
+      keySeparator: false,
+      nsSeparator: ":",
+      interpolation: { escapeValue: false }
+    });
+  }
+  return i18n;
+};
 var config_default = i18n;
 
 // src/context/AuthProvider.tsx
@@ -2546,6 +2566,7 @@ var UserPopoverComponent = ({
 var UserPopoverComponent_default = UserPopoverComponent;
 
 export {
+  initI18n,
   getDeviceId,
   fetchCompanySessions,
   trackUserSession,

package/dist/index.d.mts

@@ -1,8 +1,10 @@
 import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
 import { TextFieldProps, SelectProps, SelectChangeEvent, IconButtonProps, TooltipProps, SxProps, Theme, TypographyProps } from '@mui/material';
+import { SystemProps } from '@mui/system';
 import * as _supabase_supabase_js from '@supabase/supabase-js';
 import { SupabaseClient, User, Session } from '@supabase/supabase-js';
+import * as i18next from 'i18next';
 
 interface UrlValue {
     url: string;
@@ -302,6 +304,25 @@ interface ExpandableNoteComponentProps extends Omit<TypographyProps, 'children'>
     label?: React__default.ReactNode;
 }
 
+interface PageLink {
+    text: ReactNode;
+    href?: string;
+    external?: boolean;
+    onClick?: React__default.MouseEventHandler<HTMLButtonElement> | undefined;
+    hidden?: boolean;
+}
+interface PageLinkWidgetProps {
+    overrideNamespace?: string;
+    title: ReactNode;
+    subheader?: ReactNode;
+    description: ReactNode;
+    icon?: React__default.ReactElement;
+    links: PageLink[];
+    actionButtonText?: ReactNode;
+    bgcolor?: SystemProps<Theme>['bgcolor'];
+    onActionButtonClick?: () => void;
+}
+
 declare const UI: {
     Inputs: {
         TextField: React$1.FC<TextFieldComponentProps>;
@@ -324,8 +345,13 @@ declare const UI: {
         ExpandableNote: React$1.FC<ExpandableNoteComponentProps>;
     };
     Widgets: {
-        ProtectedLanguageSelector: React$1.FC<{}>;
-        PublicLanguageSelector: React$1.FC<{}>;
+        Locales: {
+            ProtectedLanguageSelector: React$1.FC<{}>;
+            PublicLanguageSelector: React$1.FC<{}>;
+        };
+        Pages: {
+            PageLinkWidget: React$1.FC<PageLinkWidgetProps>;
+        };
     };
 };
 
@@ -496,6 +522,17 @@ declare const LocalizationProvider: React__default.FC<{
 }>;
 declare const useLocalization: () => LocalizationContextType;
 
+interface I18nInitOptions {
+    supabase: SupabaseClient;
+    defaultLang?: string;
+    fallbackLang?: string;
+    namespaces?: string[];
+}
+/**
+ * Инициализирует и возвращает экземпляр i18n с динамически переданным клиентом Supabase
+ */
+declare const initI18n: ({ supabase, defaultLang, fallbackLang, namespaces, }: I18nInitOptions) => i18next.i18n;
+
 interface DisplayState {
     isMobile: boolean;
     isTablet: boolean;
@@ -655,4 +692,4 @@ declare const Hooks: {
     };
 };
 
-export { type AIConfig, type AIGenerateOptions, AIProvider, type AIProviderProps, type AIProviderType, AppSettingsProvider, AuthProvider, BreadcrumbProvider, type CompanyMember, type ConfirmOptions, type ConfirmResult, ConfirmationProvider, type ConfirmationProviderProps, type CopyClipboardButtonComponentProps, type DialogSeverity, type DisplayState, type EmailInputComponentProps, type ExpandableNoteComponentProps, type FullCompanyMemberItem, Hooks, type Language, LocalizationProvider, type Membership, type MembershipRole, type MyAvatarComponentProps, type NumberInputComponentProps, Providers, type SaveCompanyUserPayload, type SearchComponentProps, type SelectComponentProps, type SelectOption, Services, type SupabaseConfig, SupabaseProvider, type SupabaseProviderProps, type TextFieldComponentProps, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, ToastProvider, type ToastType, type TranslatableTooltipComponentProps, TranslateProvider, TranslateText, TranslationEditProvider, type TypographyConfig, UI, type UrlComponentProps as UrlProps, type UserAvatarComponentProps, type UserGroupedSessions, type UserPopoverComponentProps, type UserProfile, type UserRoleChipComponentProps, type UserSessionItem, type UserSettings, UserSettingsProvider, type UserStatusChipComponentProps, type UserStatusType, defaultUserSettings, useAI, useAppSettings, useAppTheme, useAuth, useBreadcrumb, useConfirmation, useLocalization, useSupabase, useToast, useTranslationEdit, useTranslationNamespace, useUserSettings };
+export { type AIConfig, type AIGenerateOptions, AIProvider, type AIProviderProps, type AIProviderType, AppSettingsProvider, AuthProvider, BreadcrumbProvider, type CompanyMember, type ConfirmOptions, type ConfirmResult, ConfirmationProvider, type ConfirmationProviderProps, type CopyClipboardButtonComponentProps, type DialogSeverity, type DisplayState, type EmailInputComponentProps, type ExpandableNoteComponentProps, type FullCompanyMemberItem, Hooks, type Language, LocalizationProvider, type Membership, type MembershipRole, type MyAvatarComponentProps, type NumberInputComponentProps, type PageLink, type PageLinkWidgetProps, Providers, type SaveCompanyUserPayload, type SearchComponentProps, type SelectComponentProps, type SelectOption, Services, type SupabaseConfig, SupabaseProvider, type SupabaseProviderProps, type TextFieldComponentProps, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, ToastProvider, type ToastType, type TranslatableTooltipComponentProps, TranslateProvider, TranslateText, TranslationEditProvider, type TypographyConfig, UI, type UrlComponentProps as UrlProps, type UserAvatarComponentProps, type UserGroupedSessions, type UserPopoverComponentProps, type UserProfile, type UserRoleChipComponentProps, type UserSessionItem, type UserSettings, UserSettingsProvider, type UserStatusChipComponentProps, type UserStatusType, defaultUserSettings, initI18n, useAI, useAppSettings, useAppTheme, useAuth, useBreadcrumb, useConfirmation, useLocalization, useSupabase, useToast, useTranslationEdit, useTranslationNamespace, useUserSettings };

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
 import { TextFieldProps, SelectProps, SelectChangeEvent, IconButtonProps, TooltipProps, SxProps, Theme, TypographyProps } from '@mui/material';
+import { SystemProps } from '@mui/system';
 import * as _supabase_supabase_js from '@supabase/supabase-js';
 import { SupabaseClient, User, Session } from '@supabase/supabase-js';
+import * as i18next from 'i18next';
 
 interface UrlValue {
     url: string;
@@ -302,6 +304,25 @@ interface ExpandableNoteComponentProps extends Omit<TypographyProps, 'children'>
     label?: React__default.ReactNode;
 }
 
+interface PageLink {
+    text: ReactNode;
+    href?: string;
+    external?: boolean;
+    onClick?: React__default.MouseEventHandler<HTMLButtonElement> | undefined;
+    hidden?: boolean;
+}
+interface PageLinkWidgetProps {
+    overrideNamespace?: string;
+    title: ReactNode;
+    subheader?: ReactNode;
+    description: ReactNode;
+    icon?: React__default.ReactElement;
+    links: PageLink[];
+    actionButtonText?: ReactNode;
+    bgcolor?: SystemProps<Theme>['bgcolor'];
+    onActionButtonClick?: () => void;
+}
+
 declare const UI: {
     Inputs: {
         TextField: React$1.FC<TextFieldComponentProps>;
@@ -324,8 +345,13 @@ declare const UI: {
         ExpandableNote: React$1.FC<ExpandableNoteComponentProps>;
     };
     Widgets: {
-        ProtectedLanguageSelector: React$1.FC<{}>;
-        PublicLanguageSelector: React$1.FC<{}>;
+        Locales: {
+            ProtectedLanguageSelector: React$1.FC<{}>;
+            PublicLanguageSelector: React$1.FC<{}>;
+        };
+        Pages: {
+            PageLinkWidget: React$1.FC<PageLinkWidgetProps>;
+        };
     };
 };
 
@@ -496,6 +522,17 @@ declare const LocalizationProvider: React__default.FC<{
 }>;
 declare const useLocalization: () => LocalizationContextType;
 
+interface I18nInitOptions {
+    supabase: SupabaseClient;
+    defaultLang?: string;
+    fallbackLang?: string;
+    namespaces?: string[];
+}
+/**
+ * Инициализирует и возвращает экземпляр i18n с динамически переданным клиентом Supabase
+ */
+declare const initI18n: ({ supabase, defaultLang, fallbackLang, namespaces, }: I18nInitOptions) => i18next.i18n;
+
 interface DisplayState {
     isMobile: boolean;
     isTablet: boolean;
@@ -655,4 +692,4 @@ declare const Hooks: {
     };
 };
 
-export { type AIConfig, type AIGenerateOptions, AIProvider, type AIProviderProps, type AIProviderType, AppSettingsProvider, AuthProvider, BreadcrumbProvider, type CompanyMember, type ConfirmOptions, type ConfirmResult, ConfirmationProvider, type ConfirmationProviderProps, type CopyClipboardButtonComponentProps, type DialogSeverity, type DisplayState, type EmailInputComponentProps, type ExpandableNoteComponentProps, type FullCompanyMemberItem, Hooks, type Language, LocalizationProvider, type Membership, type MembershipRole, type MyAvatarComponentProps, type NumberInputComponentProps, Providers, type SaveCompanyUserPayload, type SearchComponentProps, type SelectComponentProps, type SelectOption, Services, type SupabaseConfig, SupabaseProvider, type SupabaseProviderProps, type TextFieldComponentProps, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, ToastProvider, type ToastType, type TranslatableTooltipComponentProps, TranslateProvider, TranslateText, TranslationEditProvider, type TypographyConfig, UI, type UrlComponentProps as UrlProps, type UserAvatarComponentProps, type UserGroupedSessions, type UserPopoverComponentProps, type UserProfile, type UserRoleChipComponentProps, type UserSessionItem, type UserSettings, UserSettingsProvider, type UserStatusChipComponentProps, type UserStatusType, defaultUserSettings, useAI, useAppSettings, useAppTheme, useAuth, useBreadcrumb, useConfirmation, useLocalization, useSupabase, useToast, useTranslationEdit, useTranslationNamespace, useUserSettings };
+export { type AIConfig, type AIGenerateOptions, AIProvider, type AIProviderProps, type AIProviderType, AppSettingsProvider, AuthProvider, BreadcrumbProvider, type CompanyMember, type ConfirmOptions, type ConfirmResult, ConfirmationProvider, type ConfirmationProviderProps, type CopyClipboardButtonComponentProps, type DialogSeverity, type DisplayState, type EmailInputComponentProps, type ExpandableNoteComponentProps, type FullCompanyMemberItem, Hooks, type Language, LocalizationProvider, type Membership, type MembershipRole, type MyAvatarComponentProps, type NumberInputComponentProps, type PageLink, type PageLinkWidgetProps, Providers, type SaveCompanyUserPayload, type SearchComponentProps, type SelectComponentProps, type SelectOption, Services, type SupabaseConfig, SupabaseProvider, type SupabaseProviderProps, type TextFieldComponentProps, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, ToastProvider, type ToastType, type TranslatableTooltipComponentProps, TranslateProvider, TranslateText, TranslationEditProvider, type TypographyConfig, UI, type UrlComponentProps as UrlProps, type UserAvatarComponentProps, type UserGroupedSessions, type UserPopoverComponentProps, type UserProfile, type UserRoleChipComponentProps, type UserSessionItem, type UserSettings, UserSettingsProvider, type UserStatusChipComponentProps, type UserStatusType, defaultUserSettings, initI18n, useAI, useAppSettings, useAppTheme, useAuth, useBreadcrumb, useConfirmation, useLocalization, useSupabase, useToast, useTranslationEdit, useTranslationNamespace, useUserSettings };

package/dist/index.js

@@ -31,7 +31,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/i18n/customCacheBackend.ts
-var _SupabaseCacheBackend, SupabaseCacheBackend;
+var _SupabaseCacheBackend, SupabaseCacheBackend, customCacheBackend_default;
 var init_customCacheBackend = __esm({
   "src/i18n/customCacheBackend.ts"() {
     "use strict";
@@ -137,17 +137,37 @@ var init_customCacheBackend = __esm({
     _SupabaseCacheBackend.manifest = {};
     _SupabaseCacheBackend.isManifestLoaded = false;
     SupabaseCacheBackend = _SupabaseCacheBackend;
+    customCacheBackend_default = SupabaseCacheBackend;
   }
 });
 
 // src/i18n/config.ts
-var import_i18next, import_react_i18next, config_default;
+var import_i18next, import_react_i18next, initI18n, config_default;
 var init_config = __esm({
   "src/i18n/config.ts"() {
     "use strict";
     import_i18next = __toESM(require("i18next"));
     import_react_i18next = require("react-i18next");
     init_customCacheBackend();
+    initI18n = ({
+      supabase,
+      defaultLang = "uk",
+      fallbackLang = "en",
+      namespaces = ["common", "landing", "auth-widget", "form_components"]
+    }) => {
+      if (!import_i18next.default.isInitialized) {
+        import_i18next.default.use(new customCacheBackend_default(supabase)).use(import_react_i18next.initReactI18next).init({
+          lng: defaultLang,
+          fallbackLng: fallbackLang,
+          ns: namespaces,
+          defaultNS: "common",
+          keySeparator: false,
+          nsSeparator: ":",
+          interpolation: { escapeValue: false }
+        });
+      }
+      return import_i18next.default;
+    };
     config_default = import_i18next.default;
   }
 });
@@ -2173,6 +2193,7 @@ var init_context = __esm({
     init_TranslateText();
     init_TranslationEditProvider();
     init_LocalizationProvider();
+    init_config();
     init_ThemeProvider();
     init_BreadcrumbProvider();
     init_ToastProvider();
@@ -2761,6 +2782,7 @@ __export(index_exports, {
   UI: () => UI,
   UserSettingsProvider: () => UserSettingsProvider,
   defaultUserSettings: () => defaultUserSettings,
+  initI18n: () => initI18n,
   useAI: () => useAI,
   useAppSettings: () => useAppSettings,
   useAppTheme: () => useAppTheme,
@@ -4378,6 +4400,132 @@ var ExpandableNoteComponent = ({
   );
 };
 
+// src/UI/widgets/page/PageLinkWidget.tsx
+var import_icons_material3 = require("@mui/icons-material");
+var import_material21 = require("@mui/material");
+var import_react28 = __toESM(require("react"));
+var import_react_router_dom = require("react-router-dom");
+init_context();
+var import_jsx_runtime31 = require("react/jsx-runtime");
+var PageLinkWidget = ({
+  overrideNamespace,
+  title,
+  subheader,
+  description,
+  icon,
+  links,
+  actionButtonText,
+  onActionButtonClick,
+  bgcolor
+}) => {
+  const navigate = (0, import_react_router_dom.useNavigate)();
+  return /* @__PURE__ */ (0, import_jsx_runtime31.jsxs)(
+    import_material21.Card,
+    {
+      sx: (theme) => ({
+        height: "100%",
+        display: "flex",
+        flexDirection: "column",
+        boxShadow: 3,
+        bgcolor,
+        color: bgcolor ? typeof bgcolor === "string" && bgcolor.includes(".") ? theme.palette.getContrastText(
+          bgcolor.split(".").reduce((acc, key) => acc[key], theme.palette)
+        ) : typeof bgcolor === "function" ? theme.palette.getContrastText(bgcolor(theme)) : theme.palette.getContrastText(bgcolor) : "text.primary"
+      }),
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
+          import_material21.CardHeader,
+          {
+            avatar: icon ? import_react28.default.cloneElement(icon, {
+              sx: { color: bgcolor ? "inherit" : "primary", ...icon.props.sx }
+            }) : /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_icons_material3.Settings, { color: bgcolor ? "inherit" : "primary" }),
+            title: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_material21.Typography, { variant: "h6", component: "div", color: "inherit", children: typeof title === "string" ? /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(TranslateText, { overrideNamespace, children: title }) : title }),
+            subheader: subheader && /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_material21.Typography, { variant: "body2", sx: { opacity: 0.8, color: "inherit" }, children: typeof subheader === "string" ? /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(TranslateText, { overrideNamespace, children: subheader }) : subheader })
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_material21.Divider, { sx: { borderColor: "inherit", opacity: 0.2 } }),
+        /* @__PURE__ */ (0, import_jsx_runtime31.jsxs)(import_material21.CardContent, { sx: { flexGrow: 1 }, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_material21.Typography, { variant: "body2", sx: { opacity: 0.85, color: "inherit" }, children: typeof description === "string" ? /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(TranslateText, { overrideNamespace, children: description }) : description }),
+          links && links.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_material21.List, { dense: true, disablePadding: true, children: links.filter((f) => !f.hidden).map((link, index) => /* @__PURE__ */ (0, import_jsx_runtime31.jsxs)(
+            import_material21.ListItem,
+            {
+              disablePadding: true,
+              sx: {
+                mt: 1,
+                // Запрещаем ListItem менять цвет фона при наведении
+                "&:hover": {
+                  backgroundColor: "transparent"
+                }
+              },
+              children: [
+                /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
+                  import_material21.ListItemIcon,
+                  {
+                    sx: { minWidth: 30, cursor: "pointer", color: "inherit" },
+                    onClick: () => {
+                      if (link?.href) navigate(link.href);
+                    },
+                    children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_icons_material3.ArrowRight, { fontSize: "small", color: "inherit" })
+                  }
+                ),
+                /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_material21.ListItemText, { children: link.onClick ? /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
+                  import_material21.Button,
+                  {
+                    size: "small",
+                    variant: "text",
+                    color: bgcolor ? "inherit" : "primary",
+                    onClick: link.onClick,
+                    sx: {
+                      fontWeight: 500,
+                      textTransform: "none",
+                      // Отключает автоматические заглавные буквы (UPPERCASE)
+                      padding: 0,
+                      minWidth: "auto",
+                      justifyContent: "flex-start",
+                      textAlign: "left",
+                      transition: "opacity 0.2s ease-in-out",
+                      "&:hover": {
+                        opacity: 0.75,
+                        backgroundColor: "transparent",
+                        // Убирает стандартную серую подложку при ховере кнопки
+                        textDecoration: "underline"
+                        // Эффект подчеркивания, как у ссылки
+                      }
+                    },
+                    children: link.text
+                  }
+                ) : link.href ? /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
+                  import_material21.Link,
+                  {
+                    component: import_react_router_dom.Link,
+                    to: link.href,
+                    target: link.external ? "_blank" : "_self",
+                    rel: link.external ? "noopener noreferrer" : "",
+                    underline: "hover",
+                    color: bgcolor ? "inherit" : "primary",
+                    sx: {
+                      fontWeight: 500,
+                      display: "inline-block",
+                      transition: "opacity 0.2s ease-in-out",
+                      "&:hover": {
+                        opacity: 0.75,
+                        backgroundColor: "transparent"
+                      }
+                    },
+                    children: typeof link.text === "string" ? /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(TranslateText, { overrideNamespace, children: link.text }) : link.text
+                  }
+                ) : /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_material21.Typography, { variant: "body2", sx: { fontWeight: 500, color: "inherit" }, children: typeof link.text === "string" ? /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(TranslateText, { overrideNamespace, children: link.text }) : link.text }) })
+              ]
+            },
+            index
+          )) })
+        ] }),
+        actionButtonText && onActionButtonClick && /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_material21.CardActions, { sx: { justifyContent: "flex-end", padding: 2 }, children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_material21.Button, { size: "small", variant: "contained", onClick: onActionButtonClick, children: typeof actionButtonText === "string" ? /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(TranslateText, { overrideNamespace, children: actionButtonText }) : actionButtonText }) })
+      ]
+    }
+  );
+};
+
 // src/UI/index.ts
 var UI = {
   Inputs: {
@@ -4404,8 +4552,13 @@ var UI = {
     Row: FormRow,
   },*/
   Widgets: {
-    ProtectedLanguageSelector: LanguageSelector,
-    PublicLanguageSelector
+    Locales: {
+      ProtectedLanguageSelector: LanguageSelector,
+      PublicLanguageSelector
+    },
+    Pages: {
+      PageLinkWidget
+    }
   }
 };
 
@@ -4432,16 +4585,16 @@ var Services = {
 };
 
 // src/hooks/useUserStatus.ts
-var import_react28 = require("react");
+var import_react29 = require("react");
 init_deviceId();
 init_context();
 var ONLINE_THRESHOLD_MINUTES = 2;
 var AWAY_THRESHOLD_MINUTES = 15;
 var useUserStatus2 = (userId, initialLastSeenAt, currentAuthUserId) => {
   const supabase = useSupabase();
-  const [status, setStatus] = (0, import_react28.useState)("offline");
-  const [lastSeen, setLastSeen] = (0, import_react28.useState)(initialLastSeenAt ?? null);
-  const lastSeenRef = (0, import_react28.useRef)(initialLastSeenAt ?? null);
+  const [status, setStatus] = (0, import_react29.useState)("offline");
+  const [lastSeen, setLastSeen] = (0, import_react29.useState)(initialLastSeenAt ?? null);
+  const lastSeenRef = (0, import_react29.useRef)(initialLastSeenAt ?? null);
   lastSeenRef.current = lastSeen;
   const calculateStatus = (isOnline, lastSeenIso) => {
     if (isOnline) return "online";
@@ -4457,7 +4610,7 @@ var useUserStatus2 = (userId, initialLastSeenAt, currentAuthUserId) => {
     }
     return "offline";
   };
-  (0, import_react28.useEffect)(() => {
+  (0, import_react29.useEffect)(() => {
     if (!userId) return;
     let isMounted = true;
     const isSelf = currentAuthUserId && userId === currentAuthUserId;
@@ -4547,6 +4700,7 @@ var Hooks = {
   UI,
   UserSettingsProvider,
   defaultUserSettings,
+  initI18n,
   useAI,
   useAppSettings,
   useAppTheme,

package/dist/index.mjs

@@ -26,6 +26,7 @@ import {
   getUserLastSeenAt,
   getUsersLastSeenMap,
   groupSessionsByUser,
+  initI18n,
   isCurrentSessionValid,
   trackUserSession,
   trackUserSessionByRoute,
@@ -42,7 +43,7 @@ import {
   useTranslationEdit,
   useTranslationNamespace,
   useUserSettings
-} from "./chunk-FYNGJLO7.mjs";
+} from "./chunk-FRDK4RQX.mjs";
 
 // src/UI/components/inputs/TextFieldComponent.tsx
 import { useState } from "react";
@@ -740,7 +741,7 @@ var EmailInputComponent = ({
 import { useState as useState5, useEffect as useEffect2, lazy, Suspense } from "react";
 import { Avatar, Tooltip as Tooltip3, Typography as Typography2 } from "@mui/material";
 import { Fragment as Fragment4, jsx as jsx5, jsxs as jsxs4 } from "react/jsx-runtime";
-var LazyUserPopover = lazy(() => import("./UserPopoverComponent-FZF757NQ.mjs"));
+var LazyUserPopover = lazy(() => import("./UserPopoverComponent-K7CJNYYL.mjs"));
 var getInitials = (name) => {
   if (!name) return "?";
   const parts = name.trim().split(" ");
@@ -1652,6 +1653,144 @@ var ExpandableNoteComponent = ({
   );
 };
 
+// src/UI/widgets/page/PageLinkWidget.tsx
+import { ArrowRight, Settings } from "@mui/icons-material";
+import {
+  Button as Button2,
+  Card,
+  CardActions,
+  CardContent,
+  CardHeader,
+  Divider,
+  List,
+  ListItem,
+  ListItemIcon,
+  ListItemText as ListItemText2,
+  Typography as Typography6,
+  Link as MuiLink
+} from "@mui/material";
+import React10 from "react";
+import { Link as RouterLink, useNavigate } from "react-router-dom";
+import { jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
+var PageLinkWidget = ({
+  overrideNamespace,
+  title,
+  subheader,
+  description,
+  icon,
+  links,
+  actionButtonText,
+  onActionButtonClick,
+  bgcolor
+}) => {
+  const navigate = useNavigate();
+  return /* @__PURE__ */ jsxs10(
+    Card,
+    {
+      sx: (theme) => ({
+        height: "100%",
+        display: "flex",
+        flexDirection: "column",
+        boxShadow: 3,
+        bgcolor,
+        color: bgcolor ? typeof bgcolor === "string" && bgcolor.includes(".") ? theme.palette.getContrastText(
+          bgcolor.split(".").reduce((acc, key) => acc[key], theme.palette)
+        ) : typeof bgcolor === "function" ? theme.palette.getContrastText(bgcolor(theme)) : theme.palette.getContrastText(bgcolor) : "text.primary"
+      }),
+      children: [
+        /* @__PURE__ */ jsx11(
+          CardHeader,
+          {
+            avatar: icon ? React10.cloneElement(icon, {
+              sx: { color: bgcolor ? "inherit" : "primary", ...icon.props.sx }
+            }) : /* @__PURE__ */ jsx11(Settings, { color: bgcolor ? "inherit" : "primary" }),
+            title: /* @__PURE__ */ jsx11(Typography6, { variant: "h6", component: "div", color: "inherit", children: typeof title === "string" ? /* @__PURE__ */ jsx11(TranslateText, { overrideNamespace, children: title }) : title }),
+            subheader: subheader && /* @__PURE__ */ jsx11(Typography6, { variant: "body2", sx: { opacity: 0.8, color: "inherit" }, children: typeof subheader === "string" ? /* @__PURE__ */ jsx11(TranslateText, { overrideNamespace, children: subheader }) : subheader })
+          }
+        ),
+        /* @__PURE__ */ jsx11(Divider, { sx: { borderColor: "inherit", opacity: 0.2 } }),
+        /* @__PURE__ */ jsxs10(CardContent, { sx: { flexGrow: 1 }, children: [
+          /* @__PURE__ */ jsx11(Typography6, { variant: "body2", sx: { opacity: 0.85, color: "inherit" }, children: typeof description === "string" ? /* @__PURE__ */ jsx11(TranslateText, { overrideNamespace, children: description }) : description }),
+          links && links.length > 0 && /* @__PURE__ */ jsx11(List, { dense: true, disablePadding: true, children: links.filter((f) => !f.hidden).map((link, index) => /* @__PURE__ */ jsxs10(
+            ListItem,
+            {
+              disablePadding: true,
+              sx: {
+                mt: 1,
+                // Запрещаем ListItem менять цвет фона при наведении
+                "&:hover": {
+                  backgroundColor: "transparent"
+                }
+              },
+              children: [
+                /* @__PURE__ */ jsx11(
+                  ListItemIcon,
+                  {
+                    sx: { minWidth: 30, cursor: "pointer", color: "inherit" },
+                    onClick: () => {
+                      if (link?.href) navigate(link.href);
+                    },
+                    children: /* @__PURE__ */ jsx11(ArrowRight, { fontSize: "small", color: "inherit" })
+                  }
+                ),
+                /* @__PURE__ */ jsx11(ListItemText2, { children: link.onClick ? /* @__PURE__ */ jsx11(
+                  Button2,
+                  {
+                    size: "small",
+                    variant: "text",
+                    color: bgcolor ? "inherit" : "primary",
+                    onClick: link.onClick,
+                    sx: {
+                      fontWeight: 500,
+                      textTransform: "none",
+                      // Отключает автоматические заглавные буквы (UPPERCASE)
+                      padding: 0,
+                      minWidth: "auto",
+                      justifyContent: "flex-start",
+                      textAlign: "left",
+                      transition: "opacity 0.2s ease-in-out",
+                      "&:hover": {
+                        opacity: 0.75,
+                        backgroundColor: "transparent",
+                        // Убирает стандартную серую подложку при ховере кнопки
+                        textDecoration: "underline"
+                        // Эффект подчеркивания, как у ссылки
+                      }
+                    },
+                    children: link.text
+                  }
+                ) : link.href ? /* @__PURE__ */ jsx11(
+                  MuiLink,
+                  {
+                    component: RouterLink,
+                    to: link.href,
+                    target: link.external ? "_blank" : "_self",
+                    rel: link.external ? "noopener noreferrer" : "",
+                    underline: "hover",
+                    color: bgcolor ? "inherit" : "primary",
+                    sx: {
+                      fontWeight: 500,
+                      display: "inline-block",
+                      transition: "opacity 0.2s ease-in-out",
+                      "&:hover": {
+                        opacity: 0.75,
+                        backgroundColor: "transparent"
+                      }
+                    },
+                    children: typeof link.text === "string" ? /* @__PURE__ */ jsx11(TranslateText, { overrideNamespace, children: link.text }) : link.text
+                  }
+                ) : /* @__PURE__ */ jsx11(Typography6, { variant: "body2", sx: { fontWeight: 500, color: "inherit" }, children: typeof link.text === "string" ? /* @__PURE__ */ jsx11(TranslateText, { overrideNamespace, children: link.text }) : link.text }) })
+              ]
+            },
+            index
+          )) })
+        ] }),
+        actionButtonText && onActionButtonClick && /* @__PURE__ */ jsx11(CardActions, { sx: { justifyContent: "flex-end", padding: 2 }, children: /* @__PURE__ */ jsx11(Button2, { size: "small", variant: "contained", onClick: onActionButtonClick, children: typeof actionButtonText === "string" ? /* @__PURE__ */ jsx11(TranslateText, { overrideNamespace, children: actionButtonText }) : actionButtonText }) })
+      ]
+    }
+  );
+};
+
 // src/UI/index.ts
 var UI = {
   Inputs: {
@@ -1678,8 +1817,13 @@ var UI = {
     Row: FormRow,
   },*/
   Widgets: {
-    ProtectedLanguageSelector: LanguageSelector,
-    PublicLanguageSelector
+    Locales: {
+      ProtectedLanguageSelector: LanguageSelector,
+      PublicLanguageSelector
+    },
+    Pages: {
+      PageLinkWidget
+    }
   }
 };
 
@@ -1810,6 +1954,7 @@ export {
   UI,
   UserSettingsProvider,
   defaultUserSettings,
+  initI18n,
   useAI,
   useAppSettings,
   useAppTheme,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serhii.olishevskyi/docs",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "DOCS.UA react packages",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -36,6 +36,7 @@
   "dependencies": {
     "@google/genai": "^2.27.0",
     "@supabase/supabase-js": "^2.117.2",
-    "moment": "^2.31.0"
+    "moment": "^2.31.0",
+    "react-router-dom": "^7.18.4"
   }
 }