@dxtmisha/functional 1.11.11 → 1.11.13

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.txt CHANGED
@@ -6,268 +6,469 @@ The following is the content of "exports" from package.json:
6
6
  {
7
7
  ".": {
8
8
  "import": "./dist/library.js",
9
- "types": "./dist/library.d.ts"
9
+ "types": "./dist/src/library.d.ts"
10
10
  },
11
11
  "./flags": {
12
12
  "import": "./dist/flags.js",
13
- "types": "./dist/flags.d.ts"
14
- },
15
- "./types/*": "./dist/*"
13
+ "types": "./dist/src/flags.d.ts"
14
+ }
16
15
  }
17
16
 
18
- // File: classes/design/DesignAbstract.d.ts
19
- /** Base class for constructor. */
17
+ // File: src/classes/design/DesignAbstract.d.ts
18
+ /**
19
+ * Constructor base class.
20
+ */
20
21
  export declare abstract class DesignAbstract<T extends Record<string, any>, C extends Record<string, any>> {
21
22
  /**
23
+ * Constructor.
22
24
  * @param props base data
23
- * @param callback callback on change
24
- * @param changed data for tracking
25
+ * @param callback callback for value changes
26
+ * @param changed tracking data
25
27
  */
26
28
  constructor(props: T, callback?: ((event: C) => void) | undefined, changed?: string[]);
27
- /** Calls the callback function. */
29
+ /**
30
+ * Calls callback.
31
+ * @param compelled forces update
32
+ */
28
33
  make(compelled?: boolean): this;
29
- /** Calls the callback function. */
34
+ /**
35
+ * Calls callback.
36
+ * @param compelled forces update
37
+ */
30
38
  makeCallback(compelled?: boolean): void;
31
39
  }
32
- // File: classes/design/DesignAsyncAbstract.d.ts
33
- /** Base class for constructor. */
40
+
41
+
42
+ // File: src/classes/design/DesignAsyncAbstract.d.ts
43
+ /**
44
+ * Async constructor base class.
45
+ */
34
46
  export declare abstract class DesignAsyncAbstract<T extends Record<string, any>, C extends Record<string, any>> extends DesignAbstract<T, C> {
35
- /** Calls the callback function. */
47
+ /**
48
+ * Calls callback.
49
+ * @param compelled forces update
50
+ */
36
51
  make(compelled?: boolean): this;
37
- /** Calls the callback function. */
52
+ /**
53
+ * Calls callback.
54
+ * @param compelled forces update
55
+ */
38
56
  makeCallback(compelled?: boolean): Promise<void>;
39
57
  }
40
- // File: classes/design/DesignChanged.d.ts
41
- /** Checks edited values. */
58
+
59
+
60
+ // File: src/classes/design/DesignChanged.d.ts
61
+ /**
62
+ * Tracks edited values.
63
+ */
42
64
  export declare class DesignChanged<T extends Record<string, any>> {
43
65
  /**
66
+ * Constructor.
44
67
  * @param props base data
45
68
  * @param watch tracking data
46
69
  */
47
70
  constructor(props: T, watch?: string[]);
48
- /** Check if value updated. */
71
+ /**
72
+ * Check if value updated.
73
+ * @param name property name
74
+ */
49
75
  is(name: string | string[]): boolean;
50
- /** Check for data changes. */
76
+ /**
77
+ * Check for changes.
78
+ */
51
79
  isChanged(): boolean;
52
- /** Updates all values. */
80
+ /**
81
+ * Update all values.
82
+ */
53
83
  update(): void;
54
84
  }
55
- // File: classes/design/DesignComp.d.ts
85
+
86
+
87
+ // File: src/classes/design/DesignComp.d.ts
56
88
  export declare class DesignComp<COMP extends ConstrComponent, P extends ConstrItem> extends DesignComponents<COMP, P> {
57
89
  }
58
- // File: classes/design/DesignComponents.d.ts
59
- /** Class for connected components. */
90
+
91
+
92
+ // File: src/classes/design/DesignComponents.d.ts
93
+ /**
94
+ * Manages connected components.
95
+ */
60
96
  export declare class DesignComponents<COMP extends ConstrComponent, P extends ConstrItem> {
61
97
  /**
62
- * @param components connected components
98
+ * Constructor.
99
+ * @param components component list
63
100
  * @param modification modification data
64
101
  */
65
102
  constructor(components?: COMP, modification?: ConstrComponentMod<P> | undefined);
66
- /** Check component presence. */
103
+ /**
104
+ * Check component presence.
105
+ * @param name component name
106
+ */
67
107
  is<K extends keyof COMP>(name: K): name is K;
68
- /** Get component object. */
108
+ /**
109
+ * Get component object.
110
+ * @param name component name
111
+ */
69
112
  get<K extends keyof COMP>(name: K): COMP[K];
70
- /** Returns modified input data. */
113
+ /**
114
+ * Get modified input data.
115
+ * @param index data name
116
+ * @param props basic data
117
+ */
71
118
  getModification<K extends keyof P>(index?: K & string | string, props?: P[K] | Record<string, any>): Record<string, any> | undefined;
72
- /** Render component by name as array. */
119
+ /**
120
+ * Render component.
121
+ * @param name component name
122
+ * @param props component props
123
+ * @param children sub-elements
124
+ * @param index key name
125
+ */
73
126
  render<K extends keyof COMP, PK extends keyof P>(name: K & string, props?: P[PK] & ConstrItem | ConstrItem, children?: RawChildren | RawSlots, index?: PK & string | string): VNode[];
74
- /** Render single component by name. */
127
+ /**
128
+ * Render single component.
129
+ */
75
130
  renderOne<K extends keyof COMP, PK extends keyof P>(name: K & string, props?: P[PK] & ConstrItem | ConstrItem, children?: RawChildren | RawSlots, index?: PK & string | string): VNode | undefined;
76
- /** Render component and add to array. */
131
+ /**
132
+ * Render and add to array.
133
+ */
77
134
  renderAdd<K extends keyof COMP, PK extends keyof P>(item: any[], name: K & string, props?: P[PK] & ConstrItem | ConstrItem, children?: RawChildren | RawSlots, index?: PK & string | string): this;
78
135
  }
79
- // File: classes/design/DesignConstructorAbstract.d.ts
80
- /** Class for collecting functional components. */
136
+
137
+
138
+ // File: src/classes/design/DesignConstructorAbstract.d.ts
139
+ /**
140
+ * Collects functional components.
141
+ */
81
142
  export declare abstract class DesignConstructorAbstract<E extends Element, COMP extends ConstrComponent, EMITS extends ConstrItem, EXPOSE extends ConstrItem, SLOTS extends ConstrItem, CLASSES extends ConstrClasses, P extends ConstrItem> {
82
- /** Get class name. */
143
+ /**
144
+ * Get class name.
145
+ */
83
146
  getName(): string;
84
- /** Get design name. */
147
+ /**
148
+ * Get design name.
149
+ */
85
150
  getDesign(): string;
86
- /** Get sub-class name. */
151
+ /**
152
+ * Get sub-level class name.
153
+ */
87
154
  getSubClass(name: string | string[]): string;
88
- /** Get status class name. */
155
+ /**
156
+ * Get status class name.
157
+ */
89
158
  getStatusClass(name: string | string[]): string;
90
- /** Get style property name. */
159
+ /**
160
+ * Get style property name.
161
+ */
91
162
  getStyle(name: string | string[]): string;
92
- /** Get additional parameters. */
163
+ /**
164
+ * Get additional attributes.
165
+ */
93
166
  getAttrs(): ConstrItem;
94
- /** List external variables. */
167
+ /**
168
+ * External variables list.
169
+ */
95
170
  expose(): ConstrExpose<E, EXPOSE>;
96
- /** Render method for setup. */
171
+ /**
172
+ * Rendering for setup.
173
+ */
97
174
  render(): () => VNode | (VNode | any)[] | undefined;
98
175
  }
