dev-classes 1.4.39 → 1.5.1

package/README.md

@@ -15,7 +15,7 @@ HTTPSApi.request({keyAction: 'action1', request: {url: '...'}})
 <h3 align="center">NetworkInformation</h3>
 
 ```ts
-import { NetworkInformation, NetworkInformationCordova, NetworkInformationPC } from 'dev-classes';
+import { NetworkInformation, NetworkInformationCordova, NetworkInformationPC, NetworkStatusTracker  } from 'dev-classes';
 
 const internet = new NetworkInformation([new NetworkInformationPC(), new NetworkInformationCordova()]);
 
@@ -23,6 +23,138 @@ internet.run((status, textStatus) => {
   status ? online() : offline();
 });
 
+// или
+const listUrl = ['https://www.google.com'];// для проверки можно опираться на адреса иначе используеться listeners online/ofline или change
+const networkTicker = new NetworkStatusTracker(listUrl);//или []
+
+await networkTicker.startEvents((info) => {
+  console.dir(info);
+  console.dir('А');
+});
+
+console.dir('Б');
+
+//Продолжаем инициализацию приложения после установки иментов
+
+```
+<h3 align="center">Timer</h3>
+
+```ts
+import { Timer } from 'dev-classes';
+
+//Рабочий hook
+
+interface UseShowPanelProps {
+  timeoutShowPanel?: number;
+}
+
+interface UseShowPanelState {
+  showPanel: boolean;
+}
+
+export const useShowPanel = (props: UseShowPanelProps = { timeoutShowPanel: 5000 }) => {
+  const [state, setState] = useState<UseShowPanelState>({
+    showPanel: true,
+  });
+  const setStateHelpers = setStateDecorator(state, setState);
+
+  const timerRef = useRef<Timer | null>(null);
+
+  // Инициализация таймера
+  useEffect(() => {
+    timerRef.current = new Timer(props.timeoutShowPanel, () => {
+      console.log("Время истекло, скрываем панель");
+      setStateHelpers({ showPanel: false });
+    });
+
+    timerRef.current.startTime();
+    return () => {
+      if (timerRef.current) {
+        timerRef.current.resetTime();
+      }
+    };
+  }, [props.timeoutShowPanel]);
+
+  // Показать панель и запустить таймер
+  const handleShowPanel = useCallback(() => {
+    if (!state.showPanel) {
+      setStateHelpers({ showPanel: true });
+      
+      // Важно: сбрасываем и запускаем таймер заново
+      if (timerRef.current) {
+        timerRef.current.resetTime();
+        timerRef.current.startTime();
+      }
+    }
+  }, [state.showPanel]);
+
+  // Сбросить время (продлить показ панели)
+  const handleResetTimePanel = useCallback(() => {
+    if (timerRef.current && state.showPanel) {
+      timerRef.current.resetTime();
+      timerRef.current.startTime();
+    }
+  }, [state.showPanel]);
+
+  // Поставить на паузу (например, при открытии select)
+  const handlePauseTimer = useCallback(() => {
+    if (timerRef.current && state.showPanel) {
+      timerRef.current.pauseTime();
+    }
+  }, [state.showPanel]);
+
+  // Возобновить таймер (например, при закрытии select)
+  const handleResumeTimer = useCallback(() => {
+    if (timerRef.current && state.showPanel) {
+      timerRef.current.startTime();
+    }
+  }, [state.showPanel]);
+
+  // Скрыть панель принудительно
+  const handleHidePanel = useCallback(() => {
+    setStateHelpers({ showPanel: false });
+    if (timerRef.current) {
+      timerRef.current.resetTime();
+    }
+  }, []);
+
+  return {
+    showPanel: state.showPanel,
+    handleShowPanel,
+    handleResetTimePanel,
+    handlePauseTimer,
+    handleResumeTimer,
+    handleHidePanel,
+  };
+};
+
+
+//Где-то
+const { showPanel, handleShowPanel, handleResetTimePanel, handlePauseTimer, handleResumeTimer } = useShowPanel({ timeoutShowPanel: 8000 });
+
+    <ContentPage onClick={() => {
+      handleResetTimePanel();
+      handleShowPanel();
+    }}
+    >
+    //...
+    //При открытии на панели окон и селекторов можно остановить таймер скрытия 
+    //handlePauseTimer, handleResumeTimer
+    </ContentPage>
+
+
+```
+<h3 align="center">BrowserUtils</h3>
+
+```ts
+import { BrowserUtils, BrowserPlatforms_OR } from 'dev-classes';
+
+BrowserUtils.initEventsPauseResume((statusString) => {
+  console.log(statusString)// => on/off
+})
+//Универсальный метод для браузеров и webKit. Ориентируеться на userAgent
+const platform:BrowserPlatforms_OR = BrowserUtils.getWebPlatform();
+
 ```
 <h3 align="center">Color</h3>
 

