@dxtmisha/functional-basic 1.3.15 → 1.4.0

package/dist/src/classes/HashInstance.d.ts

@@ -1,95 +1,29 @@
+import { UrlInstanceAbstract } from './UrlInstanceAbstract';
 /**
  * Class for working with data stored in the URL hash.
  *
  * Класс для работы с данными, сохранёнными в хеше URL.
  */
-export declare class HashInstance {
-    private hash?;
-    private watch;
-    private block;
-    private time?;
+export declare class HashInstance extends UrlInstanceAbstract {
     /**
-     * Get data from hash.
-     *
-     * Получение данных из хэша.
-     * @param name variable name / название переменной
-     * @param defaultValue value or function to change data / значение или функция для изменения данных
-     * @returns stored value / сохранённое значение
-     */
-    get<T>(name: string, defaultValue?: T | (() => T)): T;
-    /**
-     * Change data in hash.
-     *
-     * Изменение данных в хэше.
-     * @param name variable name / название переменной
-     * @param callback value or function to change data / значение или функция для изменения данных
-     * @returns this instance / текущий экземпляр
-     */
-    set<T>(name: string, callback: T | (() => T)): this;
-    /**
-     * Adding an event when data is changed.
-     *
-     * Добавление события при изменении данных.
-     * @param name variable name / название переменной
-     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
-     * @returns this instance / текущий экземпляр
-     */
-    addWatch<T>(name: string, callback: (value: T) => void): this;
-    /**
-     * Removing an event when data is changed.
-     *
-     * Удаление события при изменении данных.
-     * @param name variable name / название переменной
-     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
-     * @returns this instance / текущий экземпляр
-     */
-    removeWatch<T>(name: string, callback: (value: T) => void): this;
-    /**
-     * Update hash variable from URL string.
+     * Initializes hash data and registers the hashchange listener.
      *
-     * Обновление переменной хэша из строки URL.
+     * Инициализирует данные хэша и регистрирует слушатель hashchange.
      * @returns this instance / текущий экземпляр
      */
-    reload(): this;
+    protected init(): this;
     /**
      * Obtaining data from the URL string.
      *
      * Получение данных из строки URL.
      * @returns Record<string, any> hash data / данные хэша
      */
-    private getLocation;
-    /**
-     * Returns the hash object, initializing if needed.
-     *
-     * Возвращает объект хэша, инициализируя при необходимости.
-     * @returns Record<string, any> hash object / объект хэша
-     */
-    private getHash;
-    /**
-     * Initializes hash data and registers the hashchange listener.
-     *
-     * Инициализирует данные хэша и регистрирует слушатель hashchange.
-     * @returns this instance / текущий экземпляр
-     */
-    private init;
-    /**
-     * Reads hash data from the URL and triggers watchers.
-     *
-     * Считывает данные хэша из URL и вызывает наблюдателей.
-     * @returns this instance / текущий экземпляр
-     */
-    private initData;
+    protected getLocation(): Record<string, any>;
     /**
      * Update hash string in URL.
      *
      * Обновление строки хэша в URL.
+     * @returns this instance / текущий экземпляр
      */
-    private update;
-    /**
-     * Calling all functions whose data has changed.
-     *
-     * Вызов всех функций, у которых были изменены данные.
-     * @param location fresh data / свежие данные
-     */
-    private makeWatch;
+    protected update(): this;
 }

package/dist/src/classes/Query.d.ts

@@ -0,0 +1,57 @@
+import { QueryInstance } from './QueryInstance';
+/**
+ * Static class for working with data stored in the URL query parameters.
+ * Provides a centralized interface delegating to QueryInstance.
+ *
+ * Статический класс для работы с данными, сохранёнными в query-параметрах URL.
+ * Предоставляет централизованный интерфейс, делегируя вызовы QueryInstance.
+ */
+export declare class Query {
+    /**
+     * Returns a request-isolated instance of QueryInstance.
+     *
+     * Возвращает изолированный в рамках запроса экземпляр QueryInstance.
+     * @returns QueryInstance instance / экземпляр QueryInstance
+     */
+    static getItem(): QueryInstance;
+    /**
+     * Get data from query.
+     *
+     * Получение данных из query-параметров.
+     * @param name variable name / название переменной
+     * @param defaultValue value or function to change data / значение или функция для изменения данных
+     * @returns stored value / сохранённое значение
+     */
+    static get<T>(name: string, defaultValue?: T | (() => T)): T;
+    /**
+     * Change data in query.
+     *
+     * Изменение данных в query-параметрах.
+     * @param name variable name / название переменной
+     * @param callback value or function to change data / значение или функция для изменения данных
+     */
+    static set<T>(name: string, callback: T | (() => T)): void;
+    /**
+     * Adding an event when data is changed.
+     *
+     * Добавление события при изменении данных.
+     * @param name variable name / название переменной
+     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
+     */
+    static addWatch<T>(name: string, callback: (value: T) => void): void;
+    /**
+     * Removing an event when data is changed.
+     *
+     * Удаление события при изменении данных.
+     * @param name variable name / название переменной
+     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
+     */
+    static removeWatch<T>(name: string, callback: (value: T) => void): void;
+    /**
+     * Update query variables from URL string.
+     *
+     * Обновление переменных query-параметров из строки URL.
+     * @returns void
+     */
+    static reload(): void;
+}

package/dist/src/classes/QueryInstance.d.ts

@@ -0,0 +1,29 @@
+import { UrlInstanceAbstract } from './UrlInstanceAbstract';
+/**
+ * Class for working with data stored in the URL query parameters.
+ *
+ * Класс для работы с данными, сохранёнными в query-параметрах URL.
+ */
+export declare class QueryInstance extends UrlInstanceAbstract {
+    /**
+     * Initializes query data and registers the popstate listener.
+     *
+     * Инициализирует данные query-параметров и регистрирует слушатель popstate.
+     * @returns this instance / текущий экземпляр
+     */
+    protected init(): this;
+    /**
+     * Obtaining data from the URL string.
+     *
+     * Получение данных из строки URL.
+     * @returns Record<string, any> query data / данные query-параметров
+     */
+    protected getLocation(): Record<string, any>;
+    /**
+     * Update query string in URL.
+     *
+     * Обновление строки query-параметров в URL.
+     * @returns this instance / текущий экземпляр
+     */
+    protected update(): this;
+}

package/dist/src/classes/UrlInstanceAbstract.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Base abstract class for working with URL-based states (Hash, Query).
+ *
+ * Базовый абстрактный класс для работы с состояниями на основе URL (Hash, Query).
+ */
+export declare abstract class UrlInstanceAbstract {
+    protected data?: Record<string, any>;
+    protected watch: Record<string, ((value: any) => void)[]>;
+    protected block: boolean;
+    protected time?: any;
+    /**
+     * Get data.
+     *
+     * Получение данных.
+     * @param name variable name / название переменной
+     * @param defaultValue value or function to change data / значение или функция для изменения данных
+     * @returns stored value / сохранённое значение
+     */
+    get<T>(name: string, defaultValue?: T | (() => T)): T;
+    /**
+     * Change data.
+     *
+     * Изменение данных.
+     * @param name variable name / название переменной
+     * @param callback value or function to change data / значение или функция для изменения данных
+     * @returns this instance / текущий экземпляр
+     */
+    set<T>(name: string, callback: T | (() => T)): this;
+    /**
+     * Adding an event when data is changed.
+     *
+     * Добавление события при изменении данных.
+     * @param name variable name / название переменной
+     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
+     * @returns this instance / текущий экземпляр
+     */
+    addWatch<T>(name: string, callback: (value: T) => void): this;
+    /**
+     * Removing an event when data is changed.
+     *
+     * Удаление события при изменении данных.
+     * @param name variable name / название переменной
+     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
+     * @returns this instance / текущий экземпляр
+     */
+    removeWatch<T>(name: string, callback: (value: T) => void): this;
+    /**
+     * Update variables from URL string.
+     *
+     * Обновление переменных из строки URL.
+     * @returns this instance / текущий экземпляр
+     */
+    reload(): this;
+    /**
+     * Returns the query/hash data object, initializing if needed.
+     *
+     * Возвращает объект данных, инициализируя при необходимости.
+     * @returns Record<string, any> data object / объект данных
+     */
+    protected getData(): Record<string, any>;
+    /**
+     * Reads data from the URL and triggers watchers.
+     *
+     * Считывает данные из URL и вызывает наблюдателей.
+     * @returns this instance / текущий экземпляр
+     */
+    protected initData(): this;
+    /**
+     * Calling all functions whose data has changed.
+     *
+     * Вызов всех функций, у которых были изменены данные.
+     * @param location fresh data / свежие данные
+     * @returns this instance / текущий экземпляр
+     */
+    protected makeWatch(location: Record<string, any>): this;
+    /**
+     * Initializes data and event listeners.
+     *
+     * Инициализирует данные и слушатели событий.
+     */
+    protected abstract init(): this;
+    /**
+     * Obtaining data from the URL string.
+     *
+     * Получение данных из строки URL.
+     */
+    protected abstract getLocation(): Record<string, any>;
+    /**
+     * Update string in URL.
+     *
+     * Обновление строки в URL.
+     */
+    protected abstract update(): this;
+}

package/dist/src/classes/UrlItem.d.ts

@@ -46,6 +46,29 @@ export declare class UrlItem {
     get hash(): string;
     /** Origin of the URL (readonly) / Источник URL (только для чтения) */
     get origin(): string;
+    /**
+     * Checks if the specified query parameter exists.
+     *
+     * Проверяет, существует ли указанный параметр запроса.
+     * @param name parameter name / имя параметра
+     * @returns check result / результат проверки
+     */
+    hasParam(name: string): boolean;
+    /**
+     * Returns the value of a query parameter.
+     *
+     * Возвращает значение параметра запроса.
+     * @param name parameter name / имя параметра
+     * @returns parameter value or undefined if not found / значение параметра или undefined, если не найдено
+     */
+    getParam(name: string): string | undefined;
+    /**
+     * Returns all query parameters as an object with transformed types.
+     *
+     * Возвращает все параметры запроса в виде объекта с преобразованными типами.
+     * @returns Record<string, any> object of parameters / объект параметров
+     */
+    getParams(): Record<string, any>;
     /**
      * Updates the URL value.
      *
@@ -54,6 +77,31 @@ export declare class UrlItem {
      * @returns this Url instance / текущий экземпляр Url
      */
     set(url?: string | URL): this;
+    /**
+     * Sets the value of a query parameter.
+     *
+     * Устанавливает значение параметра запроса.
+     * @param name parameter name / имя параметра
+     * @param value parameter value / значение параметра
+     * @returns this UrlItem instance / текущий экземпляр UrlItem
+     */
+    setParam(name: string, value: string): this;
+    /**
+     * Replaces all query parameters with the specified object.
+     *
+     * Заменяет все параметры запроса на указанный объект.
+     * @param params parameters to set / параметры для установки
+     * @returns this UrlItem instance / текущий экземпляр UrlItem
+     */
+    setParams(params: Record<string, any>): this;
+    /**
+     * Deletes a query parameter.
+     *
+     * Удаляет параметр запроса.
+     * @param name parameter name / имя параметра
+     * @returns this UrlItem instance / текущий экземпляр UrlItem
+     */
+    deleteParam(name: string): this;
     /**
      * Converts the Url instance to its string representation.
      *

package/dist/src/library.d.ts

@@ -42,6 +42,8 @@ export * from './classes/MetaManager';
 export * from './classes/MetaOg';
 export * from './classes/MetaStatic';
 export * from './classes/MetaTwitter';
+export * from './classes/Query';
+export * from './classes/QueryInstance';
 export * from './classes/ResumableTimer';
 export * from './classes/ScrollbarWidth';
 export * from './classes/SearchList';
@@ -54,6 +56,7 @@ export * from './classes/StorageCallback';
 export * from './classes/Translate';
 export * from './classes/TranslateFile';
 export * from './classes/TranslateInstance';
+export * from './classes/UrlInstanceAbstract';
 export * from './classes/UrlItem';
 export * from './functions/addTagHighlightMatch';
 export * from './functions/anyToString';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/functional-basic",
   "private": false,
-  "version": "1.3.15",
+  "version": "1.4.0",
   "type": "module",
   "description": "Foundational utility library for modern web development — HTTP client, geolocation, i18n, SEO meta tags, caching, storage, DOM utilities, and more. Framework-agnostic, zero dependencies, TypeScript-first.",
   "keywords": [