sprof 1.20.7 → 1.22.7

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.
@@ -42,8 +42,8 @@ declare const _default: {
42
42
  outline: boolean;
43
43
  rounded: boolean;
44
44
  multiLine: boolean;
45
- floating: boolean;
46
45
  transparent: boolean;
46
+ floating: boolean;
47
47
  }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
48
48
  P: {};
49
49
  B: {};
@@ -91,8 +91,8 @@ declare const _default: {
91
91
  outline: boolean;
92
92
  rounded: boolean;
93
93
  multiLine: boolean;
94
- floating: boolean;
95
94
  transparent: boolean;
95
+ floating: boolean;
96
96
  }>;
97
97
  __isFragment?: undefined;
98
98
  __isTeleport?: undefined;
@@ -137,8 +137,8 @@ declare const _default: {
137
137
  outline: boolean;
138
138
  rounded: boolean;
139
139
  multiLine: boolean;
140
- floating: boolean;
141
140
  transparent: boolean;
141
+ floating: boolean;
142
142
  }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
143
143
  $slots: {
144
144
  default?(_: {}): any;
@@ -224,8 +224,8 @@ export declare const Default: StoryFn<{
224
224
  outline: boolean;
225
225
  rounded: boolean;
226
226
  multiLine: boolean;
227
- floating: boolean;
228
227
  transparent: boolean;
228
+ floating: boolean;
229
229
  }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
230
230
  P: {};
231
231
  B: {};
@@ -273,8 +273,8 @@ export declare const Default: StoryFn<{
273
273
  outline: boolean;
274
274
  rounded: boolean;
275
275
  multiLine: boolean;
276
- floating: boolean;
277
276
  transparent: boolean;
277
+ floating: boolean;
278
278
  }>;
279
279
  __isFragment?: undefined;
280
280
  __isTeleport?: undefined;
@@ -319,8 +319,8 @@ export declare const Default: StoryFn<{
319
319
  outline: boolean;
320
320
  rounded: boolean;
321
321
  multiLine: boolean;
322
- floating: boolean;
323
322
  transparent: boolean;
323
+ floating: boolean;
324
324
  }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
325
325
  $slots: {
326
326
  default?(_: {}): any;
@@ -367,8 +367,8 @@ export declare const OutlineRounded: StoryFn<{
367
367
  outline: boolean;
368
368
  rounded: boolean;
369
369
  multiLine: boolean;
370
- floating: boolean;
371
370
  transparent: boolean;
371
+ floating: boolean;
372
372
  }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
373
373
  P: {};
374
374
  B: {};
@@ -416,8 +416,8 @@ export declare const OutlineRounded: StoryFn<{
416
416
  outline: boolean;
417
417
  rounded: boolean;
418
418
  multiLine: boolean;
419
- floating: boolean;
420
419
  transparent: boolean;
420
+ floating: boolean;
421
421
  }>;
422
422
  __isFragment?: undefined;
423
423
  __isTeleport?: undefined;
@@ -462,8 +462,8 @@ export declare const OutlineRounded: StoryFn<{
462
462
  outline: boolean;
463
463
  rounded: boolean;
464
464
  multiLine: boolean;
465
- floating: boolean;
466
465
  transparent: boolean;
466
+ floating: boolean;
467
467
  }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
468
468
  $slots: {
469
469
  default?(_: {}): any;
@@ -71,8 +71,8 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<gl
71
71
  outline: boolean;
72
72
  rounded: boolean;
73
73
  multiLine: boolean;
74
- floating: boolean;
75
74
  transparent: boolean;
75
+ floating: boolean;
76
76
  }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, {
77
77
  default?(_: {}): any;
78
78
  }>;
@@ -16,6 +16,8 @@ export type { UseCrudOptions, UseCrudReturn } from './useCrud';
16
16
  export { useCrud } from './useCrud';
17
17
  export type { UseFiltersReturn } from './useFilters';
18
18
  export { useFilters } from './useFilters';
19
+ export type { IFTSPURLHandle } from './useFTSPURL';
20
+ export { useFTSPURL } from './useFTSPURL';
19
21
  export type { LoaderFn, LoaderRetryOptions, UseLoaderOptions, UseLoaderReturn } from './useLoader';
20
22
  export { useLoader } from './useLoader';
21
23
  export type { UseOptionsOptions, UseOptionsReturn } from './useOptions';
@@ -0,0 +1,22 @@
1
+ import { default as FTSP } from '../ftsp/FTSP';
2
+ export interface IFTSPURLHandle {
3
+ stop: () => void;
4
+ }
5
+ /**
6
+ * Двусторонняя связь «FTSP страницы ↔ параметр `?ftsp=` в URL».
7
+ *
8
+ * Э1: перезагрузка страницы и переход «назад» сохраняют фильтры/сортировку/
9
+ * страницу, а ссылку можно переслать — получатель увидит тот же срез.
10
+ *
11
+ * ⚠️ ПОЧЕМУ НЕ В `setup()`. `PF.H.Hooks.onBeforeMount` страницы (тот, что грузит
12
+ * данные) ПЕРВЫМ ДЕЛОМ зовёт `FTSP.Get().reset()` — всё, что прочитано в
13
+ * `setup()`, стирается (проверено 06.11). Поэтому ссылку читаем на ПЕРВОЙ
14
+ * загрузке данных, а до неё «страхуем» `reset()`.
15
+ * ⚠️ Состояние сбрасывалось и ПОСЛЕ восстановления: адрес переписывался через
16
+ * `router.replace`, а это полноценная навигация — страница монтировалась заново
17
+ * и жила уже с пустым `?ftsp=`. Отсюда `history.replaceState` (`writeParam`).
18
+ *
19
+ * @param reload — перезапросить данные, когда фильтры взяты ИЗ ссылки.
20
+ * @param readOnly — только чтение (список умеет восстанавливаться только из памяти).
21
+ */
22
+ export declare function useFTSPURL(ftsp: FTSP, reload?: () => void | Promise<void>, readOnly?: boolean): IFTSPURLHandle;
@@ -0,0 +1,47 @@
1
+ import { default as FilterModel } from './FilterModel';
2
+ import { default as FTSP } from './FTSP';
3
+ /**
4
+ * Состояние списка (FTSP) ↔ строка URL — Э1 «фильтры переживают перезагрузку
5
+ * и пересылку ссылки».
6
+ *
7
+ * Формат: ОДИН query-параметр `ftsp`, содержимое — base64url от JSON:
8
+ *
9
+ * ```
10
+ * /admin/workers?ftsp=eyJmIjpbeyJjb2wiOiJmdWxsTmFtZSIsIm9wZXJhdG9yIjoibGlrZSIsInZhbHVlIjoi…`
11
+ * ```
12
+ *
13
+ * ⚠️ Почему НЕ поля `FilterModel.toUrlQuery()` (`f=…&p=…`): тот формат — не JSON
14
+ * (ключи склеены запятыми) и режется на `&`/`#`/`,` в адресной строке. Здесь
15
+ * сериализованы только «зубцы» состояния, а `FilterModel`/`Pagination`/`SortModel`
16
+ * собираются через их собственные конструкторы (`Classes.BuildClass`), поэтому
17
+ * даты (`date1`/`date2`) снова становятся `Date`, а не строками.
18
+ *
19
+ * Пустое состояние (и состояние «только поиск» — его пользователь и так видит в
20
+ * поле) в URL НЕ пишется: иначе каждый список тащил бы `?ftsp=…` в каждой ссылке.
21
+ */
22
+ /** Имя query-параметра по умолчанию. */
23
+ export declare const FTSP_QUERY_KEY = "ftsp";
24
+ export default abstract class FTSPQuery {
25
+ /**
26
+ * Будет ли в URL непустое состояние. По нему `watch()` решает, сбросить ли
27
+ * чужой `?ftsp=` (перешли по ссылке на другой список) или записать текущее.
28
+ */
29
+ static HasState(ftsp: FTSP): boolean;
30
+ /** FTSP → строка для параметра `ftsp` (или '' — писать нечего). */
31
+ static Encode(ftsp: FTSP): string;
32
+ /** Обратная операция: строка параметра `ftsp` → объект (никогда не бросает). */
33
+ static Decode(text: string | null | undefined): FTSP;
34
+ /**
35
+ * Наложить сохранённое состояние на «рабочий» FTSP страницы.
36
+ *
37
+ * ⚠️ Строитель страницы уже положил в `ftsp` фиксированные фильтры и
38
+ * сортировку (`setF`, `setS`) — их НЕ трогаем: из ссылки только заменяем
39
+ * значения у СВОИХ фильтров (по `model.col`), остальные (созданные из
40
+ * `ByDepartmentId(opt)`) добавляем. Так ссылка не теряет ни «поиск ФИО», ни
41
+ * «отдел» из выпадашки.
42
+ *
43
+ * Возвращает список «источников», созданных из ссылки: их `label` в URL не
44
+ * едет (см. `FTSPURL.watch`), страница должна подписать их заново.
45
+ */
46
+ static Apply(target: FTSP, saved: FTSP): FilterModel[];
47
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -19,6 +19,10 @@ export default class FilterQuery {
19
19
  * частично были закомментированы и НИ ОТКУДА не вызывались. Если понадобится
20
20
  * восстановление состояния списка из URL — делать это явно через vue-router
21
21
  * (`route.query`) и с тестом на разбор, а не через магические подстроки.
22
+ *
23
+ * → Так и сделано (Э1): `ToQuery()`/`FromQuery()` ниже упаковывают FTSP в
24
+ * ОДИН параметр `ftsp` (base64url от JSON) и НЕ трогают `location`. Возврат
25
+ * по ссылке — `FTSPURL.watch()` (sprof), см. `usePageFTSP`.
22
26
  */
23
27
  setParams(col: unknown, value: string): void;
24
28
  setSortModel(sortModel: SortModel): void;
@@ -1,8 +1,10 @@
1
1
  import { default as FilterModel } from './FilterModel';
2
2
  import { default as FTSP } from './FTSP';
3
+ import { default as FTSPQuery } from './FTSPQuery';
3
4
  import { default as SortModel } from './SortModel';
4
5
  export default abstract class F {
5
6
  static SortModel: typeof SortModel;
6
7
  static FilterModel: typeof FilterModel;
7
8
  static FTSP: typeof FTSP;
9
+ static FTSPQuery: typeof FTSPQuery;
8
10
  }
@@ -23,11 +23,31 @@ export default class BaseStore<T extends IWithId & IFileInfosGetter> {
23
23
  readonly item: T;
24
24
  readonly options: Option[];
25
25
  count: Ref<number, number>;
26
+ /**
27
+ * Список грузится прямо сейчас (FTSP/GetAll/Get).
28
+ *
29
+ * ⚠️ Живёт В СТОРЕ, а не в компоненте: списки во всех проектах грузятся
30
+ * через `store.FTSP()`, поэтому `PTable` показывает загрузку по `:store`,
31
+ * без `loading`-флагов в каждой странице (запрос владельца 06.11).
32
+ */
33
+ loading: Ref<boolean, boolean>;
34
+ /** Текст ошибки последней загрузки списка; '' — ошибки нет. */
35
+ loadError: Ref<string, string>;
26
36
  classConstructor: Constructable<T>;
27
37
  url: string;
28
38
  searchStr: Ref<string>;
29
39
  constructor(i: Constructable<T>, url: string);
30
40
  Set(item: T | void): void;
41
+ /**
42
+ * Выполнить загрузку списка с общим состоянием `loading`/`loadError`.
43
+ *
44
+ * ⚠️ Счётчик, а не boolean: параллельные запросы (фильтры + пагинация)
45
+ * иначе снимали бы «загрузку» первым завершившимся, и спиннер пропадал
46
+ * раньше времени. `loading` снимается только когда счётчик дошёл до нуля.
47
+ */
48
+ protected withLoading<R>(fn: () => Promise<R>): Promise<R>;
49
+ /** Сколько загрузок идёт одновременно (см. `withLoading`). */
50
+ private loadingDepth;
31
51
  getUrl(query?: string): string;
32
52
  /**
33
53
  * Загрузить справочник (`<url>/options/<label>/<value>`) — с КЭШЕМ и ДЕДУПОМ (К1, Т8).
@@ -14,6 +14,20 @@ export default abstract class Router {
14
14
  static Back(): Promise<void>;
15
15
  static GetQid(): string;
16
16
  static Route(): RouteLocationNormalizedLoaded;
17
+ /**
18
+ * Заменить ОДИН query-параметр, не теряя остальных (и не ломая `#hash`).
19
+ * Пустое значение — параметр удаляется.
20
+ *
21
+ * ⚠️ Всегда `router.replace`: это инструмент для СОСТОЯНИЯ интерфейса
22
+ * (фильтры/страница), а не навигации. `push` здесь — ловушка: `PTable`
23
+ * трогает `offset`/`rowsPerPage` на каждом запросе, и история заполняется
24
+ * бесконечно. Свой шаг в историю — обычная навигация (ссылка/пункт меню).
25
+ *
26
+ * ⚠️ Возвращаемый промис ОТКЛОНЯЕТСЯ на повторном переходе и на защите
27
+ * `onBeforeRouteLeave` — без `catch` это unhandled rejection в консоли на
28
+ * каждом вводе в поиске.
29
+ */
30
+ static ReplaceQueryParam(key: string, value?: string): Promise<void>;
17
31
  static RouterPushBlank(path: string): void;
18
32
  static GetPath(): string;
19
33
  static ToAdmin(path?: string): Promise<void>;
@@ -22,4 +22,20 @@ export declare const DateRu: (msg?: string, required?: boolean) => Rule;
22
22
  * Пустое значение: если НЕТ правила Required — считается валидным (пропускаем
23
23
  * необязательные поля), иначе Required даст ошибку.
24
24
  */
25
+ /**
26
+ * Начало периода не позже конца: `DateAfter(endValue, …)`.
27
+ *
28
+ * ```ts
29
+ * // «Дата увольнения» проверяется относительно даты приёма
30
+ * :rules="[PF.H.Validate.DateAfter(position.start, 'Раньше даты приёма')]"
31
+ * ```
32
+ *
33
+ * ⚠️ Почему сравнение, а не «просто дата»: `q-input`-маска отдаёт СТРОКУ
34
+ * `ДД.ММ.ГГГГ`, а не `Date`. `toTime` разбирает и её, и `Date`, и ISO — иначе
35
+ * правило «не работает» ровно там, где включена маска (проверено на PDateInput).
36
+ *
37
+ * Пустые значения правило НЕ ломают: пара ещё не заполнена — не наша забота
38
+ * (`Required` решает отдельно).
39
+ */
40
+ export declare const DateAfter: (min: unknown, msg?: string) => Rule;
25
41
  export declare const Compose: (...rules: Rule[]) => Rule;
@@ -0,0 +1 @@
1
+ export {};
package/dist/index.d.ts CHANGED
@@ -59,6 +59,8 @@ export type { UsePaginationReturn } from './core/composables/usePagination';
59
59
  export type { UseOptionsOptions, UseOptionsReturn } from './core/composables/useOptions';
60
60
  export { useOptions } from './core/composables/useOptions';
61
61
  export { createPageFTSP, PageFTSPKey, providePageFTSP, usePageFTSP, usePageFTSPRef } from './core/composables/usePageFTSP';
62
+ export type { IFTSPURLHandle } from './core/composables/useFTSPURL';
63
+ export { useFTSPURL } from './core/composables/useFTSPURL';
62
64
  export type { PlatformName, ThemeName, UseThemeOptions, UseThemeReturn } from './core/composables/useTheme';
63
65
  export { DEFAULT_PLATFORM, getStoredTheme, isThemeLockedLight, lockLightTheme, MOBILE_MAX_WIDTH, resolvePlatform, useTheme } from './core/composables/useTheme';
64
66
  export type { QuasarBrand } from './core/brand/quasar';
@@ -0,0 +1,16 @@
1
+ type __VLS_Props = {
2
+ /** Подпись пункта «копировать» (номера и email'ы копируются по-разному) */
3
+ copyLabel: string;
4
+ /** Пре-сет (неудаляемые из справочника) строки — «удалить» скрыто */
5
+ canRemove: boolean;
6
+ };
7
+ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
8
+ remove: () => any;
9
+ copy: () => any;
10
+ edit: () => any;
11
+ }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
12
+ onRemove?: (() => any) | undefined;
13
+ onCopy?: (() => any) | undefined;
14
+ onEdit?: (() => any) | undefined;
15
+ }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
16
+ export default _default;