@dxtmisha/functional-basic 1.11.0 → 1.11.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/ai-types.md CHANGED
@@ -1,4 +1,4 @@
1
- All these methods are in the @dxtmisha/functional-basic (v1.11.0) library.
1
+ All these methods are in the @dxtmisha/functional-basic (v1.11.1) library.
2
2
 
3
3
  ```typescript
4
4
  /** Class for managing HTTP requests and global API configuration. @keywords api, http, request, fetch */
@@ -55,234 +55,6 @@ export declare class Api {
55
55
  static delete<T>(request: ApiFetch): Promise<T>;
56
56
  }
57
57
 
58
- /** Handles caching of API responses. @keywords api cache, response caching, cache storage */
59
- export declare class ApiCache {
60
- /** Initializes cache storage mechanism and cleanup settings. @keywords init, cache storage, listeners */
61
- static init(getListener: (key: string) => Promise<ApiCacheItem | undefined>, setListener: (key: string, value: ApiCacheItem) => Promise<boolean>, removeListener: (key: string) => Promise<boolean>, cacheStepAgeClearOld?: number): void;
62
- /** Resets the cache by clearing in-memory items and resetting listeners. @keywords reset, clear cache */
63
- static reset(): void;
64
- /** Retrieves cached data by key. @keywords get, fetch cache, cache item */
65
- static get<T>(key: string): Promise<T | undefined>;
66
- /** Retrieves cached data based on fetch request configuration. @keywords get by fetch, api request cache */
67
- static getByFetch<T>(fetch: ApiFetch): Promise<T | undefined>;
68
- /** Stores data in the cache with optional TTL. @keywords set, save cache, store item */
69
- static set<T>(key: string, value: T, age?: number): Promise<void>;
70
- /** Stores data in cache using fetch request configuration. @keywords set by fetch, cache api response */
71
- static setByFetch<T>(fetch: ApiFetch, value: T): Promise<void>;
72
- /** Deletes an item from the cache by key. @keywords remove, delete cache, invalidate */
73
- static remove(key: string): Promise<void>;
74
- }
75
-
76
- /** Handles and processes data returned from an API request. @keywords api, response, data handler, parser */
77
- export declare class ApiDataReturn<T = any> {
78
- /** Initializes the API data return handler instance. @keywords constructor, api data */
79
- constructor(apiFetch: ApiFetch, query: Response, end: ApiPreparationEnd, error?: ApiErrorItem | undefined);
80
- /** Initializes instance by reading data from the response. @keywords init, parse, read response */
81
- init(): Promise<this>;
82
- /** Retrieves processed API response data. @keywords get, data, payload */
83
- get(): ApiData<T>;
84
- /** Retrieves processed data along with the status object. @keywords get, status, api data */
85
- getAndStatus(status: ApiStatus): ApiData<T>;
86
- /** Retrieves raw data received from the API. @keywords raw data, get */
87
- getData(): ApiData<T> | undefined;
88
- }
89
-
90
- /** Class for managing default API request data. @keywords api default request */
91
- export declare class ApiDefault {
92
- /** Checks if default request data exists. @keywords is check default */
93
- is(): boolean;
94
- /** Gets the default request data. @keywords get default data */
95
- get(): Record<string, any> | undefined;
96
- /** Merges default data into the provided request data. @keywords request merge default */
97
- request(request: ApiFetch['request']): ApiFetch['request'];
98
- /** Sets the default request data. @keywords set default data */
99
- set(request: ApiDefaultValue): this;
100
- }
101
-
102
- /** Utility class for managing API error storage and resolving structured error items. @keywords api, error, error-storage, response-handling */
103
- export declare class ApiError {
104
- /** Retrieves the singleton instance of the API error storage. @keywords storage, singleton, instance */
105
- static getStorage(): ApiErrorStorage;
106
- /** Adds error items to the storage matching optional URL and HTTP method criteria. @keywords add, register, error-item, filter */
107
- static add(item: Partial<ApiErrorStorageItem> | Partial<ApiErrorStorageItem>[], url?: string | RegExp, method?: ApiMethodItem): void;
108
- /** Creates an ApiErrorItem by matching the response against stored error criteria. @keywords get-item, match, parse-error, response */
109
- static getItem(method: ApiMethodItem, response: Response): Promise<ApiErrorItem>;
110
- }
111
-
112
- /** Manages and extracts error codes, messages, and status from API error responses. @keywords api error response handler parser */
113
- export declare class ApiErrorItem {
114
- /** Initializes an ApiErrorItem instance. @keywords constructor init */
115
- constructor(method: ApiMethodItem, response: Response, error: ApiErrorStorageItem);
116
- /** Retrieves the HTTP method used for the request. @keywords method http */
117
- getMethod(): ApiMethodItem;
118
- /** Retrieves the raw Fetch response object. @keywords response fetch raw */
119
- getResponse(): Response;
120
- /** Retrieves the matched error storage item. @keywords error item storage */
121
- getError(): ApiErrorStorageItem;
122
- /** Retrieves the error code from storage or the response body. @keywords code error */
123
- getCode(): string | undefined;
124
- /** Retrieves the error message from storage, response body, or status text. @keywords message error */
125
- getMessage(): string | undefined;
126
- /** Retrieves the HTTP status code of the response. @keywords status http code */
127
- getStatus(): number;
128
- }
129
-
130
- /** Centralized storage and matcher for identifying API error states based on response criteria. @keywords api error storage matcher status handler */
131
- export declare class ApiErrorStorage {
132
- /** Finds a matching error item in storage by analyzing the API method and response. @keywords find match error response */
133
- find(method: ApiMethodItem, response: Response): Promise<ApiErrorStorageItem>;
134
- /** Adds one or more API error items or patterns to the internal storage. @keywords add register error rule pattern */
135
- add(item: Partial<ApiErrorStorageItem> | Partial<ApiErrorStorageItem>[], url?: string | RegExp, method?: ApiMethodItem): this;
136
- }
137
-
138
- /** Class for managing and resolving HTTP request headers. @keywords http headers, request headers, api headers */
139
- export declare class ApiHeaders {
140
- /** Resolves and merges HTTP request headers with optional Content-Type. @keywords get headers, merge headers, content-type */
141
- get(value?: Record<string, string> | null, type?: string | undefined | null): Record<string, string> | undefined;
142
- /** Resolves headers tailored to the specific request configuration. @keywords headers by request, request headers */
143
- getByRequest(request: ApiFetch['request'], value?: Record<string, string> | null, type?: string): Record<string, string> | undefined;
144
- /** Sets the default headers. @keywords default headers, set headers */
145
- set(headers: ApiHeadersValue): this;
146
- }
147
-
148
- /** Collects API data during SSR for client-side hydration. @keywords ssr hydration api data transfer */
149
- export declare class ApiHydration {
150
- /** Initializes the API response with hydration payload. @keywords ssr init response hydration */
151
- initResponse(response: ApiResponse): void;
152
- /** Saves an API response for client-side hydration. @keywords ssr cache response hydration state */
153
- toClient<T>(apiFetch: ApiFetch, response: T): void;
154
- /** Serializes hydration data into a string for client injection. @keywords serialize hydration string ssr */
155
- toString(): string;
156
- }
157
-
158
- /** Options for configuring an ApiInstance. @keywords api, options, config */
159
- export type ApiInstanceOptions = {
160
- headersClass?: typeof ApiHeaders;
161
- requestDefaultClass?: typeof ApiDefault;
162
- statusClass?: typeof ApiStatus;
163
- responseClass?: typeof ApiResponse;
164
- preparationClass?: typeof ApiPreparation;
165
- loadingClass?: LoadingInstance;
166
- errorCenterClass?: ErrorCenterInstance;
167
- hydrationClass?: typeof ApiHydration;
168
- wrapper?: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>;
169
- };
170
- /** Core class for managing HTTP requests using the Fetch API. @keywords api, fetch, http, client */
171
- export declare class ApiInstance {
172
- /** Creates an ApiInstance with an optional base URL and configuration options. @keywords constructor, init */
173
- constructor(url?: string, options?: ApiInstanceOptions);
174
- /** Checks if the server is running on localhost. @keywords localhost, environment, host */
175
- isLocalhost(): boolean;
176
- /** Returns the status handler of the last request. @keywords status, state */
177
- getStatus(): ApiStatus;
178
- /** Gets the response handler instance. @keywords response, handler */
179
- getResponse(): ApiResponse;
180
- /** Gets the hydration handler instance. @keywords hydration, ssr */
181
- getHydration(): ApiHydration;
182
- /** Gets the base origin URL combined with the API path. @keywords origin, url, base */
183
- getOrigin(): string;
184
- /** Gets the full URL path for a request script. @keywords url, endpoint, path */
185
- getUrl(path: string, api?: boolean): string;
186
- /** Serializes request data into a body payload or FormData. @keywords body, payload, formdata */
187
- getBody(request?: ApiFetch['request'], method?: ApiMethod): string | FormData | undefined;
188
- /** Generates a formatted query string for GET requests. @keywords query, search_params, url_params */
189
- getBodyForGet(request: ApiFetch['request'], path?: string, method?: ApiMethod): string;
190
- /** Returns a script tag string containing client hydration data. @keywords hydration, script, ssr */
191
- getHydrationScript(): string;
192
- /** Updates default headers applied to requests. @keywords headers, config */
193
- setHeaders(headers: ApiHeadersValue): this;
194
- /** Updates default request configuration parameters. @keywords default, config, options */
195
- setRequestDefault(request: ApiDefaultValue): this;
196
- /** Sets the base script path. @keywords url, endpoint, base */
197
- setUrl(url: string): this;
198
- /** Sets an interceptor callback to run before request execution. @keywords interceptor, preparation, middleware */
199
- setPreparation(callback: (apiFetch: ApiFetch) => Promise<void>): this;
200
- /** Sets an interceptor callback to run after request completion. @keywords interceptor, response, callback */
201
- setEnd(callback: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>): this;
202
- /** Sets the default request timeout in milliseconds. @keywords timeout, delay */
203
- setTimeout(timeout: number): this;
204
- /** Sets the base origin protocol and domain. @keywords origin, domain, host */
205
- setOrigin(origin: string): this;
206
- /** Sets a wrapper function wrapping request execution. @keywords wrapper, middleware */
207
- setWrapper(wrapper: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>): this;
208
- /** Executes an HTTP request with the given path or configuration. @keywords request, fetch, http */
209
- request<T>(pathRequest: string | ApiFetch): Promise<T>;
210
- /** Sends an HTTP GET request. @keywords get, fetch, query */
211
- get<T>(request: ApiFetch): Promise<T>;
212
- /** Sends an HTTP POST request. @keywords post, submit, mutation */
213
- post<T>(request: ApiFetch): Promise<T>;
214
- /** Sends an HTTP PUT request. @keywords put, update */
215
- put<T>(request: ApiFetch): Promise<T>;
216
- /** Sends an HTTP PATCH request. @keywords patch, update */
217
- patch<T>(request: ApiFetch): Promise<T>;
218
- /** Sends an HTTP DELETE request. @keywords delete, remove */
219
- delete<T>(request: ApiFetch): Promise<T>;
220
- }
221
-
222
- /** Handles pre-request preparation and post-request analysis hooks. @keywords api preparation, interceptor, request lifecycle */
223
- export declare class ApiPreparation {
224
- /** Executes pre-request preparation logic if active. @keywords pre-request, prepare */
225
- make(active: boolean, apiFetch: ApiFetch): Promise<void>;
226
- /** Analyzes and processes response data after request execution. @keywords post-request, response interceptor */
227
- makeEnd(active: boolean, query: Response, apiFetch: ApiFetch): Promise<ApiPreparationEnd>;
228
- /** Registers the pre-request callback hook. @keywords pre-request hook, interceptor */
229
- set(callback: (apiFetch: ApiFetch) => Promise<void>): this;
230
- /** Registers the post-request callback hook. @keywords post-request hook, response handler */
231
- setEnd(callback: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>): this;
232
- }
233
-
234
- /** Manages cached API responses, mocking, and request emulation. @keywords api response cache emulator mock */
235
- export declare class ApiResponse {
236
- /** Initializes API response manager with default request configuration. @keywords constructor init */
237
- constructor(requestDefault: ApiDefault);
238
- /** Retrieves a matching cached API response if available. @keywords get cache lookup */
239
- get(path: string | undefined, method: ApiMethod, request?: ApiFetch['request'], devMode?: boolean): ApiResponseItem | undefined;
240
- /** Returns all locally cached API response items. @keywords list items cache */
241
- getList(): (ApiResponseItem & Record<string, any>)[];
242
- /** Adds one or multiple cached API response entries. @keywords add register cache */
243
- add(response: ApiResponseItem | ApiResponseItem[]): this;
244
- /** Enables or disables developer mode. @keywords dev mode toggle */
245
- setDevMode(devMode: boolean): this;
246
- /** Asynchronously executes mock or emulated API response handler. @keywords emulator mock async request */
247
- emulator<T>(apiFetch: ApiFetch): Promise<T | undefined>;
248
- /** Synchronously executes mock or emulated API response handler. @keywords emulator mock sync request */
249
- emulatorAsync<T>(apiFetch: ApiFetch): T | undefined;
250
- }
251
-
252
- /** Class for managing API request status. @keywords api, status, request, response */
253
- export declare class ApiStatus {
254
- /** Returns the last status item data. @keywords status item, state */
255
- get(): ApiStatusItem | undefined;
256
- /** Returns the HTTP execution status code. @keywords http status, status code */
257
- getStatus(): number | undefined;
258
- /** Returns the execution status text. @keywords status text, http message */
259
- getStatusText(): string | undefined;
260
- /** Returns the last status type. @keywords status type, state */
261
- getStatusType(): ApiStatusType | undefined;
262
- /** Returns the execution status code from the response. @keywords code, response code */
263
- getCode(): string | undefined;
264
- /** Returns the script execution error message. @keywords error, failure */
265
- getError(): string | undefined;
266
- /** Returns the data of the last request response. @keywords response, payload, data */
267
- getResponse<T>(): T | undefined;
268
- /** Returns messages from the last request. @keywords message, response message */
269
- getMessage(): string;
270
- /** Sets the status item data. @keywords set status, state */
271
- set(data: ApiStatusItem): this;
272
- /** Sets the status code and optional status text. @keywords set status, http code */
273
- setStatus(status?: number, statusText?: string): this;
274
- /** Sets the error message. @keywords set error, failure */
275
- setError(error?: string): this;
276
- /** Sets last response data and auto-extracts status or message. @keywords set response, payload */
277
- setLastResponse(response?: any): this;
278
- /** Sets the last status type. @keywords set status, status type */
279
- setLastStatus(status?: ApiStatusType): this;
280
- /** Sets the last execution status code. @keywords set code, status code */
281
- setLastCode(code?: string): this;
282
- /** Sets messages from the last request. @keywords set message */
283
- setLastMessage(message?: string): this;
284
- }
285
-
286
58
  /** Manages cross-context messaging using the BroadcastChannel API. @keywords broadcast channel, messaging, cross-tab, communication */
287
59
  export declare class BroadcastMessage<Message = any> {
288
60
  /** Initializes the broadcast channel with handlers. @keywords broadcast, channel, init */
@@ -307,26 +79,6 @@ export declare class Cache {
307
79
  getAsync<T>(name: string, callback: () => T, comparison?: any[]): Promise<T>;
308
80
  }
309
81
 
310
- /** Manages a single cached value with dependency tracking for invalidation. @keywords cache memoize dependency invalidation */
311
- export declare class CacheItem<T> {
312
- /** Creates a CacheItem with a value computation callback. @keywords cache construct */
313
- constructor(callback: () => T);
314
- /** Returns cached value, recomputing if dependency array changes. @keywords get cache memoize */
315
- getCache(comparison: any[]): T;
316
- /** Returns previous cached value before last recalculation. @keywords previous cache history */
317
- getCacheOld(): T | undefined;
318
- /** Asynchronously returns cached value, recomputing if dependency array changes. @keywords async cache memoize */
319
- getCacheAsync(comparison: any[]): Promise<T>;
320
- }
321
-
322
- /** Static cache utility using ServerStorage for persistent application-wide caching. @warning Obsolete. @keywords cache static server storage memoize */
323
- export declare class CacheStatic {
324
- /** Gets a cached value by key, or computes and caches the result using the callback. @keywords cache memoize get */
325
- static get<T>(name: string, callback: () => T, comparison?: any[]): T;
326
- /** Asynchronously gets a cached value by key, or computes and caches the result using the callback. @keywords async cache memoize getAsync */
327
- static getAsync<T>(name: string, callback: () => T, comparison?: any[]): Promise<T>;
328
- }
329
-
330
82
  /** Cookie management utility. @keywords cookie, storage, browser */
331
83
  export declare class Cookie<T> {
332
84
  /** Gets a Cookie instance by name. @keywords cookie, getInstance, singleton */
@@ -351,14 +103,6 @@ export declare class CookieBlock {
351
103
  static set(value: boolean): void;
352
104
  }
353
105
 
354
- /** Manages cookie access blocking status. @keywords cookie block status access */
355
- export declare class CookieBlockInstance {
356
- /** Gets the current cookie block status. @keywords get cookie block status */
357
- get(): boolean;
358
- /** Sets the cookie block status. @keywords set cookie block status */
359
- set(value: boolean): void;
360
- }
361
-
362
106
  export type CookieSameSite = 'strict' | 'lax';
363
107
 
364
108
  /** Options for setting and configuring cookies. @keywords cookie, options, samesite, secure */
@@ -579,50 +323,6 @@ export declare class ErrorCenter {
579
323
  static on(cause: ErrorCenterCauseItem): void;
580
324
  }
581
325
 
582
- /** Manages and triggers error handlers by group or globally. @keywords error center, handler, error handling */
583
- export declare class ErrorCenterHandler {
584
- /** Initializes the error center handler manager. @keywords constructor, init */
585
- constructor(handlers?: ErrorCenterHandlerList, isConsole?: ErrorCenterHandlerIsConsole);
586
- /** Checks if handlers exist for a specific error group. @keywords has, error group, check */
587
- has(group: ErrorCenterGroup): boolean;
588
- /** Retrieves handlers associated with an error group. @keywords get, handler item */
589
- get(group: ErrorCenterGroup): ErrorCenterHandlerItem | undefined;
590
- /** Registers an error handler callback for a specific group. @keywords add, register, error handler */
591
- add(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this;
592
- /** Registers a list of group-based error handlers. @keywords add list, batch register */
593
- addList(handlers: ErrorCenterHandlerList): this;
594
- /** Registers a global callback executed on any error. @keywords add callback, global handler */
595
- addCallback(callback: ErrorCenterHandlerCallback): this;
596
- /** Sets the console logging flag or filter predicate. @keywords console output, logging, filter */
597
- setIsConsole(isConsole: ErrorCenterHandlerIsConsole): this;
598
- /** Dispatches error handlers matching the cause and handles console logging. @keywords dispatch, trigger, handle error */
599
- on(cause: ErrorCenterCauseItem): this;
600
- }
601
-
602
- /** Manages error storage and handling within an instance. @keywords error center, error manager, error storage */
603
- export declare class ErrorCenterInstance {
604
- /** Initializes the error center instance with optional causes and handler. @keywords constructor, error center */
605
- constructor(causes?: ErrorCenterCauseList, handler?: ErrorCenterHandler);
606
- /** Checks if an error cause exists by code and optional group. @keywords error check, has cause */
607
- has(code: string, group?: string): boolean;
608
- /** Retrieves an error cause item by code and optional group. @keywords get error, find cause */
609
- get(code: string, group?: string): ErrorCenterCauseItem | undefined;
610
- /** Adds an error cause item to storage. @keywords add error, register cause */
611
- add(cause: ErrorCenterCauseItem): this;
612
- /** Adds a list of error causes to storage. @keywords add error list, batch causes */
613
- addList(causes: ErrorCenterCauseList): this;
614
- /** Registers an error handler callback for a specific group. @keywords add handler, register callback */
615
- addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this;
616
- /** Registers multiple error handlers from a list. @keywords add handlers, batch handlers */
617
- addHandlerList(handlers: ErrorCenterHandlerList): this;
618
- /** Registers a global callback executed on any error. @keywords error callback, global listener */
619
- addCallback(callback: ErrorCenterHandlerCallback): this;
620
- /** Sets console logging behavior or filter function. @keywords console logging, debug output */
621
- setIsConsole(isConsole: ErrorCenterHandlerIsConsole): this;
622
- /** Triggers error handling for an error cause item. @keywords trigger error, dispatch cause */
623
- on(cause: ErrorCenterCauseItem): this;
624
- }
625
-
626
326
  /**
627
327
  * Advanced wrapper for managing DOM event listeners with lifecycle control, safety checks, and optimizations.
628
328
  * @keywords event listener, dom events, resize observer, scroll sync, event item
@@ -759,60 +459,6 @@ export declare class GeoFlag {
759
459
  setCode(code: string): this;
760
460
  }
761
461
 
762
- /** Cookie key for storing the geo code. @keywords cookie, geo_key */
763
- export declare const UI_GEO_COOKIE_KEY = "ui-geo-code";
764
- /** Base class for managing geographic data, location, language, and timezone settings. @keywords geo, location, language, timezone */
765
- export declare class GeoInstance {
766
- /** Initializes the geographic instance and resolves default location data. @keywords constructor, geo, init */
767
- constructor();
768
- /** Retrieves full geographic data for the current country. @keywords current, country, geo */
769
- get(): GeoItemFull;
770
- /** Retrieves the current country code. @keywords country, code */
771
- getCountry(): string;
772
- /** Retrieves the current language code. @keywords language, code */
773
- getLanguage(): string;
774
- /** Retrieves the standardized locale string (language-country). @keywords standard, locale, language, country */
775
- getStandard(): string;
776
- /** Retrieves the first day of the week for the current country. @keywords first_day, week, calendar */
777
- getFirstDay(): string;
778
- /** Retrieves the current raw location string. @keywords location */
779
- getLocation(): string;
780
- /** Extracts the country code from the current location. @keywords location, country */
781
- getLocationCountry(): string;
782
- /** Extracts the language code from the current location. @keywords location, language */
783
- getLocationLanguage(): string;
784
- /** Retrieves processed geographic item data including active language. @keywords item, language, geo */
785
- getItem(): GeoItemFull;
786
- /** Retrieves the complete list of available country geo records. @keywords list, countries */
787
- getList(): GeoItem[];
788
- /** Retrieves full geographic data by locale, country, or language code. @keywords by_code, search, locale */
789
- getByCode(code?: string): GeoItemFull;
790
- /** Retrieves geographic data matching an exact language-country standard code. @keywords by_code_full, lookup */
791
- getByCodeFull(code: string): GeoItem | undefined;
792
- /** Retrieves geographic data by country code. @keywords by_country, lookup */
793
- getByCountry(country: string): GeoItem | undefined;
794
- /** Retrieves geographic data by language code. @keywords by_language, lookup */
795
- getByLanguage(language: string): GeoItem | undefined;
796
- /** Retrieves the current timezone offset in minutes. @keywords timezone, offset, minutes */
797
- getTimezone(): number;
798
- /** Retrieves the formatted timezone offset string (e.g. '+03:00'). @keywords timezone, format */
799
- getTimezoneFormat(): string;
800
- /** Finds country geo data by code or name. @keywords find, search, country */
801
- find(code: string): GeoItemFull;
802
- /** Formats a geo item into a standard locale string. @keywords to_standard, format, locale */
803
- toStandard(item: GeoItem, language?: string): string;
804
- /** Sets the active location code and optionally persists it to storage. @keywords set, location, save */
805
- set(code: string, save?: boolean): void;
806
- /** Sets the default timezone offset in minutes. @keywords set_timezone, offset */
807
- setTimezone(timezone: number): void;
808
- /** Sets the default country code or dynamic resolver. @keywords default_value, country */
809
- setValueDefault(code?: string | (() => string)): void;
810
- /** Adds or merges geographic data for a specific country code. @keywords add, country, merge */
811
- add(country: string, item: Partial<GeoItem>): this;
812
- /** Adds or merges multiple country geographic records. @keywords add_list, countries, batch */
813
- addList(list: Record<string, Partial<GeoItem>>): this;
814
- }
815
-
816
462
  /** Internationalization and localization utility providing language-sensitive formatting and comparison. @keywords intl localization i18n formatter */
817
463
  export declare class GeoIntl {
818
464
  /** Checks if an instance exists for the specified country or locale code. @keywords localization check locale */
@@ -957,10 +603,6 @@ export declare class Hash {
957
603
  static reload(): void;
958
604
  }
959
605
 
960
- /** Class for managing and synchronizing data stored in the URL hash. @keywords url hash, location hash, hash state, url parameters */
961
- export declare class HashInstance extends UrlInstanceAbstract {
962
- }
963
-
964
606
  export type IconsItem = string | Promise<string | any> | (() => Promise<string | any>);
965
607
  export type IconsConfig = {
966
608
  url?: string;
@@ -1010,34 +652,6 @@ export declare class Loading {
1010
652
  static unregistrationEvent(listener: EventListenerDetail<CustomEvent, LoadingDetail>, element?: ElementOrString<HTMLElement>): void;
1011
653
  }
1012
654
 
1013
- export type LoadingDetail = {
1014
- loading: boolean;
1015
- };
1016
-
1017
- export type LoadingRegistrationItem = {
1018
- item: EventItem<Window, CustomEvent, LoadingDetail>;
1019
- listener: EventListenerDetail<CustomEvent, LoadingDetail>;
1020
- element?: ElementOrString<HTMLElement>;
1021
- };
1022
-
1023
- /** Manages global loading state counters and event notifications. @keywords loading, state, loader, progress */
1024
- export declare class LoadingInstance {
1025
- /** Initializes the loading tracker. @param eventName Name of the event to broadcast loading state @keywords init, constructor */
1026
- constructor(eventName?: string);
1027
- /** Checks whether the loader is currently active. @keywords is, status, active */
1028
- is(): boolean;
1029
- /** Gets the current loading count value. @keywords get, count, counter */
1030
- get(): number;
1031
- /** Increments loading counter and activates loader. @keywords show, start, display */
1032
- show(): void;
1033
- /** Decrements loading counter and hides loader when count reaches zero. @keywords hide, stop, dismiss */
1034
- hide(): void;
1035
- /** Registers an event listener for loading state changes. @param listener Event listener callback @param element Target DOM element @keywords register, listener, subscribe */
1036
- registrationEvent(listener: EventListenerDetail<CustomEvent, LoadingDetail>, element?: ElementOrString<HTMLElement>): void;
1037
- /** Unregisters a loading state event listener. @param listener Event listener callback @param element Target DOM element @keywords unregister, unsubscribe, remove */
1038
- unregistrationEvent(listener: EventListenerDetail<CustomEvent, LoadingDetail>, element?: ElementOrString<HTMLElement>): void;
1039
- }
1040
-
1041
655
  /** Unified manager for standard HTML, Open Graph, and Twitter Card meta tags. @keywords meta, tags, head, html, seo */
1042
656
  export declare class Meta extends MetaManager<MetaTag[]> {
1043
657
  /** Creates an instance of Meta with integrated Open Graph and Twitter Card support. @keywords constructor, init */
@@ -1090,147 +704,6 @@ export declare class Meta extends MetaManager<MetaTag[]> {
1090
704
  htmlTitle(): string;
1091
705
  }
1092
706
 
1093
- type MetaList<T extends readonly string[]> = {
1094
- [K in T[number]]?: string;
1095
- };
1096
- /** Manages HTML meta tag creation, retrieval, and rendering. @keywords meta, head, seo, html, tags */
1097
- export declare class MetaManager<T extends readonly string[], Key extends keyof MetaList<T> = keyof MetaList<T>> {
1098
- /** Initializes manager with meta tag names and optional property attribute mode. @keywords meta, init, head */
1099
- constructor(listMeta: T, isProperty?: boolean);
1100
- /** Returns managed meta tag names list. @keywords meta, list, names */
1101
- getListMeta(): T;
1102
- /** Gets content of specified meta tag by name. @keywords meta, get, value, content */
1103
- get(name: Key): string;
1104
- /** Returns all configured meta tag key-value pairs. @keywords meta, items, dictionary, all */
1105
- getItems(): MetaList<T>;
1106
- /** Renders all meta tags as an HTML string. @keywords html, render, markup, meta */
1107
- html(): string;
1108
- /** Sets content for a specific meta tag. @keywords meta, set, update */
1109
- set(name: Key, content: string): this;
1110
- /** Sets multiple meta tags from a dictionary object. @keywords meta, batch, set, dictionary */
1111
- setByList(metaList: MetaList<T>): this;
1112
- }
1113
-
1114
- /** Manages Open Graph meta tags. @keywords meta open graph og seo tags */
1115
- export declare class MetaOg extends MetaManager<MetaOpenGraphTag[]> {
1116
- /** Initializes a new MetaOg instance. @keywords constructor og */
1117
- constructor();
1118
- /** Gets the Open Graph title (`og:title`). @keywords og title */
1119
- getTitle(): string;
1120
- /** Gets the Open Graph type (`og:type`). @keywords og type */
1121
- getType(): MetaOpenGraphType;
1122
- /** Gets the Open Graph URL (`og:url`). @keywords og url */
1123
- getUrl(): string;
1124
- /** Gets the Open Graph image URL (`og:image`). @keywords og image */
1125
- getImage(): string;
1126
- /** Gets the Open Graph description (`og:description`). @keywords og description */
1127
- getDescription(): string;
1128
- /** Gets the Open Graph locale (`og:locale`). @keywords og locale */
1129
- getLocale(): string;
1130
- /** Gets the Open Graph site name (`og:site_name`). @keywords og site name */
1131
- getSiteName(): string;
1132
- /** Sets the Open Graph title (`og:title`). @keywords og title */
1133
- setTitle(title: string): this;
1134
- /** Sets the Open Graph type (`og:type`). @keywords og type */
1135
- setType(type: MetaOpenGraphType): this;
1136
- /** Sets the Open Graph URL (`og:url`). @keywords og url */
1137
- setUrl(url: string): this;
1138
- /** Sets the Open Graph image URL (`og:image`). @keywords og image */
1139
- setImage(url: string): this;
1140
- /** Sets the Open Graph description (`og:description`). @keywords og description */
1141
- setDescription(description: string): this;
1142
- /** Sets the Open Graph locale (`og:locale`, e.g. 'en_US'). @keywords og locale */
1143
- setLocale(locale: string): this;
1144
- /** Sets the Open Graph site name (`og:site_name`). @keywords og site name */
1145
- setSiteName(siteName: string): this;
1146
- }
1147
-
1148
- /** Static helper for managing meta tags, Open Graph, and Twitter Cards. @keywords meta, tags, head, seo */
1149
- export declare class MetaStatic {
1150
- /** Returns singleton instance of Meta. @keywords instance, singleton, meta */
1151
- static getItem(): Meta;
1152
- /** Returns MetaOg instance for Open Graph tags. @keywords og, open graph, social */
1153
- static getOg(): MetaOg;
1154
- /** Returns MetaTwitter instance for Twitter Card tags. @keywords twitter, twitter card, social */
1155
- static getTwitter(): MetaTwitter;
1156
- /** Gets page title without suffix. @keywords title, get, seo */
1157
- static getTitle(): string;
1158
- /** Gets keywords meta tag content. @keywords keywords, meta, seo */
1159
- static getKeywords(): string;
1160
- /** Gets description meta tag content. @keywords description, meta, seo */
1161
- static getDescription(): string;
1162
- /** Gets Open Graph image URL. @keywords image, og, preview */
1163
- static getImage(): string;
1164
- /** Gets canonical URL. @keywords canonical, url, link */
1165
- static getCanonical(): string;
1166
- /** Gets robots meta directive. @keywords robots, crawler, indexing */
1167
- static getRobots(): MetaRobots;
1168
- /** Gets author meta tag value. @keywords author, meta */
1169
- static getAuthor(): string;
1170
- /** Gets Open Graph site name. @keywords siteName, og, name */
1171
- static getSiteName(): string;
1172
- /** Gets Open Graph locale. @keywords locale, language, og */
1173
- static getLocale(): string;
1174
- /** Sets page title and synchronizes Open Graph and Twitter Card titles. @keywords setTitle, title, seo */
1175
- static setTitle(title: string): typeof MetaStatic;
1176
- /** Sets keywords meta tag. @keywords setKeywords, keywords, seo */
1177
- static setKeywords(keywords: string | string[]): typeof MetaStatic;
1178
- /** Sets description meta tag. @keywords setDescription, description, seo */
1179
- static setDescription(description: string): typeof MetaStatic;
1180
- /** Sets preview image for Open Graph and Twitter Card. @keywords setImage, image, og, twitter */
1181
- static setImage(image: string): typeof MetaStatic;
1182
- /** Sets canonical URL and updates Open Graph and Twitter Card URLs. @keywords setCanonical, canonical, url */
1183
- static setCanonical(canonical: string): typeof MetaStatic;
1184
- /** Sets robots meta tag directive. @keywords setRobots, robots, crawler */
1185
- static setRobots(robots: MetaRobots): typeof MetaStatic;
1186
- /** Sets author meta tag. @keywords setAuthor, author */
1187
- static setAuthor(author: string): typeof MetaStatic;
1188
- /** Sets site name for Open Graph and Twitter Card. @keywords setSiteName, siteName, og */
1189
- static setSiteName(siteName: string): typeof MetaStatic;
1190
- /** Sets locale for Open Graph. @keywords setLocale, locale, lang */
1191
- static setLocale(locale: string): typeof MetaStatic;
1192
- /** Sets suffix appended to page title. @keywords setSuffix, suffix, title */
1193
- static setSuffix(suffix?: string): typeof MetaStatic;
1194
- /** Renders complete HTML string for all meta, Open Graph, and Twitter Card tags. @keywords html, render, tags */
1195
- static html(): string;
1196
- /** Renders page title tag as HTML-safe string. @keywords htmlTitle, title, render */
1197
- static htmlTitle(): string;
1198
- }
1199
-
1200
- /** Manages Twitter Card meta tags. @keywords twitter card, meta tags, social share */
1201
- export declare class MetaTwitter extends MetaManager<MetaTwitterTag[]> {
1202
- /** Initializes the MetaTwitter instance. @keywords constructor, init */
1203
- constructor();
1204
- /** Gets the Twitter Card type. @keywords twitter card, type, get */
1205
- getCard(): MetaTwitterCard;
1206
- /** Gets the website or brand @username. @keywords twitter site, username, get */
1207
- getSite(): string;
1208
- /** Gets the content creator @username. @keywords twitter creator, author, get */
1209
- getCreator(): string;
1210
- /** Gets the page URL. @keywords twitter url, get */
1211
- getUrl(): string;
1212
- /** Gets the card title. @keywords twitter title, get */
1213
- getTitle(): string;
1214
- /** Gets the card description. @keywords twitter description, get */
1215
- getDescription(): string;
1216
- /** Gets the card image URL. @keywords twitter image, get */
1217
- getImage(): string;
1218
- /** Sets the Twitter Card type. @keywords twitter card, type, set */
1219
- setCard(card: MetaTwitterCard): this;
1220
- /** Sets the website or brand @username. @keywords twitter site, username, set */
1221
- setSite(site: string): this;
1222
- /** Sets the content creator @username. @keywords twitter creator, author, set */
1223
- setCreator(creator: string): this;
1224
- /** Sets the page URL. @keywords twitter url, set */
1225
- setUrl(url: string): this;
1226
- /** Sets the card title. @keywords twitter title, set */
1227
- setTitle(title: string): this;
1228
- /** Sets the card description. @keywords twitter description, set */
1229
- setDescription(description: string): this;
1230
- /** Sets the card image URL. @keywords twitter image, set */
1231
- setImage(image: string): this;
1232
- }
1233
-
1234
707
  /** Static facade for managing URL query parameters. @keywords url, query params, search params, routing */
1235
708
  export declare class Query {
1236
709
  /** Returns a request-isolated QueryInstance. @keywords instance, query instance, singleton */
@@ -1247,10 +720,6 @@ export declare class Query {
1247
720
  static reload(): void;
1248
721
  }
1249
722
 
1250
- /** Manages data stored in URL query parameters. @keywords query, url, searchParams, parameters */
1251
- export declare class QueryInstance extends UrlInstanceAbstract {
1252
- }
1253
-
1254
723
  /** Timer that can be paused, resumed, reset, and cleared. @keywords timer, pause, resume, timeout, delay */
1255
724
  export declare class ResumableTimer {
1256
725
  /** Creates a resumable timer instance. @param blockStart If true, timer will not start immediately. @keywords timer, init */
@@ -1305,85 +774,6 @@ export declare class SearchList<T extends SearchItem, K extends SearchColumns<T>
1305
774
  to(): SearchFormatList<T, K>;
1306
775
  }
1307
776
 
1308
- /** Manages and formats search data list and item cache. @keywords search, list, cache, format */
1309
- export declare class SearchListData<T extends SearchItem, K extends SearchColumns<T>> {
1310
- /** Creates an instance of SearchListData. @keywords constructor, init */
1311
- constructor(list: SearchListValue<T>, columns: K | undefined, item: SearchListItem, options: SearchListOptions);
1312
- /** Checks if both list and columns are provided for column-based search. @keywords type guard, check, columns */
1313
- is(): this is this & {
1314
- list: T[];
1315
- columns: string[];
1316
- };
1317
- /** Checks if the search list is provided. @keywords type guard, check, list */
1318
- isList(): this is this & {
1319
- list: T[];
1320
- };
1321
- /** Returns the original list. @keywords get list, source */
1322
- getList(): SearchListValue<T>;
1323
- /** Returns search columns. @keywords get columns, keys */
1324
- getColumns(): K | undefined;
1325
- /** Sets a new list and updates the cache. @keywords set list, cache */
1326
- setList(list: SearchListValue<T>): this;
1327
- /** Sets search columns and updates the cache. @keywords set columns, cache */
1328
- setColumns(columns?: SearchColumns<T>): this;
1329
- /** Finds a cached item for the given original item. @keywords find, cache, lookup */
1330
- findCacheItem(item: T): SearchCacheItem<T> | undefined;
1331
- /** Iterates over cached items and applies a formatting callback. @keywords iterate, format, callback */
1332
- forEach(callback: (item: SearchCacheItem<T>['item'], value: SearchCacheItem<T>['value']) => SearchFormatItem<T, K> | undefined): SearchFormatList<T, K>;
1333
- /** Formats an item, optionally highlighting matching search terms. @keywords format item, highlight, match */
1334
- toFormatItem(item: T, selection: boolean): SearchFormatItem<T, K>;
1335
- }
1336
-
1337
- /** Manages search item value and query state. @keywords search item value query state */
1338
- export declare class SearchListItem {
1339
- /** Initializes a new SearchListItem instance. @keywords search item constructor init */
1340
- constructor(value: string | undefined, options: SearchListOptions);
1341
- /** Checks whether the search value is defined. @keywords check value exists defined */
1342
- is(): this is this & {
1343
- value: string;
1344
- };
1345
- /** Checks if the search value length meets the minimum limit. @keywords search threshold limit length */
1346
- isSearch(): boolean;
1347
- /** Gets the current search string value. @keywords get search query string */
1348
- get(): string;
1349
- /** Sets the search string value. @keywords set search query update */
1350
- set(value?: string): this;
1351
- }
1352
-
1353
- /** Matches search values against list data using regular expressions. @keywords search matcher regex pattern */
1354
- export declare class SearchListMatcher {
1355
- /** Initializes the search matcher with item and options. @keywords constructor init */
1356
- constructor(item: SearchListItem, options: SearchListOptions);
1357
- /** Checks if the matcher is active or initialized. @keywords is initialized check active */
1358
- is(): boolean;
1359
- /** Checks if the given value matches the current search expression. @keywords test match selection */
1360
- isSelection(value: SearchCacheItem<any>['value']): boolean;
1361
- /** Gets the compiled regular expression matcher. @keywords regex pattern get */
1362
- get(): RegExp | undefined;
1363
- /** Updates the regex matcher from current item value and options. @keywords update refresh compile */
1364
- update(): void;
1365
- }
1366
-
1367
- /** Manages search list options and configuration settings. @keywords search, options, list, config */
1368
- export declare class SearchListOptions {
1369
- /** Initializes search list options. @keywords constructor, init */
1370
- constructor(options?: SearchOptions | undefined);
1371
- /** Retrieves current search options. @keywords get, options, search */
1372
- getOptions(): SearchOptions;
1373
- /** Retrieves the minimum character length required to trigger search. @keywords limit, min, length, trigger */
1374
- getLimit(): number;
1375
- /** Checks if all items are returned regardless of search match. @keywords return, all, match, filter */
1376
- getReturnEverything(): boolean;
1377
- /** Retrieves search debounce delay in milliseconds. @keywords delay, debounce, time */
1378
- getDelay(): number;
1379
- /** Checks whether exact match searching is enabled. @keywords exact, match, strict */
1380
- getFindExactMatch(): boolean;
1381
- /** Retrieves the CSS class name used for highlighting matches. @keywords class, highlight, css */
1382
- getClassName(): string;
1383
- /** Updates search options. @keywords set, options, update */
1384
- setOptions(options: SearchOptions): this;
1385
- }
1386
-
1387
777
  type ServerStorageItem = {
1388
778
  value: any;
1389
779
  hydration: boolean;
@@ -1464,66 +854,6 @@ export declare class Translate {
1464
854
  static setConfig(config: TranslateConfig): void;
1465
855
  }
1466
856
 
1467
- /** Manages translation file loading and resolution based on language and location. @keywords translation, localization, i18n, files, translate */
1468
- export declare class TranslateFile {
1469
- /** Creates an instance of TranslateFile. @keywords constructor, init */
1470
- constructor(data?: TranslateDataFile, language?: string | (() => string), location?: string | (() => string));
1471
- /** Checks if translation files exist for the current location or language. @keywords isFile, check, exists */
1472
- isFile(): boolean;
1473
- /** Retrieves the current location identifier. @keywords getLocation, location, path */
1474
- getLocation(): string;
1475
- /** Retrieves the current active language code. @keywords getLanguage, language, locale, i18n */
1476
- getLanguage(): string;
1477
- /** Loads and returns the translation data list for the current location. @keywords getList, load, translations, async */
1478
- getList(): Promise<TranslateDataFileList | undefined>;
1479
- /** Registers additional translation file data sources. @keywords add, register, files */
1480
- add(data: TranslateDataFile): void;
1481
- }
1482
-
1483
- /** Translation management instance for fetching and resolving localized strings. @keywords translate, i18n, localization, locale */
1484
- export declare class TranslateInstance {
1485
- /** Initializes a new translation instance with optional endpoint and files. @keywords init, translate */
1486
- constructor(url?: string, propsName?: string, files?: TranslateFile);
1487
- /** Fetches translation text asynchronously by code with optional replacements. @keywords get, translate, async */
1488
- get(name: string, replacement?: string[] | Record<string, string | number>): Promise<string>;
1489
- /** Gets translation text synchronously by code with optional fallback and replacements. @keywords getSync, translate, sync */
1490
- getSync(name: string, first?: boolean, replacement?: string[] | Record<string, string | number>): string;
1491
- /** Fetches multiple translations asynchronously by code array. @keywords getList, batch, translate */
1492
- getList<T extends TranslateCode[]>(names: T): Promise<TranslateList<T>>;
1493
- /** Gets multiple translations synchronously by code array. @keywords getListSync, batch, sync */
1494
- getListSync<T extends TranslateCode[]>(names: T, first?: boolean): TranslateList<T>;
1495
- /** Adds translation codes to be loaded. @keywords add, load, translations */
1496
- add(names: string | string[]): Promise<void>;
1497
- /** Adds translation key-value pairs synchronously. @keywords addSync, register, dictionary */
1498
- addSync(data: Record<string, string>): void;
1499
- /** Adds translations via network request or directly depending on runtime environment. @keywords addNormalOrSync, environment */
1500
- addNormalOrSync(data: Record<string, string>): Promise<void>;
1501
- /** Adds translations grouped by location synchronously. @keywords addSyncByLocation, locale, location */
1502
- addSyncByLocation(data: Record<string, Record<string, string>>): void;
1503
- /** Adds translations synchronously from a file data object. @keywords addSyncByFile, file, import */
1504
- addSyncByFile(data: TranslateDataFile): void;
1505
- /** Sets the API URL endpoint for fetching translations. @keywords setUrl, config, endpoint */
1506
- setUrl(url: string): this;
1507
- /** Sets the property name used for translation lookups. @keywords setPropsName, property, config */
1508
- setPropsName(name: string): this;
1509
- /** Toggles the translation API read mode. @keywords setReadApi, mode, config */
1510
- setReadApi(value: boolean): this;
1511
- }
1512
-
1513
- /** Abstract base class managing URL-based state storage and synchronization. @keywords url, hash, query, state */
1514
- export declare abstract class UrlInstanceAbstract {
1515
- /** Retrieves stored URL state value or falls back to a default value or factory. @keywords get, url state, read */
1516
- get<T>(name: string, defaultValue?: T | (() => T)): T;
1517
- /** Updates URL state variable with a value or transformation callback. @keywords set, update, url state */
1518
- set<T>(name: string, callback: T | (() => T)): this;
1519
- /** Subscribes a listener callback to variable change events. @keywords watch, observe, listener, subscribe */
1520
- addWatch<T>(name: string, callback: (value: T) => void): this;
1521
- /** Unsubscribes a listener callback from variable change events. @keywords unwatch, unsubscribe, listener */
1522
- removeWatch<T>(name: string, callback: (value: T) => void): this;
1523
- /** Reloads and syncs state variables directly from the current URL. @keywords reload, sync, refresh */
1524
- reload(): this;
1525
- }
1526
-
1527
857
  /** Isomorphic utility class for URL parsing, manipulation, and query parameter management. @keywords url, parser, query, uri */
1528
858
  export declare class UrlItem {
1529
859
  /** Returns a request-isolated instance of UrlItem. @keywords singleton, instance, request, isolated */