99
- // File: classes/ref/DatetimeRef.d.ts
100
- /** Class for date operations. */
176
+
177
+
178
+ // File: src/classes/ref/DatetimeRef.d.ts
179
+ /**
180
+ * Date management class.
181
+ */
101
182
  export declare class DatetimeRef {
102
183
  /**
103
- * @param date processing date
104
- * @param type output format type
105
- * @param code country/language code
184
+ * Constructor.
185
+ * @param date date
186
+ * @param type output format
187
+ * @param code country code
106
188
  */
107
189
  constructor(date: RefOrNormal<NumberOrStringOrDate>, type?: RefOrNormal<GeoDate>, code?: RefOrNormal<string>);
108
- /** Get base date data. */
190
+ /**
191
+ * Get basic date data.
192
+ */
109
193
  getItem(): Ref<NumberOrStringOrDate>;
110
- /** Get Date object. */
194
+ /**
195
+ * Get Date object.
196
+ */
111
197
  getDate(): Ref<Date>;
112
- /** Get Datetime instance. */
198
+ /**
199
+ * Get Datetime class instance.
200
+ */
113
201
  getDatetime(): Datetime;
114
- /** Get hours format. */
202
+ /**
203
+ * Get hours format.
204
+ */
115
205
  getHoursType(): ComputedRef<GeoHours>;
116
- /** Get first day of week code. */
206
+ /**
207
+ * Get first day of week code.
208
+ */
117
209
  getFirstDayCode(): ComputedRef<GeoFirstDay>;
118
- /** Get year from date. */
210
+ /**
211
+ * Get year.
212
+ */
119
213
  getYear(): ComputedRef<number>;
120
- /** Get month (0-indexed). */
214
+ /**
215
+ * Get zero-based month.
216
+ */
121
217
  getMonth(): ComputedRef<number>;
122
- /** Get day of month. */
218
+ /**
219
+ * Get day of month.
220
+ */
123
221
  getDay(): ComputedRef<number>;
124
- /** Get hour. */
222
+ /**
223
+ * Get hours.
224
+ */
125
225
  getHour(): ComputedRef<number>;
126
- /** Get minutes. */
226
+ /**
227
+ * Get minutes.
228
+ */
127
229
  getMinute(): ComputedRef<number>;
128
- /** Get seconds. */
230
+ /**
231
+ * Get seconds.
232
+ */
129
233
  getSecond(): ComputedRef<number>;
130
- /** Get last day of week. */
234
+ /**
235
+ * Get last day of month.
236
+ */
131
237
  getMaxDay(): ComputedRef<number>;
132
- /** Locale-sensitive formatting. */
238
+ /**
239
+ * Locale-sensitive date formatting.
240
+ */
133
241
  locale(type?: GeoDate, styleOptions?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions): ComputedRef<string>;
134
- /** Standard data output. */
242
+ /**
243
+ * Standard data output.
244
+ */
135
245
  standard(timeZone?: boolean): ComputedRef<string>;
136
246
  }
137
- // File: classes/ref/EffectScopeGlobal.d.ts
138
- /** Global effect scope. */
247
+
248
+
249
+ // File: src/classes/ref/EffectScopeGlobal.d.ts
250
+ /**
251
+ * Global effect scope.
252
+ */
139
253
  export declare class EffectScopeGlobal {
140
- /** Run function in global scope. */
254
+ /**
255
+ * Run function in global scope.
256
+ * @returns function return value
257
+ */
141
258
  static run<T>(fn: () => T): T | undefined;
142
259
  }
143
- // File: classes/ref/EventRef.d.ts
144
- /** Reactive event handler. */
260
+
261
+
262
+ // File: src/classes/ref/EventRef.d.ts
263
+ /**
264
+ * Event management class (Ref).
265
+ */
145
266
  export declare class EventRef<E extends ElementOrWindow, O extends Event, D extends Record<string, any> = Record<string, any>> extends EventItem<E, O, D> {
267
+ /**
268
+ * Constructor.
269
+ */
146
270
  constructor(elementSelector?: RefOrNormal<ElementOrString<E> | undefined>, elementSelectorControl?: RefOrNormal<ElementOrString<HTMLElement>>, type?: string | string[], listener?: EventListenerDetail<O, D>, options?: EventOptions, detail?: D);
147
271
  }
148
- // File: classes/ref/GeoFlagRef.d.ts
149
- /** Flag management. */
272
+
273
+
274
+ // File: src/classes/ref/GeoFlagRef.d.ts
275
+ /**
276
+ * Flag management class.
277
+ */
150
278
  export declare class GeoFlagRef {
151
- /** @param code country code */
279
+ /**
280
+ * Constructor.
281
+ * @param code country code
282
+ */
152
283
  constructor(code?: RefOrNormal<string>);
153
- /** Get reactive country code. */
284
+ /**
285
+ * Get reactive country code.
286
+ */
154
287
  getCode(): Ref<string>;
155
- /** Get country/flag info. */
288
+ /**
289
+ * Get country and flag info.
290
+ */
156
291
  get(code?: string): ComputedRef<GeoFlagItem | undefined>;
157
- /** Get flag URL. */
292
+ /**
293
+ * Get flag link.
294
+ */
158
295
  getFlag(code?: string): ComputedRef<string | undefined>;
159
- /** Get list of countries by codes. */
296
+ /**
297
+ * Get list of countries by codes.
298
+ */
160
299
  getList(codes?: string[]): ComputedRef<GeoFlagItem[]>;
161
- /** Get list in national language. */
300
+ /**
301
+ * Get list in national language.
302
+ */
162
303
  getNational(codes?: string[]): ComputedRef<GeoFlagNational[]>;
163
304
  }