package/dist/classes/BrowserUtils/BrowserUtils.d.ts

@@ -0,0 +1,5 @@
+export type BrowserPlatforms_OR = 'iOS/Mac' | 'iOS' | 'Android' | 'Windows' | 'Mac' | 'Linux' | 'unknown';
+export declare class BrowserUtils {
+    static getWebPlatform: () => BrowserPlatforms_OR;
+    static initEventsPauseResume(cbInfo: (status: "on" | "off") => void): void;
+}

package/dist/classes/BrowserUtils/index.d.ts

@@ -0,0 +1 @@
+export * from './BrowserUtils';

package/dist/classes/NetworkStatusTracker/NetworkStatusTracker.d.ts

@@ -5,15 +5,15 @@ export declare class NetworkStatusTracker {
     private state;
     private setState;
     private getState;
-    constructor(listUrls: string[]);
+    constructor(listUrls?: string[]);
     private getConnection;
-    private getIsNetwork;
     private getTypeNetwork;
     private updateState;
     private controllersEvents;
     private getControllersEvents;
     private setControllersEvents;
-    startEvents(onStatusChange: OnStatusChange): void;
+    private initialize;
+    startEvents(onStatusChange: OnStatusChange): Promise<void>;
     stopEvents(): void;
     private requestByUrls;
     private checkConnection;
@@ -27,4 +27,5 @@ export declare class NetworkStatusTracker {
         stop: () => void;
     };
     getCurrentState(): NetworkStatusInfoTracker;
+    destroy(): void;
 }

package/dist/classes/NetworkStatusTracker/NetworkStatusTracker.types.d.ts

@@ -1,4 +1,4 @@
-export interface NetworkInfoConnection {
+export interface NetworkInfoConnection extends EventTarget {
     downlink?: number;
     effectiveType?: string;
     rtt?: number;

package/dist/classes/NetworkStatusTracker/index.d.ts

@@ -1,2 +1 @@
 export { NetworkStatusTracker } from './NetworkStatusTracker';
-export type { NetworkItemListTracker, NetworkStatusInfoTracker } from './NetworkStatusTracker.types';

package/dist/classes/Timer/Timer.d.ts

@@ -0,0 +1,43 @@
+type TimerCallback = () => void;
+export declare class Timer {
+    private duration;
+    private onComplete;
+    private timerId;
+    private startTimeCount;
+    private remainingTime;
+    private isPaused;
+    /**
+     * @param duration - Время в миллисекундах
+     * @param onComplete - Колбэк, вызываемый по истечении времени
+     */
+    constructor(duration: number, onComplete: TimerCallback);
+    /**
+     * Запускает или возобновляет таймер
+     */
+    startTime(): void;
+    /**
+     * Ставит таймер на паузу
+     */
+    pauseTime(): void;
+    /**
+     * Сбрасывает таймер к начальному состоянию
+     */
+    resetTime(): void;
+    /**
+     * Завершает таймер и вызывает колбэк
+     */
+    private complete;
+    /**
+     * Проверяет, запущен ли таймер
+     */
+    isRunning(): boolean;
+    /**
+     * Проверяет, находится ли таймер на паузе
+     */
+    isPausedState(): boolean;
+    /**
+     * Возвращает оставшееся время в миллисекундах
+     */
+    getRemainingTime(): number;
+}
+export {};

package/dist/classes/Timer/index.d.ts

@@ -0,0 +1 @@
+export * from './Timer';

package/dist/classes/Utils/NetworkInformation/index.d.ts

@@ -1,4 +1,3 @@
 export { NetworkInformation } from './NetworkInformation';
 export { NetworkInformationPC } from './classes/NetworkInformationPC';
-export { NetworkInformationAbstract } from './classes/types/types.abscruct';
 export { NetworkInformationCordova, type CordovaNetworkStatus } from './classes/NetworkInformationCordova';

package/dist/index.d.ts

@@ -8,3 +8,5 @@ export * from './classes/Utils/Utils';
 export * from './classes/EventSubscribers';
 export * from './classes/NetworkStatusTracker';
 export * from './classes/Utils/NetworkInformation';
+export * from './classes/Timer';
+export * from './classes/BrowserUtils';