@mediacubeco/base 0.0.1

package/dist/index.mjs

@@ -0,0 +1 @@
+const t=t=>void 0===t,e=t=>null===t,s=s=>t(s)||e(s),n=t=>"string"==typeof t,i=t=>"number"==typeof t,r=t=>"bigint"==typeof t,o=t=>Number.isNaN(t),a=t=>"boolean"==typeof t,c=t=>"symbol"==typeof t,u=t=>"object"==typeof t,f=t=>{const e=[l,h,g,m,d,p,b,y,D,v,E].some(e=>e(t));return!!t&&"object"==typeof t&&!e},l=t=>Array.isArray(t),h=t=>t instanceof ArrayBuffer,g=t=>t instanceof Map,m=t=>t instanceof Set,d=t=>t instanceof Map,p=t=>t instanceof Set,b=t=>t instanceof Date,y=t=>t instanceof Error,w=t=>t instanceof Proxy,D=t=>t instanceof RegExp,v=t=>t instanceof Promise,E=t=>t instanceof Function,k=t=>new Promise(e=>setTimeout(e,t));function x(t,e,n){const i=!f(t);return!s(n)&&{...e,...i?{[n]:t}:t}||!s(e)&&{...e,...t}||{...t}}function L(t,e,n){return s(t)?n:2===arguments.length?e[t]:e[t]??n}const S=(t,e)=>{const s=Object.entries(t);return Object.fromEntries(s.map(([t,s],n,i)=>[t,e(t,s,n,i)]))},N=(t,...e)=>{if(E(t))return t(...e)},P=(t,e)=>{let s;return(...n)=>{s&&clearTimeout(s),s=setTimeout(()=>N(t,...n),e)}},j=(t,e)=>{let s=!0;return(...n)=>{s&&(N(t,...n),s=!1),setTimeout(()=>s=!0,e)}};function G(t){for(const e in t)return!1;return!0}function O(t){return 0===t.length}function C(t,e){return!(!u(e)||!(t in e))}function T(t,e){return!!F(t,e).length}function A(t,e="isVisible"){return t.filter(t=>!C(e,t)||t[e])}function B(t,e){return t.reduce((t,s)=>t.some(t=>t[e]===s[e])?t:[...t,s],[])}function F(t,e){return t.filter(t=>e.includes(t))}function I(t){return t.filter(t=>!s(t))}function J(t){return l(t)?t:[t]}function M(t,e){const s=[];for(let n=0;n<t.length;n+=e)s.push(t.slice(n,n+e));return s}class V{isDefaultPrevented=!1;constructor(){this.preventDefault=this.preventDefault.bind(this),this.overrideDefault=this.overrideDefault.bind(this)}preventDefault(){this.isDefaultPrevented=!0}overrideDefault(){this.isDefaultPrevented=!1}}class W{subscriptions={};constructor(){this.emit=this.emit.bind(this),this.on=this.on.bind(this),this.off=this.off.bind(this),this.clear=this.clear.bind(this)}emit(t,e,s){const n=this.subscriptions[t];if(n){const{event:t,listenerList:i}=n;i.forEach(s=>N(s,Object.assign(t,e))),t.isDefaultPrevented||N(s)}else N(s)}on(t,e){const s=this.subscriptions[t];return s?s.listenerList.push(e):this.subscriptions[t]={event:new V,listenerList:[e]},()=>this.off(t,e)}off(t,e){const s=this.subscriptions[t];if(s){const{event:n,listenerList:i}=s;this.subscriptions[t]={event:n,listenerList:i.filter(t=>t!==e)},n.overrideDefault()}}clear(t){delete this.subscriptions[t]}}const $=(t="?",...e)=>[`[${(t&&n(t)?t:"?").toUpperCase()}]`,...e.reduce((t,e,s,{length:n})=>{const i=s===n-1?[]:["|"];return t.push(e,...i),t},e.length?["-"]:[])];var z,R,U;!function(t){t.StartGroup="group",t.EndGroup="groupEnd",t.Default="log"}(z||(z={})),function(t){t.Info="%s",t.Success="%s",t.Warning="%s",t.Danger="%s"}(R||(R={}));class q{static formatted={info:(...t)=>q.info(...$(...t)),success:(...t)=>q.success(...$(...t)),warning:(...t)=>q.warning(...$(...t)),danger:(...t)=>q.danger(...$(...t))};static#t(t,...e){console[t](...e)}static startGroup(t,e,...s){q.#t(z.StartGroup,...((t,...e)=>["%c%s",t,...e])(`font-size: 16px;${e}`,...$(t,...s)))}static endGroup(){q.#t(z.EndGroup)}static info(...t){q.#t(z.Default,R.Info,...t)}static success(...t){q.#t(z.Default,R.Success,...t)}static warning(...t){q.#t(z.Default,R.Warning,...t)}static danger(...t){q.#t(z.Default,R.Danger,...t)}}!function(t){t.Capture="capture",t.Forward="forward"}(U||(U={}));class H{static eventEmitter=new W;static caseList=[];static log(t,e){const{signal:s,message:n,payload:i,stack:r}=e,o=[n,y(t)?t.message:void 0].filter(Boolean);q.formatted.danger(s,...o,{error:t,payload:i,stack:r})}static get on(){return H.eventEmitter.on}static get off(){return H.eventEmitter.off}static get clear(){return H.eventEmitter.clear}static create(t,e){return new Error(t,{cause:e})}static throw(t,e){throw H.create(t,e)}static capture(t,e){H.log(t,e),H.eventEmitter.emit(U.Capture,{error:t,config:e})}static forward(t,e){throw H.log(t,e),H.eventEmitter.emit(U.Capture,{error:t,config:e}),t}static case(t){H.caseList.push(t)}static parse(t){const e={message:"Error!",status:0,errors:{},isExternal:!0};for(const{check:s,parse:n}of H.caseList)if(s(t,e))return n(t,e);return!0===y(t)?{message:t.message,status:e.status,errors:e.errors,isExternal:e.isExternal}:{message:e.message,status:e.status,errors:e.errors,isExternal:e.isExternal}}}class K{key;model;config;constructor(t,e,s){this.key=t,this.model=e,this.config=s}async get(t){const{defaultValue:e,withDebug:s}={...this.config,...t},n=await this.model.get(this.key),i=n&&JSON.parse(n)||e;return s&&q.formatted.info("get",this.key,i),i}async set(t,e){const{withDebug:s}={...this.config,...e};await this.model.set(this.key,JSON.stringify(t)),s&&q.formatted.info("set",this.key,t)}async delete(t){const{withDebug:e}={...this.config,...t},s=await this.get({...t,withDebug:!1});await this.model.delete(this.key),e&&q.formatted.info("delete",this.key,s)}async has(t){const{withDebug:e}={...this.config,...t},s=await this.get({...t,withDebug:!1});return e&&q.formatted.info("has",this.key,s),!!s}}class Q{model;config;constructor(t,e){this.model=t,this.config=e}async all(){H.throw("Not implemented")}async clear(){H.throw("Not implemented")}create(t){const e={[t]:new K(t,this.model,this.config)};return Object.assign(this,e)}}export{H as ErrorHandler,U as ErrorHandlerEventName,W as EventEmitter,q as Log,Q as Storage,M as chunkList,x as compose,P as debounce,A as filterByKey,B as filterDuplicateByKey,F as filterEqualValues,I as filterNullableValues,J as forceList,L as getValueByKey,T as hasEqualValues,C as hasKey,u as isAnyObject,l as isArray,h as isArrayBuffer,O as isArrayEmpty,r as isBigint,a as isBoolean,b as isDate,y as isError,E as isFunction,g as isMap,o as isNaN,e as isNull,s as isNullable,i as isNumber,f as isObject,G as isObjectEmpty,v as isPromise,w as isProxy,D as isRegExp,m as isSet,n as isString,c as isSymbol,t as isUndefined,d as isWeakMap,p as isWeakSet,S as mapRecord,N as runCallback,j as throttle,k as wait};

package/dist/services/index.cjs

@@ -0,0 +1 @@
+"use strict";const t=t=>t instanceof Error,e=(t,...e)=>{if(t instanceof Function)return t(...e)};class s{isDefaultPrevented=!1;constructor(){this.preventDefault=this.preventDefault.bind(this),this.overrideDefault=this.overrideDefault.bind(this)}preventDefault(){this.isDefaultPrevented=!0}overrideDefault(){this.isDefaultPrevented=!1}}class i{subscriptions={};constructor(){this.emit=this.emit.bind(this),this.on=this.on.bind(this),this.off=this.off.bind(this),this.clear=this.clear.bind(this)}emit(t,s,i){const r=this.subscriptions[t];if(r){const{event:t,listenerList:n}=r;n.forEach(i=>e(i,Object.assign(t,s))),t.isDefaultPrevented||e(i)}else e(i)}on(t,e){const i=this.subscriptions[t];return i?i.listenerList.push(e):this.subscriptions[t]={event:new s,listenerList:[e]},()=>this.off(t,e)}off(t,e){const s=this.subscriptions[t];if(s){const{event:i,listenerList:r}=s;this.subscriptions[t]={event:i,listenerList:r.filter(t=>t!==e)},i.overrideDefault()}}clear(t){delete this.subscriptions[t]}}const r=(t="?",...e)=>{const s=(t&&(i=t,"string"==typeof i)?t:"?").toUpperCase();var i;const r=e.reduce((t,e,s,{length:i})=>{const r=s===i-1?[]:["|"];return t.push(e,...r),t},e.length?["-"]:[]);return[`[${s}]`,...r]};var n,o,a;!function(t){t.StartGroup="group",t.EndGroup="groupEnd",t.Default="log"}(n||(n={})),function(t){t.Info="%s",t.Success="%s",t.Warning="%s",t.Danger="%s"}(o||(o={}));class c{static formatted={info:(...t)=>c.info(...r(...t)),success:(...t)=>c.success(...r(...t)),warning:(...t)=>c.warning(...r(...t)),danger:(...t)=>c.danger(...r(...t))};static#t(t,...e){console[t](...e)}static startGroup(t,e,...s){c.#t(n.StartGroup,...((t,...e)=>["%c%s",t,...e])(`font-size: 16px;${e}`,...r(t,...s)))}static endGroup(){c.#t(n.EndGroup)}static info(...t){c.#t(n.Default,o.Info,...t)}static success(...t){c.#t(n.Default,o.Success,...t)}static warning(...t){c.#t(n.Default,o.Warning,...t)}static danger(...t){c.#t(n.Default,o.Danger,...t)}}!function(t){t.Capture="capture",t.Forward="forward"}(a||(a={}));class u{static eventEmitter=new i;static caseList=[];static log(e,s){const{signal:i,message:r,payload:n,stack:o}=s,a=[r,t(e)?e.message:void 0].filter(Boolean);c.formatted.danger(i,...a,{error:e,payload:n,stack:o})}static get on(){return u.eventEmitter.on}static get off(){return u.eventEmitter.off}static get clear(){return u.eventEmitter.clear}static create(t,e){return new Error(t,{cause:e})}static throw(t,e){throw u.create(t,e)}static capture(t,e){u.log(t,e),u.eventEmitter.emit(a.Capture,{error:t,config:e})}static forward(t,e){throw u.log(t,e),u.eventEmitter.emit(a.Capture,{error:t,config:e}),t}static case(t){u.caseList.push(t)}static parse(e){const s={message:"Error!",status:0,errors:{},isExternal:!0};for(const{check:t,parse:i}of u.caseList)if(t(e,s))return i(e,s);return!0===t(e)?{message:e.message,status:s.status,errors:s.errors,isExternal:s.isExternal}:{message:s.message,status:s.status,errors:s.errors,isExternal:s.isExternal}}}class l{key;model;config;constructor(t,e,s){this.key=t,this.model=e,this.config=s}async get(t){const{defaultValue:e,withDebug:s}={...this.config,...t},i=await this.model.get(this.key),r=i&&JSON.parse(i)||e;return s&&c.formatted.info("get",this.key,r),r}async set(t,e){const{withDebug:s}={...this.config,...e};await this.model.set(this.key,JSON.stringify(t)),s&&c.formatted.info("set",this.key,t)}async delete(t){const{withDebug:e}={...this.config,...t},s=await this.get({...t,withDebug:!1});await this.model.delete(this.key),e&&c.formatted.info("delete",this.key,s)}async has(t){const{withDebug:e}={...this.config,...t},s=await this.get({...t,withDebug:!1});return e&&c.formatted.info("has",this.key,s),!!s}}exports.Storage=class{model;config;constructor(t,e){this.model=t,this.config=e}async all(){u.throw("Not implemented")}async clear(){u.throw("Not implemented")}create(t){const e={[t]:new l(t,this.model,this.config)};return Object.assign(this,e)}};

package/dist/services/index.d.ts

@@ -0,0 +1,174 @@
+/**
+ * @packageDocumentation
+ * @description
+ * Общие утилитарные типы для проектов на TypeScript.
+ * Содержит типы для примитивов (Nullable, NotNullable), структур данных
+ * (BaseRecord, Entry, List), функций (Callback, AsyncCallback) и вспомогательные
+ * утилиты (KeyOf, ValueOf, Decrement, Increment и др.).
+ * Модуль не содержит рантайм-кода — только типы.
+ *
+ * @example
+ * ```typescript
+ * type User = { id: number; name?: string | null }
+ *
+ * type UserId = ValueOf<Pick<User, 'id'>>
+ * type SafeName = NotNullable<User['name']>
+ * ```
+ */
+type NullablePrimitive = undefined | null;
+/**
+ * Тип, допускающий null или undefined (например для опциональных полей).
+ *
+ * @example
+ * ```typescript
+ * type MaybeName = Nullable<string> // string | null | undefined
+ * ```
+ */
+type Nullable<Data = undefined> = Data | NullablePrimitive;
+/** Значение, которое может быть как синхронным, так и обёрнутым в Promise. */
+type MaybeAsync<Data = never> = Data | Promise<Data>;
+/**
+ * Массив элементов (базовый тип для списков).
+ *
+ * @example
+ * ```typescript
+ * type IdList = BaseList<number> // number[]
+ * ```
+ */
+type BaseList<Item = unknown> = Item[];
+/**
+ * Синхронная функция с заданным списком параметров и результатом.
+ * @template ParamList - кортеж типов аргументов
+ * @template Result - тип возвращаемого значения
+ *
+ * @example
+ * ```typescript
+ * type Sum = Callback<[number, number], number>
+ * ```
+ */
+type Callback<ParamList extends BaseList = BaseList, Result = void> = (...paramList: ParamList) => Result;
+
+type StorageItemConfig<Value = string> = Partial<StorageConfig> & {
+    defaultValue?: Value;
+};
+
+declare class StorageItem<Value = unknown> {
+    private key;
+    private model;
+    private config?;
+    constructor(key: string, model: StorageModel, config?: StorageConfig);
+    get(): Promise<Nullable<Value>>;
+    get(config: StorageItemConfig<Value>): Promise<Value>;
+    set(value: Value, config?: StorageItemConfig<Value>): Promise<void>;
+    delete(config?: StorageItemConfig<Value>): Promise<void>;
+    has(config?: StorageItemConfig<Value>): Promise<boolean>;
+}
+
+/**
+ * Тип экземпляра Storage после вызова .create(key): объект с полем key типа StorageItem<Value>.
+ * Позволяет типизировать storage.user, storage.settings и т.д.
+ *
+ * @example
+ * ```typescript
+ * type UserStorage = StorageInstance<'user', { name: string }>
+ * ```
+ */
+type StorageInstance<Key extends string = string, Value = unknown> = {
+    [key in Key]: StorageItem<Value>;
+};
+/**
+ * Абстрактная модель хранилища ключ–значение.
+ * Реализация может быть localStorage, sessionStorage, серверный API и т.д.
+ * Значения передаются как строки; сериализация/десериализация (например JSON) — в StorageItem.
+ *
+ * @example
+ * ```typescript
+ * const model: StorageModel = {
+ *   get: (key) => localStorage.getItem(key),
+ *   set: (key, value) => localStorage.setItem(key, value),
+ *   delete: (key) => localStorage.removeItem(key)
+ * }
+ * ```
+ */
+type StorageModel = {
+    get: Callback<[string], MaybeAsync<Nullable<string>>>;
+    set: Callback<[string, string], MaybeAsync<void>>;
+    delete: Callback<[string], MaybeAsync<void>>;
+};
+/**
+ * Конфиг Storage/StorageItem: опция отладочного логирования через Log.
+ *
+ * @example
+ * ```typescript
+ * const config: StorageConfig = { withDebug: true }
+ * ```
+ */
+type StorageConfig = {
+    withDebug?: boolean;
+};
+
+/**
+ * Абстракция над ключ–значение хранилищем. Принимает модель (get/set/delete) и через .create(key)
+ * добавляет на экземпляр поле с StorageItem для данного ключа. Данные сериализуются в JSON в StorageItem.
+ *
+ * @example
+ * const model = { get: k => Promise.resolve(localStorage.getItem(k)), set: (k,v) => ..., delete: k => ... }
+ * const storage = new Storage(model).create('user')
+ * await storage.user.set({ name: 'John' })
+ * const user = await storage.user.get()
+ */
+declare class Storage {
+    private readonly model;
+    private readonly config?;
+    /**
+     * @param model - Реализация хранилища (например обёртка над localStorage или API)
+     * @param config - Опции (withDebug для отладочного логирования)
+     *
+     * @example
+     * ```typescript
+     * const storage = new Storage(model, { withDebug: true })
+     * ```
+     */
+    constructor(model: StorageModel, config?: StorageConfig);
+    /**
+     * Должен вернуть все элементы хранилища.
+     * В базовой реализации не поддержан и выбрасывает `Not implemented`.
+     *
+     * @returns Никогда не завершается успешно в базовом классе
+     *
+     * @example
+     * ```typescript
+     * await storage.all() // Error: Not implemented
+     * ```
+     */
+    all(): Promise<never>;
+    /**
+     * Должен очистить всё хранилище.
+     * В базовой реализации не поддержан и выбрасывает `Not implemented`.
+     *
+     * @returns Никогда не завершается успешно в базовом классе
+     *
+     * @example
+     * ```typescript
+     * await storage.clear() // Error: Not implemented
+     * ```
+     */
+    clear(): Promise<never>;
+    /**
+     * Создаёт и привязывает к экземпляру Storage элемент хранилища с заданным ключом.
+     * Возвращает this с новым полем key типа StorageItem<Value> (типизация через StorageInstance).
+     *
+     * @param key - Имя ключа (и имени поля на экземпляре, например 'user' → storage.user)
+     * @returns this с добавленным полем key
+     *
+     * @example
+     * ```typescript
+     * const storage = new Storage(model).create<'user', { name: string }>('user')
+     * await storage.user.set({ name: 'John' })
+     * ```
+     */
+    create<Key extends string = string, Value = unknown>(key: Key): this & StorageInstance<Key, Value>;
+}
+
+export { Storage };
+export type { StorageConfig, StorageInstance, StorageModel };

package/dist/services/index.mjs

@@ -0,0 +1 @@
+const t=t=>t instanceof Error,e=(t,...e)=>{if(t instanceof Function)return t(...e)};class s{isDefaultPrevented=!1;constructor(){this.preventDefault=this.preventDefault.bind(this),this.overrideDefault=this.overrideDefault.bind(this)}preventDefault(){this.isDefaultPrevented=!0}overrideDefault(){this.isDefaultPrevented=!1}}class i{subscriptions={};constructor(){this.emit=this.emit.bind(this),this.on=this.on.bind(this),this.off=this.off.bind(this),this.clear=this.clear.bind(this)}emit(t,s,i){const r=this.subscriptions[t];if(r){const{event:t,listenerList:n}=r;n.forEach(i=>e(i,Object.assign(t,s))),t.isDefaultPrevented||e(i)}else e(i)}on(t,e){const i=this.subscriptions[t];return i?i.listenerList.push(e):this.subscriptions[t]={event:new s,listenerList:[e]},()=>this.off(t,e)}off(t,e){const s=this.subscriptions[t];if(s){const{event:i,listenerList:r}=s;this.subscriptions[t]={event:i,listenerList:r.filter(t=>t!==e)},i.overrideDefault()}}clear(t){delete this.subscriptions[t]}}const r=(t="?",...e)=>{const s=(t&&(i=t,"string"==typeof i)?t:"?").toUpperCase();var i;const r=e.reduce((t,e,s,{length:i})=>{const r=s===i-1?[]:["|"];return t.push(e,...r),t},e.length?["-"]:[]);return[`[${s}]`,...r]};var n,o,a;!function(t){t.StartGroup="group",t.EndGroup="groupEnd",t.Default="log"}(n||(n={})),function(t){t.Info="%s",t.Success="%s",t.Warning="%s",t.Danger="%s"}(o||(o={}));class c{static formatted={info:(...t)=>c.info(...r(...t)),success:(...t)=>c.success(...r(...t)),warning:(...t)=>c.warning(...r(...t)),danger:(...t)=>c.danger(...r(...t))};static#t(t,...e){console[t](...e)}static startGroup(t,e,...s){c.#t(n.StartGroup,...((t,...e)=>["%c%s",t,...e])(`font-size: 16px;${e}`,...r(t,...s)))}static endGroup(){c.#t(n.EndGroup)}static info(...t){c.#t(n.Default,o.Info,...t)}static success(...t){c.#t(n.Default,o.Success,...t)}static warning(...t){c.#t(n.Default,o.Warning,...t)}static danger(...t){c.#t(n.Default,o.Danger,...t)}}!function(t){t.Capture="capture",t.Forward="forward"}(a||(a={}));class u{static eventEmitter=new i;static caseList=[];static log(e,s){const{signal:i,message:r,payload:n,stack:o}=s,a=[r,t(e)?e.message:void 0].filter(Boolean);c.formatted.danger(i,...a,{error:e,payload:n,stack:o})}static get on(){return u.eventEmitter.on}static get off(){return u.eventEmitter.off}static get clear(){return u.eventEmitter.clear}static create(t,e){return new Error(t,{cause:e})}static throw(t,e){throw u.create(t,e)}static capture(t,e){u.log(t,e),u.eventEmitter.emit(a.Capture,{error:t,config:e})}static forward(t,e){throw u.log(t,e),u.eventEmitter.emit(a.Capture,{error:t,config:e}),t}static case(t){u.caseList.push(t)}static parse(e){const s={message:"Error!",status:0,errors:{},isExternal:!0};for(const{check:t,parse:i}of u.caseList)if(t(e,s))return i(e,s);return!0===t(e)?{message:e.message,status:s.status,errors:s.errors,isExternal:s.isExternal}:{message:s.message,status:s.status,errors:s.errors,isExternal:s.isExternal}}}class l{key;model;config;constructor(t,e,s){this.key=t,this.model=e,this.config=s}async get(t){const{defaultValue:e,withDebug:s}={...this.config,...t},i=await this.model.get(this.key),r=i&&JSON.parse(i)||e;return s&&c.formatted.info("get",this.key,r),r}async set(t,e){const{withDebug:s}={...this.config,...e};await this.model.set(this.key,JSON.stringify(t)),s&&c.formatted.info("set",this.key,t)}async delete(t){const{withDebug:e}={...this.config,...t},s=await this.get({...t,withDebug:!1});await this.model.delete(this.key),e&&c.formatted.info("delete",this.key,s)}async has(t){const{withDebug:e}={...this.config,...t},s=await this.get({...t,withDebug:!1});return e&&c.formatted.info("has",this.key,s),!!s}}class f{model;config;constructor(t,e){this.model=t,this.config=e}async all(){u.throw("Not implemented")}async clear(){u.throw("Not implemented")}create(t){const e={[t]:new l(t,this.model,this.config)};return Object.assign(this,e)}}export{f as Storage};

package/dist/types/index.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/types/index.d.ts

@@ -0,0 +1,195 @@
+/**
+ * @packageDocumentation
+ * @description
+ * Общие утилитарные типы для проектов на TypeScript.
+ * Содержит типы для примитивов (Nullable, NotNullable), структур данных
+ * (BaseRecord, Entry, List), функций (Callback, AsyncCallback) и вспомогательные
+ * утилиты (KeyOf, ValueOf, Decrement, Increment и др.).
+ * Модуль не содержит рантайм-кода — только типы.
+ *
+ * @example
+ * ```typescript
+ * type User = { id: number; name?: string | null }
+ *
+ * type UserId = ValueOf<Pick<User, 'id'>>
+ * type SafeName = NotNullable<User['name']>
+ * ```
+ */
+type NullablePrimitive = undefined | null;
+/**
+ * Ключи объекта `Data`. Удобный псевдоним для `keyof`.
+ *
+ * @example
+ * ```typescript
+ * type UserKeys = KeyOf<{ id: number; name: string }> // 'id' | 'name'
+ * ```
+ */
+type KeyOf<Data> = keyof Data;
+/**
+ * Объединение всех возможных значений объекта `Data`.
+ *
+ * @example
+ * ```typescript
+ * type UserValue = ValueOf<{ id: number; name: string }> // number | string
+ * ```
+ */
+type ValueOf<Data> = Data[KeyOf<Data>];
+/** Тип одного элемента массива или кортежа. */
+type IterableOf<Data extends unknown[]> = Data[number];
+/** Служебный псевдоним для `never` или другого "пустого" значения. */
+type Nothing<Data = never> = Data;
+/**
+ * Тип, допускающий null или undefined (например для опциональных полей).
+ *
+ * @example
+ * ```typescript
+ * type MaybeName = Nullable<string> // string | null | undefined
+ * ```
+ */
+type Nullable<Data = undefined> = Data | NullablePrimitive;
+/**
+ * Тип, исключающий null и undefined (гарантированно заданное значение).
+ *
+ * @example
+ * ```typescript
+ * type Name = NotNullable<string | null | undefined> // string
+ * ```
+ */
+type NotNullable<Data = undefined> = Exclude<Data, NullablePrimitive>;
+/** Число или значение, которое можно привести к числу, включая строковый литерал числа. */
+type Numerable<Data = number> = Data | number | `${number}`;
+/** Значение, которое может быть как синхронным, так и обёрнутым в Promise. */
+type MaybeAsync<Data = never> = Data | Promise<Data>;
+/**
+ * Допустимые ключи объекта (как в Record).
+ *
+ * @example
+ * ```typescript
+ * type Key = BaseKey // string | number | symbol
+ * ```
+ */
+type BaseKey = string | number | symbol;
+/**
+ * Массив элементов (базовый тип для списков).
+ *
+ * @example
+ * ```typescript
+ * type IdList = BaseList<number> // number[]
+ * ```
+ */
+type BaseList<Item = unknown> = Item[];
+/**
+ * Объект с ключами Key и значениями Value (обобщение Record).
+ *
+ * @example
+ * ```typescript
+ * type UserMap = BaseRecord<string, 'name' | 'role'>
+ * ```
+ */
+type BaseRecord<Value = unknown, Key extends BaseKey = BaseKey> = Record<Key, Value>;
+/** Объединение `{ key, value }` для каждой пары ключ-значение объекта. */
+type Entry<Data> = {
+    [Key in KeyOf<Data>]: {
+        key: Key;
+        value: Data[Key];
+    };
+}[KeyOf<Data>];
+/** Делает указанные ключи обязательными, а остальные оставляет опциональными. */
+type Include<Data, Key extends KeyOf<Data>> = Required<Pick<Data, Key>> & Partial<Omit<Data, Key>>;
+/** Разделяет объект на кортеж из выбранных и оставшихся свойств. */
+type Divide<Data, Key extends KeyOf<Data>> = [Pick<Data, Key>, Omit<Data, Key>];
+/** Заполняет набор ключей значениями из `Data` или `DefaultValue`, если ключ отсутствует. */
+type Filled<Data, Key extends BaseKey, DefaultValue = undefined> = {
+    [SomeKey in Key]: SomeKey extends KeyOf<Data> ? Data[SomeKey] : DefaultValue;
+};
+/** Общая часть нескольких объектов: только совпадающие ключи и совместимые типы значений. */
+type Shared<DataList extends BaseList[], FirstData extends IterableOf<DataList> = IterableOf<DataList>, SecondData extends IterableOf<DataList> = IterableOf<DataList>> = {
+    [Key in KeyOf<FirstData> & KeyOf<SecondData>]: FirstData[Key] extends SecondData[Key] ? FirstData[Key] : never;
+};
+/**
+ * Кортеж фиксированной длины `Length`, заполненный элементами типа `Item`.
+ *
+ * @example
+ * ```typescript
+ * type Pair = List<2, string> // [string, string]
+ * ```
+ */
+type List<Length extends number, Item = unknown, ResultList extends Item[] = []> = Length extends ResultList['length'] ? ResultList : List<Length, Item, [...ResultList, Item]>;
+/**
+ * Уменьшает числовой литерал на единицу.
+ *
+ * @example
+ * ```typescript
+ * type Two = Decrement<3> // 2
+ * ```
+ */
+type Decrement<Value extends number> = List<Value> extends [infer _, ...infer Rest] ? Rest['length'] : never;
+/**
+ * Увеличивает числовой литерал на единицу.
+ *
+ * @example
+ * ```typescript
+ * type Four = Increment<3> // 4
+ * ```
+ */
+type Increment<Value extends number> = [...List<Value>, IterableOf<List<Value>>]['length'];
+/**
+ * Функция без аргументов и возвращаемого значения.
+ *
+ * @example
+ * ```typescript
+ * const noop: Noop = () => {}
+ * ```
+ */
+type Noop = () => void;
+/**
+ * Синхронная функция с заданным списком параметров и результатом.
+ * @template ParamList - кортеж типов аргументов
+ * @template Result - тип возвращаемого значения
+ *
+ * @example
+ * ```typescript
+ * type Sum = Callback<[number, number], number>
+ * ```
+ */
+type Callback<ParamList extends BaseList = BaseList, Result = void> = (...paramList: ParamList) => Result;
+/**
+ * Асинхронная функция с заданным списком параметров и результатом.
+ *
+ * @example
+ * ```typescript
+ * type FetchUser = AsyncCallback<[string], { id: string }>
+ * ```
+ */
+type AsyncCallback<ParamList extends BaseList = BaseList, Result = void> = (...paramList: ParamList) => Promise<Result>;
+/** Любая синхронная функция без ограничений на аргументы и результат. */
+type AnyCallback = Callback<any[], any>;
+/** Любая асинхронная функция без ограничений на аргументы и результат. */
+type AnyAsyncCallback = AsyncCallback<any[], any>;
+/** Извлекает кортеж аргументов из типа функции. */
+type CallbackParamList<Callback> = Callback extends (...args: infer ParamList) => any ? ParamList : never;
+/** Извлекает тип возвращаемого значения из типа функции. */
+type CallbackResult<Callback> = Callback extends (...args: any) => infer Result ? Result : any;
+
+type ExtraSizeRange<Level extends number, Value extends string, Result extends string = `x${Value}`> = Level extends 1 ? Result : ExtraSizeRange<Decrement<Level>, Value, `${Level}x${Value}` | Result>;
+/**
+ * Набор строковых размеров относительно базовых `s`, `m`, `l`.
+ * Позволяет расширять диапазон вниз (`xs`, `2xs`, ...) и вверх (`xl`, `2xl`, ...).
+ *
+ * @example
+ * ```typescript
+ * type ButtonSize = SizeRange<2, 1> // '2xs' | 'xs' | 's' | 'm' | 'l' | 'xl'
+ * ```
+ */
+type SizeRange<ExtraLevelDown extends number = 1, ExtraLevelUp extends number = 1> = ExtraSizeRange<ExtraLevelDown, 's'> | 's' | 'm' | 'l' | ExtraSizeRange<ExtraLevelUp, 'l'>;
+/**
+ * Объединение чисел от `1` до `Level`.
+ *
+ * @example
+ * ```typescript
+ * type Steps = LevelRange<3> // 1 | 2 | 3
+ * ```
+ */
+type LevelRange<Level extends number, Result extends number = Level> = Level extends 1 ? Result : LevelRange<Decrement<Level>, Result | Decrement<Level>>;
+
+export type { AnyAsyncCallback, AnyCallback, AsyncCallback, BaseKey, BaseList, BaseRecord, Callback, CallbackParamList, CallbackResult, Decrement, Divide, Entry, Filled, Include, Increment, IterableOf, KeyOf, LevelRange, List, MaybeAsync, Noop, NotNullable, Nothing, Nullable, Numerable, Shared, SizeRange, ValueOf };

package/dist/types/index.mjs

@@ -0,0 +1 @@
+

package/dist/utils/index.cjs

@@ -0,0 +1 @@
+"use strict";const e=e=>void 0===e,t=e=>null===e,r=r=>e(r)||t(r),s=e=>"object"==typeof e,o=e=>{const t=[n,i,p,u,c,f,a,x,l,y,m].some(t=>t(e));return!!e&&"object"==typeof e&&!t},n=e=>Array.isArray(e),i=e=>e instanceof ArrayBuffer,p=e=>e instanceof Map,u=e=>e instanceof Set,c=e=>e instanceof Map,f=e=>e instanceof Set,a=e=>e instanceof Date,x=e=>e instanceof Error,l=e=>e instanceof RegExp,y=e=>e instanceof Promise,m=e=>e instanceof Function;const b=(e,...t)=>{if(m(e))return e(...t)};function g(e,t){return!(!s(t)||!(e in t))}function h(e,t){return e.filter(e=>t.includes(e))}exports.chunkList=function(e,t){const r=[];for(let s=0;s<e.length;s+=t)r.push(e.slice(s,s+t));return r},exports.compose=function(e,t,s){const n=!o(e);return!r(s)&&{...t,...n?{[s]:e}:e}||!r(t)&&{...t,...e}||{...e}},exports.debounce=(e,t)=>{let r;return(...s)=>{r&&clearTimeout(r),r=setTimeout(()=>b(e,...s),t)}},exports.filterByKey=function(e,t="isVisible"){return e.filter(e=>!g(t,e)||e[t])},exports.filterDuplicateByKey=function(e,t){return e.reduce((e,r)=>e.some(e=>e[t]===r[t])?e:[...e,r],[])},exports.filterEqualValues=h,exports.filterNullableValues=function(e){return e.filter(e=>!r(e))},exports.forceList=function(e){return n(e)?e:[e]},exports.getValueByKey=function(e,t,s){return r(e)?s:2===arguments.length?t[e]:t[e]??s},exports.hasEqualValues=function(e,t){return!!h(e,t).length},exports.hasKey=g,exports.isAnyObject=s,exports.isArray=n,exports.isArrayBuffer=i,exports.isArrayEmpty=function(e){return 0===e.length},exports.isBigint=e=>"bigint"==typeof e,exports.isBoolean=e=>"boolean"==typeof e,exports.isDate=a,exports.isError=x,exports.isFunction=m,exports.isMap=p,exports.isNaN=e=>Number.isNaN(e),exports.isNull=t,exports.isNullable=r,exports.isNumber=e=>"number"==typeof e,exports.isObject=o,exports.isObjectEmpty=function(e){for(const t in e)return!1;return!0},exports.isPromise=y,exports.isProxy=e=>e instanceof Proxy,exports.isRegExp=l,exports.isSet=u,exports.isString=e=>"string"==typeof e,exports.isSymbol=e=>"symbol"==typeof e,exports.isUndefined=e,exports.isWeakMap=c,exports.isWeakSet=f,exports.mapRecord=(e,t)=>{const r=Object.entries(e);return Object.fromEntries(r.map(([e,r],s,o)=>[e,t(e,r,s,o)]))},exports.runCallback=b,exports.throttle=(e,t)=>{let r=!0;return(...s)=>{r&&(b(e,...s),r=!1),setTimeout(()=>r=!0,t)}},exports.wait=e=>new Promise(t=>setTimeout(t,e));