164
- // File: classes/ref/GeoIntlRef.d.ts
165
- /** Reactive number and date formatting. */
305
+
306
+
307
+ // File: src/classes/ref/GeoIntlRef.d.ts
308
+ /**
309
+ * Reactive numbers and dates formatting.
310
+ */
166
311
  export declare class GeoIntlRef {
167
- /** @param code language/country code */
312
+ /**
313
+ * Constructor.
314
+ * @param code country code
315
+ */
168
316
  constructor(code?: RefOrNormal<string>);
169
- /** Translation of display names. */
317
+ /**
318
+ * Translate display names.
319
+ */
170
320
  display(value?: RefOrNormal<string>, typeOptions?: Intl.DisplayNamesOptions['type'] | Intl.DisplayNamesOptions): ComputedRef<string>;
171
- /** Get language names. */
321
+ /**
322
+ * Get language names.
323
+ */
172
324
  languageName(value?: RefOrNormal<string>, style?: Intl.RelativeTimeFormatStyle): ComputedRef<string>;
173
- /** Get region names. */
325
+ /**
326
+ * Get region names.
327
+ */
174
328
  countryName(value?: RefOrNormal<string>, style?: Intl.RelativeTimeFormatStyle): ComputedRef<string>;
175
- /** Format number. */
329
+ /**
330
+ * Number formatting.
331
+ */
176
332
  number(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
177
- /** Decimal point. */
333
+ /**
334
+ * Decimal point symbol.
335
+ */
178
336
  decimal(): ComputedRef<string>;
179
- /** Format currency. */
337
+ /**
338
+ * Currency formatting.
339
+ */
180
340
  currency(value: RefOrNormal<NumberOrString>, currencyOptions?: RefOrNormal<string | Intl.NumberFormatOptions>, numberOnly?: boolean): ComputedRef<string>;
181
- /** Get currency symbol. */
341
+ /**
342
+ * Get currency symbol or code.
343
+ */
182
344
  currencySymbol(currency: RefOrNormal<string>, currencyDisplay?: keyof Intl.NumberFormatOptionsCurrencyDisplayRegistry): ComputedRef<string>;
183
- /** Format units. */
345
+ /**
346
+ * Unit formatting.
347
+ */
184
348
  unit(value: RefOrNormal<NumberOrString>, unitOptions?: string | Intl.NumberFormatOptions): ComputedRef<string>;
185
- /** Format file size. */
349
+ /**
350
+ * File size formatting.
351
+ */
186
352
  sizeFile(value: RefOrNormal<NumberOrString>, unitOptions?: 'byte' | 'kilobyte' | 'megabyte' | 'gigabyte' | 'terabyte' | 'petabyte' | Intl.NumberFormatOptions): ComputedRef<string>;
187
- /** Format percentage. */
353
+ /**
354
+ * Percentage formatting.
355
+ */
188
356
  percent(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
189
- /** Format percentage (unit). */
357
+ /**
358
+ * Percentage formatting (unit).
359
+ */
190
360
  percentBy100(value: RefOrNormal<NumberOrString>, options?: Intl.NumberFormatOptions): ComputedRef<string>;
191
- /** Pluralization rules. */
361
+ /**
362
+ * Plural rules formatting.
363
+ */
192
364
  plural(value: RefOrNormal<NumberOrString>, words: string, options?: Intl.PluralRulesOptions, optionsNumber?: Intl.NumberFormatOptions): ComputedRef<string>;
193
- /** Format date/time. */
365
+ /**
366
+ * Date/time formatting.
367
+ */
194
368
  date(value: RefOrNormal<NumberOrStringOrDate>, type?: GeoDate, styleOptions?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions, hour24?: boolean): ComputedRef<string>;
195
- /** Format relative time. */
369
+ /**
370
+ * Relative time formatting.
371
+ */
196
372
  relative(value: RefOrNormal<NumberOrStringOrDate>, styleOptions?: Intl.RelativeTimeFormatStyle | Intl.RelativeTimeFormatOptions, todayValue?: Date): ComputedRef<string>;
197
- /** Format relative time with limit. */
373
+ /**
374
+ * Relative time with standard limit.
375
+ */
198
376
  relativeLimit(value: RefOrNormal<NumberOrStringOrDate>, limit: number, todayValue?: Date, relativeOptions?: Intl.RelativeTimeFormatStyle | Intl.RelativeTimeFormatOptions, dateOptions?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions, type?: GeoDate, hour24?: boolean): ComputedRef<string>;
199
- /** Format elapsed time. */
377
+ /**
378
+ * Elapsed time formatting.
379
+ */
200
380
  relativeByValue(value: RefOrNormal<NumberOrString>, unit: Intl.RelativeTimeFormatUnit, styleOptions?: Intl.RelativeTimeFormatStyle | Intl.RelativeTimeFormatOptions): ComputedRef<string>;
201
- /** Month name. */
381
+ /**
382
+ * Month names.
383
+ */
202
384
  month(value?: RefOrNormal<NumberOrStringOrDate>, style?: Intl.DateTimeFormatOptions['month']): ComputedRef<string>;
203
- /** List of months. */
385
+ /**
386
+ * List of months.
387
+ */
204
388
  months(style?: Intl.DateTimeFormatOptions['month']): ComputedRef<ItemValue<number | undefined>[]>;
205
- /** Day of week name. */
389
+ /**
390
+ * Weekday names.
391
+ */
206
392
  weekday(value?: RefOrNormal<NumberOrStringOrDate>, style?: Intl.DateTimeFormatOptions['weekday']): ComputedRef<string>;
207
- /** List of weekdays. */
393
+ /**
394
+ * List of weekdays.
395
+ */
208
396
  weekdays(style?: Intl.DateTimeFormatOptions['weekday']): ComputedRef<ItemValue<number | undefined>[]>;
209
- /** Time string. */
397
+ /**
398
+ * Time formatting.
399
+ */
210
400
  time(value: RefOrNormal<NumberOrStringOrDate>): ComputedRef<string>;
211
- /** Sort strings by locale. */
401
+ /**
402
+ * Country-aware string sorting.
403
+ */
212
404
  sort<T>(data: RefOrNormal<T[]>, compareFn?: (a: T, b: T) => [string, string]): ComputedRef<T[]>;
213
405
  }
214
- // File: classes/ref/GeoRef.d.ts
215
- /** Reactive geography management. */
406
+
407
+
408
+ // File: src/classes/ref/GeoRef.d.ts
409
+ /**
410
+ * Reactive geographic data.
411
+ */
216
412
  export declare class GeoRef {
217
- /** Get full geographic info. */
413
+ /**
414
+ * Current country info.
415
+ */
218
416
  static get(): Ref<GeoItemFull>;
219
- /** Get current country. */
417
+ /**
418
+ * Current country code.
419
+ */
220
420
  static getCountry(): ComputedRef<string>;
221
- /** Get current language. */
421
+ /**
422
+ * Current language code.
423
+ */
222
424
  static getLanguage(): ComputedRef<string>;
223
- /** Get locale format. */
425
+ /**
426
+ * Full standard locale.
427
+ */
224
428
  static getStandard(): ComputedRef<string>;
225
- /** Get first day of week. */
429
+ /**
430
+ * Get first day of week.
431
+ */
226
432
  static getFirstDay(): ComputedRef<string>;
227
- /** Set data by code. */
433
+ /**
434
+ * Set data by code.
435
+ */
228
436
  static set(code: string): void;
229
437
  }
230
- // File: classes/ref/ListDataRef.d.ts
231
- /** List data management. */
438
+
439
+
440
+ // File: src/classes/ref/ListDataRef.d.ts
441
+ /**
442
+ * List data management.
443
+ */
232
444
  export declare class ListDataRef {
233
445
  /**
234
- * @param list data
235
- * @param focus focused item
236
- * @param highlight search text
237
- * @param highlightLengthStart min length for highlight
238
- * @param filterMode filtering mode
239
- * @param selected selected items
240
- * @param keyValue value key
241
- * @param keyLabel label key
242
- * @param lite lite mode threshold
243
- * @param min min selection
244
- * @param max max selection
245
- * @param parent parent ID
446
+ * Constructor.
246
447
  */
247
448
  constructor(list: RefOrNormal<ListListInput | undefined>, focus?: RefType<ListSelectedItem | undefined> | undefined, highlight?: RefType<string | undefined> | undefined, highlightLengthStart?: RefType<number | undefined> | undefined, filterMode?: RefType<boolean | undefined> | undefined, selected?: RefType<ListSelectedList | undefined> | undefined, keyValue?: RefType<string | undefined> | undefined, keyLabel?: RefType<string | undefined> | undefined, lite?: RefType<number | undefined> | undefined, min?: RefOrNormal<number | string | undefined>, max?: RefOrNormal<number | string | undefined>, parent?: string | undefined);
248
449
  /** List for rendering. */
249
450
  readonly data: ComputedRef<ListList>;
250
- /** Lite list for loading. */
451
+ /** Simplified list. */
251
452
  readonly liteData: ComputedRef<ListList>;
252
- /** Full data with state. */
453
+ /** Full list with state. */
253
454
  readonly fullData: ComputedRef<ListDataFull>;
254
- /** Flat map of entries. */
455
+ /** Flat map of all entries. */
255
456
  readonly map: ComputedRef<ListList>;
256
- /** Map of items only. */
457
+ /** Only items map. */
257
458
  readonly mapItems: ComputedRef<ListList>;
258
- /** Selection values list. */
459
+ /** Selection items. */
259
460
  readonly items: ComputedRef<ListList>;
260
- /** Index of first match. */
461
+ /** First search result index. */
261
462
  readonly highlightFirstItem: ComputedRef<number>;
262
- /** If selection exists. */
463
+ /** Has selection. */
263
464
  readonly isSelected: ComputedRef<boolean>;
264
465
  /** Min selection reached. */
265
466
  readonly isSelectedMin: ComputedRef<boolean>;
266
467
  /** Max selection reached. */
267
468
  readonly isSelectedMax: ComputedRef<boolean>;
268
- /** Selected items map. */
469
+ /** Map of selected items. */
269
470
  readonly selectedList: ComputedRef<ListList>;
270
- /** Selected in group. */
471
+ /** Selected items in group. */
271
472
  readonly selectedListInGroup: ComputedRef<ListList>;
272
473
  /** Selected labels. */
273
474
  readonly selectedNames: ComputedRef<ListNames>;
@@ -275,25 +476,27 @@ export declare class ListDataRef {
275
476
  readonly selectedValues: ComputedRef<any[]>;
276
477
  /** Is lite mode active. */
277
478
  isLite(): boolean;
278
- /** Is focus present. */
479
+ /** Is focus active. */
279
480
  isFocus(): boolean;
280
- /** Is result highlighted. */
481
+ /** Is highlight active. */
281
482
  isHighlight(): boolean;
282
- /** Is highlighting active. */
483
+ /** Is minimum highlight length reached. */
283
484
  isHighlightActive(): boolean;
284
- /** Get count. */
485
+ /** Current list length. */
285
486
  getLength(): number;
286
- /** Get total map count. */
487
+ /** Map length. */
287
488
  getLengthByMap(): number;
288
- /** Get items count. */
489
+ /** Items length. */
289
490
  getLengthByItems(): number;
290
- /** Get focused ID. */
491
+ /** Get focus identifier. */
291
492
  getFocus(): ListSelectedItem | undefined;
493
+ /** Get focus item. */
494
+ getFocusItem(): ListDataItem | undefined;
292
495
  /** Get highlight text. */
293
496
  getHighlight(): string | undefined;
294
497
  /** Get min highlight length. */
295
498
  getHighlightLengthStart(): number;
296
- /** Get selected list. */
499
+ /** Get selected IDs. */
297
500
  getSelected(): ListSelectedList | undefined;
298
501
  /** Get item by relative step. */
299
502
  getSelectedByStep(step: number): ListSelectedItem | undefined;
@@ -301,79 +504,112 @@ export declare class ListDataRef {
301
504
  getSelectedNext(): ListSelectedItem | undefined;
302
505
  /** Get previous item. */
303
506
  getSelectedPrev(): ListSelectedItem | undefined;
304
- /** Get item by step from ref. */
507
+ /** Move step from item. */
305
508
  getItemByStep(item: ListDataItem, step: number): ListDataItem | undefined;
306
- /** Get next item from ref. */
509
+ /** Get next item from item. */
307
510
  getItemNext(item: ListDataItem): ListDataItem | undefined;
308
- /** Get previous item from ref. */
511
+ /** Get previous item from item. */
309
512
  getItemPrev(item: ListDataItem): ListDataItem | undefined;
310
- /** Get item by index step. */
513
+ /** Move step from index. */
311
514
  getIndexByStep(index: string, step: number): ListDataItem | undefined;
312
- /** Get next item from index. */
515
+ /** Next from index. */
313
516
  getIndexNext(index: string): ListDataItem | undefined;
314
- /** Get previous item from index. */
517
+ /** Previous from index. */
315
518
  getIndexPrev(index: string): ListDataItem | undefined;
316
- /** Get item details by index. */
519
+ /** Get item by index. */
317
520
  getItemByIndex(index?: string): {
318
521
  key: number;
319
522
  item: ListDataItem;
320
523
  } | undefined;
321
524
  /** Get item by key. */
322
525
  getItemByKey(key: number): ListDataItem | undefined;
323
- /** Get first child of parent. */
526
+ /** First item in parent. */
324
527
  getFirstItemByParent(parent: string | undefined): ListDataItem | undefined;
325
- /** Get last child of parent. */
528
+ /** Last item in parent. */
326
529
  getLastItemByParent(parent: string | undefined): ListDataItem | undefined;
327
- /** Get sublist instance. */
530
+ /** Get sublist for group. */
328
531
  getSubList(item: ListDataItem): ListDataRef;
329
532
  }
330
- // File: classes/ref/RouterItemRef.d.ts
331
- /** Router management. */
533
+
534
+
535
+ // File: src/classes/ref/RouterItemRef.d.ts
536
+ /**
537
+ * Router management.
538
+ */
332
539
  export declare class RouterItemRef {
333
- /** Get router. */
540
+ /** Get router instance. */
334
541
  static get(): Router;
335
542
  /** Get link by name. */
336
543
  static getLink(name: string, params?: any, query?: any): string | undefined;
337
- /** Get href props by name. */
544
+ /** Get href props. */
338
545
  static getHref(name?: string, params?: any, query?: any): ConstrHrefProps;
339
- /** Change route. */
546
+ /** Change path. */
340
547
  static push(to: string | RouteLocationRaw): void;
341
- /** Set router. */
548
+ /** Set router instance. */
342
549
  static set(router: Router): void;
343
550
  /** Set router once. */
344
551
  static setOneTime(router: Router): void;
345
- /** Raw to href conversion. */
552
+ /** Raw to href props. */
346
553
  static rawToHref(to?: string | RouteLocationRaw): ConstrHrefProps;
347
554
  }
348
- // File: classes/ref/ScrollbarWidthRef.d.ts
349
- /** Reactive scroll width. */
555
+
556
+
557
+ // File: src/classes/ref/ScrollbarWidthRef.d.ts
558
+ /**
559
+ * Reactive scroll width.
560
+ */
350
561
  export declare class ScrollbarWidthRef {
351
562
  readonly item: Ref<boolean | undefined, boolean | undefined>;
352
563
  readonly width: Ref<number, number>;
353
564
  constructor();
565
+ /** Width defined. */
354
566
  readonly is: ComputedRef<boolean>;
355
567
  }
356
- // File: composables/ref/useApiAsyncRef.d.ts
357
- /** Async API request initialization. */
358
- export declare function useApiAsyncRef<R, T = R>(path?: RefOrNormal<string | undefined>, options?: ApiOptions, reactivity?: boolean, conditions?: RefType<boolean>, transformation?: (data: T, isResponseContractValid?: ApiDataValidation) => ApiData<R>, validateResponseContract?: (data: T) => ApiDataValidation, unmounted?: boolean, apiInstance?: ApiInstance): UseApiRef<R>;
359
- // File: composables/ref/useApiDelete.d.ts
360
- /** API delete request hook. */
361
- export declare function useApiDelete<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
568
+
569
+
570
+ // File: src/composables/ref/useApiAsyncRef.d.ts
571
+ /**
572
+ * Async reactive API request with SSR support.
573
+ * @remarks Use for server-side pre-fetching.
574
+ * @example
575
+ * ```typescript
576
+ * const { data, loading } = useApiAsyncRef('/users/1')
577
+ * ```
578
+ */
579
+ export declare function useApiAsyncRef<R, T = R>(path?: RefOrNormal<string | undefined>, options?: ApiOptions, reactivity?: boolean, conditions?: RefType<boolean>, transformation?: (data: T, isResponseContractValid?: ApiDataValidation) => ApiData<R>, validateResponseContract?: (data: T) => ApiDataValidation, errorContract?: ApiErrorStorageList, unmounted?: boolean, apiInstance?: ApiInstance): UseApiRef<R>;
580
+
581
+
582
+ // File: src/composables/ref/useApiDelete.d.ts
583
+ /**
584
+ * API DELETE request wrapper.
585
+ */
586
+ export declare function useApiDelete<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, errorContract?: ApiErrorStorageList, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
362
587
  loading: Ref<boolean, boolean>;
363
588
  send(request?: Request | undefined): Promise<Return | undefined>;
364
589
  };
365
- // File: composables/ref/useApiGet.d.ts
366
- /** API get request hook. */
367
- export declare function useApiGet<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
590
+
591
+
592
+ // File: src/composables/ref/useApiGet.d.ts
593
+ /**
594
+ * API GET request wrapper.
595
+ */
596
+ export declare function useApiGet<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, errorContract?: ApiErrorStorageList, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
368
597
  loading: Ref<boolean, boolean>;
369
598
  send(request?: Request | undefined): Promise<Return | undefined>;
370
599
  };
371
- // File: composables/ref/useApiManagementAsyncRef.d.ts
372
- /** Async API management hook. */
600
+
601
+
602
+ // File: src/composables/ref/useApiManagementAsyncRef.d.ts
603
+ /**
604
+ * Async API management with SSR support.
605
+ */
373
606
  export declare function useApiManagementAsyncRef<Return extends ApiManagementValue, FormattersOptions extends FormattersOptionsList, Post extends Record<string, any>, Put extends Record<string, any>, Delete extends Record<string, any>, Type extends ApiManagementValue = Return, Item extends ArrayToItem<Return> = ArrayToItem<Return>, ItemFormatters extends FormattersListColumns<Item, FormattersOptions>[number] = FormattersListColumns<Item, FormattersOptions>[number], Columns extends SearchColumns<ItemFormatters> = []>(propsGet: ApiManagementGet<Return, Type>, formattersOptions?: FormattersOptions, searchOptions?: ApiManagementSearch<Item, Columns>, postRequest?: ApiManagementRequest<Post>, putRequest?: ApiManagementRequest<Put>, deleteRequest?: ApiManagementRequest<Delete>, action?: () => Promise<void> | void, apiInstance?: ApiInstance): {
374
607
  isValid: ComputedRef<boolean>;
608
+ isResponseContractValid: ComputedRef<boolean>;
609
+ responseValidationResult: ComputedRef< ApiDataValidation | undefined>;
375
610
  list: ComputedRef<SearchFormatList<ItemFormatters, Columns>>;
376
611
  readonly data: ComputedRef< ApiData<Return> | undefined>;
612
+ errorItem: ComputedRef< ApiErrorItem | undefined>;
377
613
  readonly length: ComputedRef<number>;
378
614
  lengthData: ComputedRef<number>;
379
615
  starting: ComputedRef<boolean>;
@@ -384,7 +620,7 @@ export declare function useApiManagementAsyncRef<Return extends ApiManagementVal
384
620
  loadingPut: Ref<boolean, boolean> | undefined;
385
621
  loadingDelete: Ref<boolean, boolean> | undefined;
386
622
  isSearch: ComputedRef<boolean> | undefined;
387
- search: Ref<string, string> | undefined;
623
+ search: Ref<string>;
388
624
  init: () => void;
389
625
  initSsr: () => void;
390
626
  reset: () => Promise<void>;
@@ -393,23 +629,26 @@ export declare function useApiManagementAsyncRef<Return extends ApiManagementVal
393
629
  sendPut: (request?: ApiFetch["request"]) => Promise< ApiData<Put> | undefined>;
394
630
  sendDelete: (request?: ApiFetch["request"]) => Promise< ApiData<Delete> | undefined>;
395
631
  };
396
- // File: composables/ref/useApiManagementRef.d.ts
632
+
633
+
634
+ // File: src/composables/ref/useApiManagementRef.d.ts
397
635
  /**
398
- * Composable for comprehensive API request orchestration (GET, Search, Mutations).
399
- * @note Use with `executeUse` for central state.
400
- * @remarks Recommended for values; avoid for logic-critical IDs.
636
+ * Orchestrates API loading, formatting, searching, and mutations.
637
+ * @note Use with `executeUse` for global state.
638
+ * @remarks
639
+ * Formatters guidelines:
640
+ * - Recommended: Values, dates, currency.
641
+ * - Not recommended: Tech IDs, UUIDs.
401
642
  * @example
402
- * const products = useApiManagementRef(
403
- * { path: '/api/v1/products', skeleton: () => [] },
404
- * { price: (v) => `${v} USD` },
405
- * { columns: ['name'] },
406
- * { path: '/api/v1/products' }
407
- * );
643
+ * const products = useApiManagementRef({ path: '/api/v1/products' });
408
644
  */
409
645
  export declare function useApiManagementRef<Return extends ApiManagementValue, FormattersOptions extends FormattersOptionsList, Post extends Record<string, any>, Put extends Record<string, any>, Delete extends Record<string, any>, Type extends ApiManagementValue = Return, Item extends ArrayToItem<Return> = ArrayToItem<Return>, ItemFormatters extends FormattersListColumns<Item, FormattersOptions>[number] = FormattersListColumns<Item, FormattersOptions>[number], Columns extends SearchColumns<ItemFormatters> = []>(propsGet: ApiManagementGet<Return, Type>, formattersOptions?: FormattersOptions, searchOptions?: ApiManagementSearch<Item, Columns>, postRequest?: ApiManagementRequest<Post>, putRequest?: ApiManagementRequest<Put>, deleteRequest?: ApiManagementRequest<Delete>, action?: () => Promise<void> | void, apiInstance?: ApiInstance): {
410
646
  isValid: ComputedRef<boolean>;
647
+ isResponseContractValid: ComputedRef<boolean>;
648
+ responseValidationResult: ComputedRef< ApiDataValidation | undefined>;
411
649
  list: ComputedRef<SearchFormatList<ItemFormatters, Columns>>;
412
650
  readonly data: ComputedRef<ApiData<Return> | undefined>;
651
+ errorItem: ComputedRef< ApiErrorItem | undefined>;
413
652
  readonly length: ComputedRef<number>;
414
653
  lengthData: ComputedRef<number>;
415
654
  starting: ComputedRef<boolean>;
@@ -420,7 +659,7 @@ export declare function useApiManagementRef<Return extends ApiManagementValue, F
420
659
  loadingPut: Ref<boolean, boolean> | undefined;
421
660
  loadingDelete: Ref<boolean, boolean> | undefined;
422
661
  isSearch: ComputedRef<boolean> | undefined;
423
- search: Ref<string, string> | undefined;
662
+ search: Ref<string>;
424
663
  init: () => void;
425
664
  initSsr: () => void;
426
665
  reset: () => Promise<void>;
@@ -429,22 +668,36 @@ export declare function useApiManagementRef<Return extends ApiManagementValue, F
429
668
  sendPut: (request?: ApiFetch["request"]) => Promise<ApiData<Put> | undefined>;
430
669
  sendDelete: (request?: ApiFetch["request"]) => Promise<ApiData<Delete> | undefined>;
431
670
  };
432
- // File: composables/ref/useApiPost.d.ts
433
- /** API post request hook. */
434
- export declare function useApiPost<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
671
+
672
+
673
+ // File: src/composables/ref/useApiPost.d.ts
674
+ /**
675
+ * API POST request wrapper.
676
+ */
677
+ export declare function useApiPost<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, errorContract?: ApiErrorStorageList, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
435
678
  loading: Ref<boolean, boolean>;
436
679
  send(request?: Request | undefined): Promise<Return | undefined>;
437
680
  };
438
- // File: composables/ref/useApiPut.d.ts
439
- /** API put request hook. */
440
- export declare function useApiPut<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
681
+
682
+
683
+ // File: src/composables/ref/useApiPut.d.ts
684
+ /**
685
+ * API PUT request wrapper.
686
+ */
687
+ export declare function useApiPut<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, errorContract?: ApiErrorStorageList, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
441
688
  loading: Ref<boolean, boolean>;
442
689
  send(request?: Request | undefined): Promise<Return | undefined>;
443
690
  };
