@endge/utils 0.23.0 → 0.24.0

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 import { ClassConstructor } from 'class-transformer';
+import { DateTime } from 'ts-luxon';
 import { ExposeOptions } from 'class-transformer';
 import { Ref } from 'vue';
 import { StoreDefinition } from 'pinia';
 import { ValidationOptions } from 'class-validator';
+import { Zone } from 'ts-luxon';
 
 /**
  * Тип для активного состояния с вычисляемым значением.
@@ -14,6 +16,11 @@ export declare type ActiveState<T> = {
 
 export declare function AfterDeserialize(target: any, propertyKey: string, _descriptor: PropertyDescriptor): void;
 
+/**
+ * Backward-compatible loose object record.
+ */
+export declare type AnyRecord = Record<string, any>;
+
 export declare const AppBus: EventBus<GlobalEvents, Record<string, any>>;
 
 /**
@@ -193,6 +200,12 @@ export declare function DeserializeId(): PropertyDecorator;
  */
 export declare type Dictionary<T = any> = Record<string, T>;
 
+export declare function diffDuration(d1: Date, d2: Date): string;
+
+export declare function diffDurationTable(d1: Date, d2: Date): string;
+
+export declare const dt: (date: Date) => DateTime;
+
 /**
  * EventBus реализует паттерн подписки на события.
  *
@@ -326,12 +339,19 @@ export declare function formatDatetime(date: Date, formatString?: string, option
 
 export declare function formatDatetimeTZ(date: Date | string | object, formatString?: string, options?: {}, isLocalTime?: boolean): string;
 
+export declare function formatDatetimeTZSpecial(date?: Date | string | object | null, formatString?: string, options?: {}): string;
+
 export declare function formatDateToMSK(date: any): string;
 
 export declare const generateUUID: () => string;
 
 export declare function GenericExpose(options: ExposeOptions): (target: object, propertyKey: string | symbol) => void;
 
+export declare function getDateOnlyDiffFactor(d1: Date, d2: Date): {
+    variant: 'red' | 'blue';
+    value: string;
+} | null;
+
 export declare function getDayOfWeek(date: any): string;
 
 export declare function getOnDeserializedMethod<T>(instance: T): (() => void) | null;
@@ -583,6 +603,10 @@ export declare function isNullOrUndefined<T>(value: T | null | undefined): value
 
 export declare function IsOptionalTransformed(validationOptions?: ValidationOptions): (object: object, propertyName: string) => void;
 
+export declare function isoToDateInput(value: unknown): string;
+
+export declare function isoToDateTimeLocalInput(value: unknown): string;
+
 /**
  * Декоратор для преобразования JSON-поля:
  * - сериализует объект → строку
@@ -594,6 +618,8 @@ export declare function IsOptionalTransformed(validationOptions?: ValidationOpti
  */
 export declare function Json(): PropertyDecorator;
 
+export declare function JsonString(): PropertyDecorator;
+
 export declare interface KeyCombo {
     ctrl?: boolean;
     alt?: boolean;
@@ -687,6 +713,8 @@ export declare type Override<Base, Overrides> = Omit<Base, keyof Overrides> & Ov
 
 export declare const parseDate: (isoString: string) => "" | Date;
 
+export declare function parseDuration(duration: string): string;
+
 /**
  * Возвращает первую найденную IANA-таймзону с данным смещением (например, "+03:00").
  */
@@ -699,6 +727,21 @@ export declare type PartialDeep<T> = T extends (...args: Array<any>) => any ? T
     [K in keyof T]?: PartialDeep<T[K]>;
 } : T;
 
+export declare interface PayloadClientOptions {
+    baseUrl: string;
+}
+
+export declare class PayloadHttpClient {
+    private readonly baseUrl;
+    constructor(opts: PayloadClientOptions);
+    private buildUrl;
+    private buildHeaders;
+    get<T>(path: string, query?: Record<string, unknown>, extraHeaders?: HeadersInit): Promise<T>;
+    post<T>(path: string, body?: unknown, extraHeaders?: HeadersInit): Promise<T>;
+    patch<T>(path: string, body?: unknown, extraHeaders?: HeadersInit): Promise<T>;
+    delete<T>(path: string, extraHeaders?: HeadersInit): Promise<T>;
+}
+
 export declare function profile<T>(label: string, fn: () => T): T;
 
 export declare function randomString(length: number): string;
@@ -712,6 +755,21 @@ export declare interface ReadonlyIndexCollection<T extends IndexCollectionEntity
     forEach(callback: (item: T) => void): void;
 }
 
