@endge/utils 0.27.1 → 1.0.0-dev

package/dist/events/EventBus.d.ts

@@ -6,7 +6,6 @@ import { OneOrMany } from '../tools/tools.types';
 export type EventCallback<T = any> = (payload: T) => void;
 export type EventList = Record<string, any>;
 export interface EventBusOptions {
-    /** При наличии изолирует ошибки подписчиков, включая rejected Promise. */
     onListenerError?: (error: unknown, event: string) => void;
 }
 /**

package/dist/events/Subscribable.d.ts

@@ -1,12 +1,17 @@
-/** Минимальный framework-independent contract объекта с подпиской на изменения. */
 export interface SubscribableLike {
     subscribe: (listener: () => void) => () => void;
 }
-/** Публикует изменения владельца состояния без зависимости от UI framework. */
+/**
+ * Публикует изменения владельца состояния без зависимости от UI framework.
+ */
 export declare class Subscribable implements SubscribableLike {
     private readonly _subscribers;
-    /** Подписывает listener и возвращает идемпотентную функцию отписки. */
+    /**
+     * Подписывает listener и возвращает идемпотентную функцию отписки.
+     */
     subscribe(listener: () => void): () => void;
-    /** Уведомляет текущих подписчиков об изменении владельца состояния. */
+    /**
+     * Уведомляет текущих подписчиков об изменении владельца состояния.
+     */
     notify(): void;
 }

package/dist/serialize/decorators/json.d.ts

@@ -1,10 +1 @@
-/**
- * Декоратор для преобразования JSON-поля:
- * - сериализует объект - строку
- * - десериализует строку - объект
- *
- * Пример:
- * @Json()
- * collection: Record<string, any> = {}
- */
 export declare function Json(): PropertyDecorator;

package/dist/serialize/decorators/script.d.ts

@@ -1,10 +1 @@
-/**
- * Декоратор для хранения текста скрипта:
- * - сериализует как обычную строку
- * - десериализует строку, очищая лишние пробелы
- *
- * Пример:
- * @Script()
- * code: string = ''
- */
 export declare function Script(): PropertyDecorator;

package/dist/shared/utils/time.d.ts

@@ -26,16 +26,11 @@ export declare function toIsoZDate(value: string): string | null;
 export declare function toIsoZDateTime(value: string): string | null;
 export declare function isoToDateInput(value: unknown): string;
 export declare function isoToDateTimeLocalInput(value: unknown): string;
-/** Форматирует DateTime как `HH:mm` в настроенном часовом поясе IANA или локальном поясе браузера. */
 export declare function isoDateTimeToTimeInput(value: unknown, timezone?: unknown): string;
-/** Заменяет только часы и минуты, сохраняя календарную дату DateTime в выбранном часовом поясе. */
 export declare function mergeTimeIntoDateTime(value: unknown, time: unknown, timezone?: unknown): string | null;
 export declare function timeToTimeInput(value: unknown): string;
 export declare function toTimeHHMMSS(value: unknown): string | null;
 export declare function parseDuration(duration: string): string;
 export declare function formatDatetimeTZSpecial(date?: Date | string | object | null, formatString?: string, options?: {}): string;
-/**
- * Возвращает первую найденную IANA-таймзону с данным смещением (например, "+03:00").
- */
 export declare function parseOffsetToTimezone(offsetStr: string): string | null;
 export declare function getTimezoneOffsetMs(timezone: string): number;

package/dist/tools/console.d.ts

@@ -1,4 +1,2 @@
-/** Возвращает строку ограниченной длины без обхода или удержания переданного значения. */
 export declare function consoleValueSummary(value: unknown): string;
-/** Возвращает метаданные Error как текст, не передавая объект Error в Console. */
 export declare function consoleErrorSummary(error: unknown): string;

package/dist/tools/keyboard.d.ts

@@ -15,7 +15,5 @@ export interface KeyboardStateSnapshot {
         code: string[];
     };
 }
-/** Возвращает общий snapshot клавиатуры уровня document, лениво устанавливая один tracker. */
 export declare function getKeyboardStateSnapshot(target: Document): KeyboardStateSnapshot;
-/** Подписывается на общее состояние клавиатуры уровня document и сразу публикует его snapshot. */
 export declare function subscribeKeyboardState(target: Document, listener: (snapshot: KeyboardStateSnapshot) => void): () => void;

package/dist/tools/logs.d.ts