444
- // File: composables/ref/useApiRef.d.ts
691
+
692
+
693
+ // File: src/composables/ref/useApiRef.d.ts
694
+ /**
695
+ * useApiRef return interface.
696
+ */
445
697
  export interface UseApiRef<R> {
446
698
  data: ComputedRef<ApiData<R> | undefined>;
447
699
  item: Ref<ApiData<R> | undefined>;
700
+ errorItem: ComputedRef<ApiErrorItem | undefined>;
448
701
  isResponseContractValid: ComputedRef<boolean>;
449
702
  responseValidationResult: ComputedRef<ApiDataValidation | undefined>;
450
703
  length: ComputedRef<number>;
@@ -461,46 +714,83 @@ export interface UseApiRef<R> {
461
714
  stop(): void;
462
715
  abort(): void;
463
716
  }
464
- /** Reactive API requester. */
465
- export declare function useApiRef<R, T = R>(path?: RefOrNormal<string | undefined>, options?: ApiOptions, reactivity?: boolean, conditions?: RefType<boolean>, transformation?: (data: T, isResponseContractValid?: ApiDataValidation) => ApiData<R>, validateResponseContract?: (data: T) => ApiDataValidation, unmounted?: boolean, apiInstance?: ApiInstance): UseApiRef<R>;
466
- /** Global API request conditions. */
717
+ /**
718
+ * Reactive API request handler.
719
+ * @example
720
+ * ```typescript
721
+ * const { data, loading } = useApiRef('/users/1')
722
+ * ```
723
+ */
724
+ export declare function useApiRef<R, T = R>(path?: RefOrNormal<string | undefined>, options?: ApiOptions, reactivity?: boolean, conditions?: RefType<boolean>, transformation?: (data: T, isResponseContractValid?: ApiDataValidation) => ApiData<R>, validateResponseContract?: (data: T) => ApiDataValidation, errorContract?: ApiErrorStorageList, unmounted?: boolean, apiInstance?: ApiInstance): UseApiRef<R>;
725
+ /**
726
+ * Global API conditions.
727
+ */
467
728
  export declare const setApiRefGlobalConditions: (conditions: RefType<any>) => void;
468
- // File: composables/ref/useApiRequest.d.ts
469
- /** General API request hook. */
470
- export declare function useApiRequest<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, method?: ApiMethodItem, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
729
+
730
+
731
+ // File: src/composables/ref/useApiRequest.d.ts
732
+ /**
733
+ * Generic API request.
734
+ */
735
+ export declare function useApiRequest<T, Request extends ApiFetch['request'] = ApiFetch['request'], Return extends ApiData<T> = ApiData<T>>(path?: RefOrNormal<string | undefined>, method?: ApiMethodItem, action?: (data: Return | undefined) => Promise<void> | void, transformation?: (data: T) => Return, errorContract?: ApiErrorStorageList, toData?: boolean, options?: ApiOptions, apiInstance?: ApiInstance): {
471
736
  loading: Ref<boolean, boolean>;
472
737
  send(request?: Request): Promise<Return | undefined>;
473
738
  };
474
- // File: composables/ref/useBroadcastValueRef.d.ts
475
- type BroadcastValueItem<T> = T | string | undefined;
476
- /** Cross-tab data sync. */
739
+
740
+
741
+ // File: src/composables/ref/useBroadcastValueRef.d.ts
742
+ /**
743
+ * Reactive data sync between tabs.
744
+ */
477
745
  export declare function useBroadcastValueRef<T>(name: string, defaultValue?: T | string | (() => (T | string))): Ref<BroadcastValueItem<T>>;
478
- // File: composables/ref/useCookieRef.d.ts
479
- /** Reactive cookie management. */
746
+
747
+
748
+ // File: src/composables/ref/useCookieRef.d.ts
749
+ /**
750
+ * Reactive cookie management.
751
+ */
480
752
  export declare function useCookieRef<T>(name: string, defaultValue?: T | string | (() => (T | string)), options?: CookieOptions): Ref<T | string | undefined>;
481
- // File: composables/ref/useFormattersRef.d.ts
482
- /** Reactive list formatting. */
753
+
754
+
755
+ // File: src/composables/ref/useFormattersRef.d.ts
756
+ /**
757
+ * Reactive list formatting.
758
+ */
483
759
  export declare function useFormattersRef<Options extends FormattersOptionsList = FormattersOptionsList, List extends FormattersListProp = FormattersListProp>(list: RefType<List | undefined>, options: Options): {
484
760
  listFormat: ComputedRef<FormattersReturn<List, Options>>;
485
761
  length: ComputedRef<number>;
486
762
  };
487
- // File: composables/ref/useGeoIntlRef.d.ts
488
- /** Formatting class getter. */
763
+
764
+
765
+ // File: src/composables/ref/useGeoIntlRef.d.ts
766
+ /**
767
+ * Get GeoIntlRef instance.
768
+ */
489
769
  export declare function useGeoIntlRef(): GeoIntlRef;
490
- // File: composables/ref/useHashRef.d.ts
491
- /** Reactive URL hash management. */
770
+
771
+
772
+ // File: src/composables/ref/useHashRef.d.ts
773
+ /**
774
+ * Reactive hash management.
775
+ */
492
776
  export declare function useHashRef<T>(name: string, defaultValue?: T | (() => T)): ShallowRef<T>;
493
- // File: composables/ref/useLazyItemByMarginRef.d.ts
777
+
778
+
779
+ // File: src/composables/ref/useLazyItemByMarginRef.d.ts
494
780
  export type LazyItemByMargin = {
495
781
  rootMargin: string;
496
782
  item: any;
497
783
  };
498
- /** Intersection tracking by margin. */
784
+ /**
785
+ * Track element screen appearance by margin.
786
+ */
499
787
  export declare const useLazyItemByMarginRef: (element: RefType<HTMLElement | undefined>, rootMargin: string) => {
500
788
  lazyItemStatus: any;
501
789
  readonly lazyItem: any;
502
790
  };
503
- // File: composables/ref/useLazyRef.d.ts
791
+
792
+
793
+ // File: src/composables/ref/useLazyRef.d.ts
504
794
  export type LazyItem = {
505
795
  status: ShallowRef<boolean>;
506
796
  ratio: ShallowRef<number>;
@@ -508,7 +798,9 @@ export type LazyItem = {
508
798
  stopWatch: () => void;
509
799
  };
510
800
  export type LazyList = Record<string, LazyItem>;
511
- /** Viewport appearance tracking. */
801
+ /**
802
+ * Track element screen appearance.
803
+ */
512
804
  export declare const useLazyRef: (options?: IntersectionObserverInit) => {
513
805
  intersectionObserver: IntersectionObserver | undefined;
514
806
  getItem(element: HTMLElement): LazyItem;
@@ -516,11 +808,19 @@ export declare const useLazyRef: (options?: IntersectionObserverInit) => {
516
808
  removeLazyItem: (element?: HTMLElement) => void;
517
809
  disconnectLazy: () => void | undefined;
518
810
  };
519
- // File: composables/ref/useLoadingRef.d.ts
520
- /** Loading status ref. */
811
+
812
+
813
+ // File: src/composables/ref/useLoadingRef.d.ts
814
+ /**
815
+ * Get loading status.
816
+ */
521
817
  export declare function useLoadingRef(): ShallowRef<boolean, boolean>;
522
- // File: composables/ref/useMeta.d.ts
523
- /** Meta tag management singleton. */
818
+
819
+
820
+ // File: src/composables/ref/useMeta.d.ts
821
+ /**
822
+ * Reactive meta tags singleton.
823
+ */
524
824
  export declare const useMeta: () => Readonly<{
525
825
  meta: typeof MetaStatic;
526
826
  title: Ref<string, string>;
@@ -571,8 +871,12 @@ export declare const useMeta: () => Readonly<{
571
871
  }>;
572
872
  destroyExecute?(): void;
573
873
  }>;
574
- // File: composables/ref/useRouterList.d.ts
575
- /** Router link list management. */
874
+
875
+
876
+ // File: src/composables/ref/useRouterList.d.ts
877
+ /**
878
+ * Link list management for router.
879
+ */
576
880
  export declare const useRouterList: <T extends ListDataBasic>(list: RefType<ConstrBind<T>[] | undefined>, selected?: Ref<string> | string, hasTo?: boolean) => {
577
881
  item: ComputedRef<T | undefined>;
578
882
  selected: Ref<string, string>;
@@ -581,8 +885,12 @@ export declare const useRouterList: <T extends ListDataBasic>(list: RefType<Cons
581
885
  to: (name?: string) => void;
582
886
  toMain(): void;
583
887
  };
584
- // File: composables/ref/useSearchRef.d.ts
585
- /** Reactive search logic. */
888
+
889
+
890
+ // File: src/composables/ref/useSearchRef.d.ts
891
+ /**
892
+ * Reactive search logic.
893
+ */
586
894
  export declare function useSearchRef<T extends SearchItem, K extends SearchColumns<T>>(list: SearchListInput<T>, columns: K, value?: Ref<string>, options?: SearchOptions): {
587
895
  isSearch: ComputedRef<boolean>;
588
896
  search: Ref<string, string>;
@@ -590,41 +898,80 @@ export declare function useSearchRef<T extends SearchItem, K extends SearchColum
590
898
  listSearch: ComputedRef<SearchFormatList<T, K>>;
591
899
  length: ComputedRef<number>;
592
900
  };
593
- // File: composables/ref/useSearchValueRef.d.ts
594
- /** Search state and debounce. */
901
+
902
+
903
+ // File: src/composables/ref/useSearchValueRef.d.ts
904
+ /**
905
+ * Debounced search state.
906
+ */
595
907
  export declare function useSearchValueRef<T extends SearchItem, K extends SearchColumns<T>>(item: SearchList<T, K>, value?: Ref<string>): {
596
908
  search: Ref<string, string>;
597
909
  searchDelay: Ref<string, string>;
598
910
  loading: Ref<boolean, boolean>;
599
911
  };
600
- // File: composables/ref/useSessionRef.d.ts
601
- /** Reactive session storage. */
912
+
913
+
914
+ // File: src/composables/ref/useSessionRef.d.ts
915
+ /**
916
+ * Reactive session storage.
917
+ */
602
918
  export declare function useSessionRef<T>(name: string, defaultValue?: T | (() => T)): Ref<T | undefined>;
603
- // File: composables/ref/useStorageRef.d.ts
604
- /** Reactive local storage. */
919
+
920
+
921
+ // File: src/composables/ref/useStorageRef.d.ts
922
+ /**
923
+ * Reactive local storage.
924
+ */
605
925
  export declare function useStorageRef<T>(name: string, defaultValue?: T | (() => T), cache?: number): Ref<T | undefined>;
606
- // File: composables/ref/useTranslateRef.d.ts
607
- /** Translation getter ref.
926
+
927
+
928
+ // File: src/composables/ref/useTranslateRef.d.ts
929
+ /**
930
+ * Get reactive translations.
931
+ * @remarks Use `as const` for arrays.
608
932
  * @example
609
- * const labels = t(['button.save'] as const);
933
+ * ```typescript
934
+ * const labels = t(['button.save', 'button.cancel'] as const);
935
+ * ```
610
936
  */
611
937
  export declare function useTranslateRef<T extends (string | string[])[]>(names: T, translateInstance?: TranslateInstance): ShallowRef<TranslateList<T>>;
612
- /** Shorthand for useTranslateRef. */
938
+ /**
939
+ * Shorthand for translations.
940
+ */
613
941
  export declare const t: <T extends string[]>(names: T) => ShallowRef<TranslateList<T>>;
614
- // File: flags.d.ts
942
+
943
+
944
+ // File: src/flags.d.ts
615
945
  export declare const uiMakeFlags: () => void;
616
- // File: functions/basic.d.ts
946
+
947
+
948
+ // File: src/functions/basic.d.ts
617
949
  export * from '@dxtmisha/functional-basic';
618
- // File: functions/computedAsync.d.ts
619
- /** Async computed property. */
950
+
951
+
952
+ // File: src/functions/computedAsync.d.ts
953
+ /**
954
+ * Async computed property.
955
+ */
620
956
  export declare function computedAsync<R>(getter: (() => Promise<R>) | (() => R) | R, initialState?: (() => R) | R, ignore?: R, debugOptions?: DebuggerOptions): ComputedRef<R | undefined>;
621
- // File: functions/computedByLanguage.d.ts
622
- /** Language-dependent computed property. */
957
+
958
+
959
+ // File: src/functions/computedByLanguage.d.ts
960
+ /**
961
+ * Language-aware computed property.
962
+ */
623
963
  export declare function computedByLanguage<T, R extends (T | undefined) = T | undefined>(getter: ComputedGetter<R>, getterNone?: R | (() => R), conditions?: () => boolean, debugOptions?: DebuggerOptions): ComputedRef<R>;
624
- // File: functions/computedEternity.d.ts
625
- /** On-demand cached computed with application-lifetime watcher. */
964
+
965
+
966
+ // File: src/functions/computedEternity.d.ts
967
+ /**
968
+ * Cached on-demand computed property.
969
+ */
626
970
  export declare function computedEternity<T>(getter: () => Promise<T> | T, initialState?: (() => T) | T): Ref<T, T>;
627
- // File: functions/dxtFunctionalPlugin.d.ts
971
+
972
+
973
+ // File: src/functions/dxtFunctionalPlugin.d.ts
974
+ /** Functional plugin options. */
628
975
  export interface FunctionalPluginOptions {
629
976
  api?: ApiConfig;
630
977
  translate?: TranslateConfig;
@@ -632,28 +979,30 @@ export interface FunctionalPluginOptions {
632
979
  icons?: IconsConfig;
633
980
  router?: Router;
634
981
  errorCauses?: ErrorCenterCauseList;
982
+ errorHandlers?: ErrorCenterHandlerList;
635
983
  }
636
- /** Global services init plugin. */
984
+ /** Functional services plugin. */
637
985
  export declare const dxtFunctionalPlugin: Plugin;
638
- // File: functions/executeUse.d.ts
639
- /** Initialization strategies. */
986
+
987
+
988
+ // File: src/functions/executeUse.d.ts
640
989
  export declare enum ExecuteUseType {
641
990
  global = "global",
642
991
  provide = "provide",
643
992
  local = "local"
644
993
  }
994
+ /** Return with management methods. */
645
995
  export type ExecuteUseReturn<R> = Readonly<R & {
646
996
  init(): Readonly<R>;
647
997
  destroyExecute?(): void;
648
998
  }>;
649
999
  /**
650
1000
  * Managed singleton factory.
651
- * @template R return type
652
- * @param callback init function
653
- * @param type strategy
1001
+ * @remarks
1002
+ * Use for API services, resource optimization, shared state, SDKs.
654
1003
  */
655
1004
  export declare function executeUse<R, O extends any[], RI extends ExecuteUseReturn<R> = ExecuteUseReturn<R>>(callback: (...args: O) => R, type?: ExecuteUseType): ((...args: O) => RI) | (() => RI);
656
- /** Global singleton creator. */
1005
+ /** Global singleton. */
657
1006
  export declare function executeUseGlobal<R>(callback: () => R): (() => Readonly<R & {
658
1007
  init(): Readonly<R>;
659
1008
  destroyExecute?(): void;
@@ -661,7 +1010,7 @@ export declare function executeUseGlobal<R>(callback: () => R): (() => Readonly<
661
1010
  init(): Readonly<R>;
662
1011
  destroyExecute?(): void;
663
1012
  }>);
664
- /** Component-scoped singleton creator. */
1013
+ /** Provide/inject singleton. */
665
1014
  export declare function executeUseProvide<R, O extends any[]>(callback: (...args: O) => R): ((...args: O) => Readonly<R & {
666
1015
  init(): Readonly<R>;
667
1016
  destroyExecute?(): void;
@@ -669,7 +1018,7 @@ export declare function executeUseProvide<R, O extends any[]>(callback: (...args
669
1018
  init(): Readonly<R>;
670
1019
  destroyExecute?(): void;
671
1020
  }>);
672
- /** Local closure singleton creator. */
1021
+ /** Closure-local singleton. */
673
1022
  export declare function executeUseLocal<R, O extends any[]>(callback: (...args: O) => R): ((...args: O) => Readonly<R & {
674
1023
  init(): Readonly<R>;
675
1024
  destroyExecute?(): void;
@@ -677,45 +1026,76 @@ export declare function executeUseLocal<R, O extends any[]>(callback: (...args:
677
1026
  init(): Readonly<R>;
678
1027
  destroyExecute?(): void;
679
1028
  }>);
680
- /** Global callbacks initializer. */
1029
+ /** Init global callbacks. */
681
1030
  export declare function executeUseGlobalInit(): void;
682
- // File: functions/getInject.d.ts
1031
+
1032
+
1033
+ // File: src/functions/getInject.d.ts
683
1034
  /** Get injected value. */
684
1035
  export declare function getInject<T>(name: string): T | undefined;
685
- // File: functions/getOptions.d.ts
686
- /** Request options helper. */
1036
+
1037
+
1038
+ // File: src/functions/getOptions.d.ts
1039
+ /** Get request options. */
687
1040
  export declare const getOptions: (options?: ApiOptions) => RefOrNormal<ApiFetch>;
688
- // File: functions/ref/getBindRef.d.ts
689
- /** Subcomponent properties generator. */
1041
+
1042
+
1043
+ // File: src/functions/ref/getApiErrorRef.d.ts
1044
+ /** Get API error item. */
1045
+ export declare function getApiErrorRef<R>(data: RefType<ApiData<R> | undefined>): ComputedRef<ApiErrorItem | undefined>;
1046
+
1047
+
1048
+ // File: src/functions/ref/getBindRef.d.ts
1049
+ /** Generate props for subcomponent. */
690
1050
  export declare function getBindRef<T, R extends ItemList>(value: RefOrNormal<T | R> | undefined, nameExtra?: RefOrNormal<ItemList> | string, name?: string): ComputedRef<R>;
691
- // File: functions/ref/getRef.d.ts
692
- /** Unwraps ref or returns value. */
1051
+
1052
+
1053
+ // File: src/functions/ref/getRef.d.ts
1054
+ /** Get ref value or literal. */
693
1055
  export declare function getRef<T>(item: RefOrNormal<T>): T;
694
- // File: functions/ref/render.d.ts
695
- /** Data renderer helper. */
1056
+
1057
+
1058
+ // File: src/functions/ref/render.d.ts
1059
+ /** Get cached VNode. */
696
1060
  export declare function render<T extends ItemList>(name: string | any, props?: T, children?: RawChildren | RawSlots, index?: string): VNode;
697
- // File: functions/ref/setRef.d.ts
698
- /** Reactive value setter. */
1061
+
1062
+
1063
+ // File: src/functions/ref/setRef.d.ts
1064
+ /** Update reactive value. */
699
1065
  export declare function setRef<T>(item: Ref<T>, value: T): void;
700
- // File: functions/ref/toRefItem.d.ts
701
- /** Wraps value in Ref. */
1066
+
1067
+
1068
+ // File: src/functions/ref/toRefItem.d.ts
1069
+ /** Ensure Ref wrapper. */
702
1070
  export declare function toRefItem<T>(item: RefOrNormal<T>): Ref<T>;
703
- // File: functions/render/getBind.d.ts
704
- /** Subcomponent props generator. */
1071
+
1072
+
1073
+ // File: src/functions/render/getBind.d.ts
1074
+ /** Generate props for subcomponent. */
705
1075
  export declare function getBind<T, R extends ItemList>(value: T | R | undefined | null, nameExtra?: ItemList | string, name?: string, except?: boolean): ConstrBind<R>;
706
- // File: functions/render/getClassName.d.ts
707
- /** Class name from props. */
1076
+
1077
+
1078
+ // File: src/functions/render/getClassName.d.ts
1079
+ /** Get class from property. */
708
1080
  export declare function getClassName<T extends ItemList>(props?: T): string | undefined;
709
- // File: functions/render/getIndexForRender.d.ts
710
- /** Render index generator. */
1081
+
1082
+
1083
+ // File: src/functions/render/getIndexForRender.d.ts
1084
+ /** Get or generate render index. */
711
1085
  export declare function getIndexForRender<T extends ItemList>(name: string | any, props?: T, index?: string): string | undefined;
712
- // File: functions/toBind.d.ts
713
- /** Merges objects with class/style handling. */
1086
+
1087
+
1088
+ // File: src/functions/toBind.d.ts
1089
+ /** Merge objects with class/style handling. */
714
1090
  export declare function toBind<R extends ItemList = ItemList>(extra: ItemList, value: ItemList): ConstrBind<R>;
715
- // File: functions/toBinds.d.ts
716
- /** Merges multiple objects with class/style handling. */
1091
+
1092
+
1093
+ // File: src/functions/toBinds.d.ts
1094
+ /** Merge multiple objects with class/style handling. */
717
1095
  export declare function toBinds<R extends ItemList = ItemList>(...values: (ItemList | undefined)[]): ConstrBind<R>;
718
- // File: library.d.ts
1096
+
1097
+
1098
+ // File: src/library.d.ts
719
1099
  export * from './classes/design/DesignAbstract';
720
1100
  export * from './classes/design/DesignAsyncAbstract';
721
1101
  export * from './classes/design/DesignChanged';
@@ -763,6 +1143,7 @@ export * from './functions/dxtFunctionalPlugin';
763
1143
  export * from './functions/executeUse';
764
1144
  export * from './functions/getInject';
765
1145
  export * from './functions/getOptions';
1146
+ export * from './functions/ref/getApiErrorRef';
766
1147
  export * from './functions/ref/getBindRef';
767
1148
  export * from './functions/ref/getRef';
768
1149
  export * from './functions/ref/render';
@@ -778,11 +1159,11 @@ export * from './types/constructorTypes';
778
1159
  export * from './types/listTypes';
779
1160
  export * from './types/refTypes';
780
1161
  export * from './types/searchTypes';
781
- // File: types/apiTypes.d.ts
1162
+
1163
+
1164
+ // File: src/types/apiTypes.d.ts
782
1165
  export type ApiOptions = ApiMethodItem | RefOrNormal<ApiFetch>;
783
- /** Base API management value. */
784
1166
  export type ApiManagementValue = ApiDefaultValue | ApiDefaultValue[];
785
- /** GET config for API management. */
786
1167
  export type ApiManagementGet<Return extends ApiManagementValue, Type extends ApiManagementValue = Return> = {
787
1168
  path?: RefOrNormal<string | undefined>;
788
1169
  options?: ApiOptions;
@@ -790,32 +1171,32 @@ export type ApiManagementGet<Return extends ApiManagementValue, Type extends Api
790
1171
  conditions?: RefType<boolean>;
791
1172
  transformation?: (data: Type, isResponseContractValid?: ApiDataValidation) => ApiData<Return>;
792
1173
  validateResponseContract?: (data: Type) => ApiDataValidation;
1174
+ errorContract?: ApiErrorStorageList;
793
1175
  typeData?: ((data: Return) => boolean) | any;
794
1176
  unmounted?: boolean;
795
1177
  skeleton?: () => Return;
796
1178
  };
797
- /** Client-side search config. */
798
1179
  export type ApiManagementSearch<T extends SearchItem, K extends SearchColumns<T>> = {
799
1180
  columns: K;
800
1181
  value?: Ref<string>;
801
1182
  options?: SearchOptions;
802
1183
  };
803
- /** Mutation config (POST, PUT, DELETE). */
804
1184
  export type ApiManagementRequest<T, Return extends ApiData<T> = ApiData<T>> = {
805
1185
  path?: RefOrNormal<string | undefined>;
806
1186
  action?: (data: Return | undefined) => Promise<void> | void;
807
1187
  transformation?: (data: T) => Return;
1188
+ errorContract?: ApiErrorStorageList;
808
1189
  toData?: boolean;
809
1190
  options?: ApiOptions;
810
1191
  };
811
- // File: types/constructorTypes.d.ts
1192
+
1193
+
1194
+ // File: src/types/constructorTypes.d.ts
812
1195
  export type ConstrItem = Record<string, any>;
813
- /** Value wrapper. */
814
1196
  export type ConstrValue<T = any> = {
815
1197
  value?: T;
816
1198
  };
817
1199
  export type ConstrComponent = Record<string, any>;
818
- /** Reactive or normal component mod. */
819
1200
  export type ConstrComponentMod<P extends ConstrItem> = ConstrItem | {
820
1201
  [K in keyof P]?: RefOrNormal<P[K]>;
821
1202
  };
@@ -835,7 +1216,6 @@ export type ConstrClasses = {
835
1216
  } & ConstrClassList;
836
1217
  export type ConstrStylesItem = string | null;
837
1218
  export type ConstrStyles = Record<string, ConstrStylesItem> | ConstrStyles[];
838
- /** Component configuration options. */
839
1219
  export type ConstrOptions<COMP extends ConstrComponent, EMITS extends ConstrItem, P extends ConstrItem> = {
840
1220
  components?: COMP;
841
1221
  compMod?: ConstrComponentMod<P>;
@@ -843,7 +1223,6 @@ export type ConstrOptions<COMP extends ConstrComponent, EMITS extends ConstrItem
843
1223
  classes?: RefType<ConstrClasses>;
844
1224
  styles?: RefType<ConstrStyles>;
845
1225
  };
846
- /** Component initialization interface. */
847
1226
  export type ConstrSetup<E extends Element, CLASSES extends ConstrClasses, SETUP extends ConstrItem> = {
848
1227
  name: string;
849
1228
  element: Ref<E | undefined>;
@@ -854,13 +1233,11 @@ export type ConstrRegistration = {
854
1233
  flag?: boolean;
855
1234
  translate?: Record<string, string>;
856
1235
  };
857
- /** Component binding with style/class support. */
858
1236
  export type ConstrBind<T> = T & Record<string, any> & {
859
1237
  key?: string;
860
1238
  class?: ConstrClass;
861
1239
  style?: ConstrStyles;
862
1240
  };
863
- /** Vue prop options. */
864
1241
  export type ConstrPropItemOptions<T = any> = {
865
1242
  type?: PropType<T>;
866
1243
  required?: boolean;
@@ -871,27 +1248,26 @@ export type ConstrPropItem<T = any> = ConstrPropItemOptions<T> | PropType<T>;
871
1248
  export type ConstrProps<P = Record<string, any>> = {
872
1249
  [K in keyof P]: ConstrPropItem<P[K]>;
873
1250
  };
874
- /** Link properties. */
875
1251
  export type ConstrHrefProps = {
876
1252
  href?: string;
877
1253
  };
878
- // File: types/listTypes.d.ts
1254
+
1255
+
1256
+ // File: src/types/listTypes.d.ts
879
1257
  export type ListType = 'item' | 'space' | 'line' | 'subtitle' | 'html' | 'menu' | 'menu-group' | 'group';
880
- /** Base list item. */
881
1258
  export type ListDataBasic = {
882
1259
  label?: NumberOrString;
883
1260
  value?: any;
884
1261
  search?: string;
885
1262
  };
886
- /** Typed list item. */
887
1263
  export type ListDataItem<Item extends ListDataBasic = ListDataBasic> = ConstrBind<Item & {
888
1264
  parent?: string;
889
1265
  type: ListType;
890
1266
  index: string;
1267
+ disabled?: boolean;
891
1268
  }>;
892
1269
  export type ListList<Item extends ListDataBasic = ListDataBasic> = ListDataItem<Item>[];
893
1270
  export type ListRecord<Item extends ListDataBasic = ListDataBasic> = ListList<Item> | Record<string, any>;
894
- /** List item with state. */
895
1271
  export type ListDataFullItem<Item extends ListDataBasic = ListDataBasic> = ListDataItem<Item> & {
896
1272
  focus: boolean;
897
1273
  highlight?: string;
@@ -905,19 +1281,19 @@ export type ListSelectedItem = NumberOrStringOrBoolean;
905
1281
  export type ListSelectedList = ListSelectedItem | ListSelectedItem[];
906
1282
  export type ListName = string | number | undefined;
907
1283
  export type ListNames = ListName[];
908
- // File: types/refTypes.d.ts
909
- /** Vue reactive union. */
1284
+
1285
+
1286
+ // File: src/types/refTypes.d.ts
910
1287
  export type RefType<T> = ComputedRef<T> | Ref<T>;
911
1288
  export type RefUndefined<T> = RefType<T | undefined>;
912
- /** Reactive or normal union. */
913
1289
  export type RefOrNormal<T> = RefType<T> | T;
914
- /** Vue raw children content. */
915
1290
  export type RawChildren = string | number | boolean | VNode | VNodeArrayChildren | (() => any);
916
- /** Vue raw slots. */
917
1291
  export type RawSlots = {
918
1292
  [name: string]: unknown;
919
1293
  $stable?: boolean;
920
1294
  };
921
- // File: types/searchTypes.d.ts
1295
+
1296
+
1297
+ // File: src/types/searchTypes.d.ts
922
1298
  export type SearchListValueRef<T extends SearchItem> = RefOrNormal<SearchListValue<T>>;
923
1299
  export type SearchListInput<T extends SearchItem> = SearchListValueRef<T> | (() => SearchListValueRef<T>);