+export declare function removeTime(date?: Date): Date;
+
+export declare class RingBuffer<T> {
+    private readonly _cap;
+    private readonly _buf;
+    private _head;
+    private _len;
+    constructor(capacity: number);
+    get capacity(): number;
+    get length(): number;
+    push(value: T): void;
+    clear(): void;
+    toArray(): Array<T>;
+}
+
 /**
  * Декоратор для хранения текста скрипта:
  * - сериализует как обычную строку
@@ -775,6 +833,34 @@ export declare type SharedMaybe<T> = T | null | undefined;
 
 export declare type Side = 'left' | 'right' | 'top' | 'bottom';
 
+export declare class SSEManager {
+    private readonly _url;
+    private readonly _retryInterval;
+    private _abortController;
+    private _isConnected;
+    private _reconnectTimeout;
+    private readonly _options;
+    constructor(options: SSEManagerOptions);
+    start(): void;
+    stop(): void;
+    private _scheduleReconnect;
+    private _clearReconnect;
+    private _buildHeaders;
+    private _connect;
+    get isConnected(): boolean;
+}
+
+export declare interface SSEManagerOptions {
+    url: string;
+    retryInterval?: number;
+    headers?: Record<string, string>;
+    getToken?: () => string | undefined;
+    onEvent: (data: any) => void;
+    onError?: (error: Error) => void;
+    onOpen?: () => void;
+    onClose?: () => void;
+}
+
 /**
  * Структурированная запись лога.
  *
@@ -975,8 +1061,27 @@ export declare class Subscribable {
     notify(): void;
 }
 
+export declare const SystemClock: {
+    DateTime: typeof DateTime;
+    toDateTime(jsDate: Date): DateTime;
+    fromFormat(text: string, format: string, opts: any): DateTime;
+    fromISO(text: string, opts?: any): DateTime | null;
+    getNow(): DateTime;
+    getNowUTC(): DateTime;
+    getToday(): DateTime;
+    getTime(format?: string): string;
+    getUTCTime(format?: string): string;
+    getZone(): Zone;
+};
+
+export declare function timeToTimeInput(value: unknown): string;
+
 export declare function toInstance<T>(ctor: ClassConstructor<T>, json: object): T;
 
+export declare function toIsoZDate(value: string): string | null;
+
+export declare function toIsoZDateTime(value: string): string | null;
+
 export declare const TooltipAttribute = "x-collection-tooltip-id";
 
 export declare interface TooltipInstance {
@@ -989,8 +1094,36 @@ export declare interface TooltipInstance {
     maxWidth?: string | number;
 }
 
+export declare function TooltipRegistrator(h: TooltipRenderFunction, props: TooltipRegistratorProps): any;
+
+export declare interface TooltipRegistratorProps {
+    id?: string;
+    data?: unknown;
+    template?: unknown;
+    location?: unknown;
+    disabled?: boolean;
+    maxWidth?: string;
+    customClass?: string;
+    justifyClass?: string;
+    slots?: {
+        default?: () => any;
+    };
+}
+
+export declare type TooltipRenderFunction = (tag: string, props?: Record<string, unknown>, children?: any) => any;
+
 export declare function toPlain<T>(obj: T): object;
 
+export declare function toTimeHHMMSS(value: unknown): string | null;
+
+export declare interface TreeViewNode {
+    id: string;
+    label: string;
+    icon?: string;
+    expanded?: boolean;
+    children?: Array<TreeViewNode>;
+}
+
 /**
  * Тип, исключающий falsy-значения.
  */
@@ -1115,6 +1248,15 @@ export declare function TypeRecord<V>(valueType: ClassConstructor<V>): PropertyD
  */
 export declare type Undefinable<T> = T | undefined;
 
+export declare class UPSMeter_Service {
+    private _currentCount;
+    private _lastResetTime;
+    private _lastEventsPerSecond;
+    count(): void;
+    get rate(): number;
+    reset(): void;
+}
+
 export declare const useCookie: (name: any, _opts?: any) => Ref<string, string>;
 
 export declare function useStorageDebounced<T>(key: string, initial: T, fromJSON?: (data: any) => T, toJSON?: (data: T) => any, delay?: number): Ref<T>;
@@ -1127,6 +1269,8 @@ export declare const useSubscribableRef: <T extends Subscribable>(obj: T) => {
     unsubscribe: () => void;
 };
 
+export declare const useSubscribableRefAuto: <T extends Subscribable>(obj: T) => Ref<T>;
+
 export declare const useTooltipStore: StoreDefinition<"tooltip", Pick<{
 tooltips: Record<string, TooltipInstance>;
 activeId: Ref<string | null, string | null>;
@@ -1161,4 +1305,10 @@ clearActiveTooltipId: () => void;
  */
 export declare type VoidFn = () => void;
 
+/**
+ * Backward-compatible alias used by legacy packages.
+ */
+declare type VoidFunction_2 = VoidFn;
+export { VoidFunction_2 as VoidFunction }
+
 export { }