@@ -18,15 +18,10 @@ import { Subscribable } from '../events/Subscribable';
  * }
  */
 export interface StructuredLogEntry {
-    /** Время создания лога (timestamp в ms) */
     timestamp: number;
-    /** Уровень лога: _debug, info, warn или error */
     level: 'debug' | 'info' | 'warn' | 'error' | 'success';
-    /** Сообщение лога */
     message: string;
-    /** Контекст (иерархия вложенности) */
     context: Array<string>;
-    /** Дополнительные действия (например, кнопки для лога) */
     actions?: Array<{
         icon: string;
         tooltip?: string;
@@ -62,9 +57,7 @@ export interface StructuredLogEntry {
  * const logs = logger.getLogs()
  */
 export declare class StructuredLogger extends Subscribable {
-    /** Массив всех логов */
     private _logs;
-    /** Текущий контекст (иерархия) */
     private _currentContext;
     private _currentActions;
     /**

package/dist/tools/reflect.d.ts

@@ -1,12 +1,3 @@
-/**
- * Проверяет, является ли переданная функция конструктором.
- */
 export declare function isConstructor<T extends new (...args: Array<any>) => any>(fn: any): fn is T;
-/**
- * Утилитарный тип: или конструктор, или фабрика.
- */
 export type ConstructorOrFactory<T, Args extends Array<any> = Array<any>> = (new (...args: Args) => T) | ((...args: Args) => T);
-/**
- * Универсальный вызов: конструктор или фабрика.
- */
 export declare function createInstance<T, Args extends Array<any>>(source: ConstructorOrFactory<T, Args>, ...args: Args): T;

package/dist/tools/tools.types.d.ts

@@ -1,101 +1,31 @@
-/**
- * Тип, обозначающий возможное отсутствие значения.
- * Аналог Maybe<P> из функционального программирования.
- */
 export type Maybe<T> = T | null | undefined;
-/**
- * Тип, обозначающий возможное значение null.
- */
 export type Nullable<T> = T | null;
-/**
- * Тип, обозначающий возможное значение undefined.
- */
 export type Undefinable<T> = T | undefined;
-/**
- * Тип конструктора для класса.
- * Используется, например, в DI-контейнерах или фабриках.
- */
 export type Constructor<T = any> = new (...args: Array<any>) => T;
-/**
- * Частичный рекурсивный тип.
- * Делает все поля и вложенные поля необязательными.
- */
 export type DeepPartial<T> = {
     [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
 };
-/**
- * Тип, исключающий null и undefined.
- */
 export type NonNullableStrict<T> = T extends null | undefined ? never : T;
-/**
- * Тип, позволяющий переопределить свойства в типе.
- * Аналог расширения типов с заменой полей.
- */
 export type Override<Base, Overrides> = Omit<Base, keyof Overrides> & Overrides;
-/**
- * Тип для асинхронной функции.
- */
 export type AsyncFn<Args extends Array<any> = Array<any>, R = any> = (...args: Args) => Promise<R>;
-/**
- * Тип, представляющий значение или промис значения.
- */
 export type Awaitable<T> = T | Promise<T>;
-/**
- * Тип, представляющий функцию без аргументов и без возвращаемого значения.
- */
 export type VoidFn = () => void;
-/**
- * Alias для обратной совместимости, используемый legacy-пакетами.
- */
 export type VoidFunction = VoidFn;
-/**
- * Тип, обозначающий словарь значений.
- */
 export type Dictionary<T = any> = Record<string, T>;
-/**
- * Нестрогая запись объекта для обратной совместимости.
- */
 export type AnyRecord = Record<string, any>;
-/**
- * Тип, обозначающий функцию обратного вызова (callback).
- */
 export type Callback<T = void> = (arg: T) => void;
-/**
- * Тип с возможностью `null`, `undefined` или любого значения.
- */
 export type Falsy = false | '' | 0 | null | undefined;
-/**
- * Тип, исключающий falsy-значения.
- */
 export type Truthy<T> = T extends Falsy ? never : T;
-/**
- * Тип, объединяющий `P` или массив `P`.
- */
 export type MaybeArray<T> = T | Array<T>;
-/**
- * Тип, возвращающий все ключи объекта, значения которых равны заданному типу.
- */
 export type KeysWithType<T, U> = {
     [K in keyof T]: T[K] extends U ? K : never;
 }[keyof T];
-/**
- * Тип, помечающий, что значение может быть `never` или `void`, и его можно проигнорировать.
- */
 export type Ignored = never | void;
-/**
- * Универсальный тип для одного или нескольких объектов.
- */
 export type OneOrMany<T> = T | Array<T>;
-/**
- * Тип для активного состояния с вычисляемым значением.
- */
 export interface ActiveState<T> {
     value: T;
     computed: T;
 }
-/**
- * Тип для глубокой частичной рекурсии.
- */
 export type PartialDeep<T> = T extends (...args: Array<any>) => any ? T : T extends Array<infer U> ? Array<PartialDeep<U>> : T extends object ? {
     [K in keyof T]?: PartialDeep<T[K]>;
 } : T;

package/dist/utils.js

@@ -157,13 +157,17 @@ class U {
   constructor() {
     o(this, "_subscribers", /* @__PURE__ */ new Set());
   }
-  /** Подписывает listener и возвращает идемпотентную функцию отписки. */
+  /**
+   * Подписывает listener и возвращает идемпотентную функцию отписки.
+   */
   subscribe(t) {
     return this._subscribers.add(t), () => {
       this._subscribers.delete(t);
     };
   }
-  /** Уведомляет текущих подписчиков об изменении владельца состояния. */
+  /**
+   * Уведомляет текущих подписчиков об изменении владельца состояния.
+   */
   notify() {
     for (const t of this._subscribers)
       t();
@@ -1120,9 +1124,9 @@ function C(r) {
 class ne extends U {
   constructor() {
     super(...arguments);
-    /** Массив всех логов */
+    // Массив всех логов
     o(this, "_logs", []);
-    /** Текущий контекст (иерархия) */
+    // Текущий контекст (иерархия)
     o(this, "_currentContext", []);
     o(this, "_currentActions", []);
   }

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@endge/utils",
   "type": "module",
-  "version": "0.27.1",
+  "version": "1.0.0-dev",
   "private": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/endge-lab/utils.git"
+  },
   "sideEffects": false,
   "exports": {
     ".": {