sprof 0.9.6 → 0.9.8

package/dist/core/composables/index.d.ts

@@ -4,7 +4,8 @@
  * - useCrud — CRUD-страница: store + loading/items/count/item/searchStr/load/remove/reset;
  * - useFilters — фильтры FTSP: add/replace/remove/has/clear;
  * - usePagination — пагинация FTSP: page (1-based)/rowsPerPage/next/prev/reset;
- * - useOptions — справочник для селекта: кэш + дедуп (К1, Т8).
+ * - useOptions — справочник для селекта: кэш + дедуп (К1, Т8);
+ * - useLoader — состояния загрузки: loading/error/data + ретрай (Т2a, пара к `PLoader`).
  *
  * По умолчанию работают с глобальным синглтоном FTSP.Get(); во всех трёх можно
  * передать свой экземпляр FTSP (страница/компонент) — см. T1 в TECH_DEBT.md.
@@ -13,6 +14,8 @@ export type { UseCrudOptions, UseCrudReturn } from './useCrud';
 export { useCrud } from './useCrud';
 export type { UseFiltersReturn } from './useFilters';
 export { useFilters } from './useFilters';
+export type { LoaderFn, LoaderRetryOptions, UseLoaderOptions, UseLoaderReturn } from './useLoader';
+export { useLoader } from './useLoader';
 export type { UseOptionsOptions, UseOptionsReturn } from './useOptions';
 export { useOptions } from './useOptions';
 export type { UsePaginationReturn } from './usePagination';

package/dist/core/composables/useFilters.d.ts

@@ -1,5 +1,4 @@
 import { ComputedRef } from 'vue';
-import { default as FilterModelV2 } from '../ftsp/f/FilterModelV2';
 import { default as FilterModel } from '../ftsp/FilterModel';
 import { default as FTSP } from '../ftsp/FTSP';
 export interface UseFiltersReturn {
@@ -9,8 +8,6 @@ export interface UseFiltersReturn {
     count: ComputedRef<number>;
     /** Добавить фильтр (ftsp.setF) */
     add(model: FilterModel): void;
-    /** Добавить фильтр v2 (ftsp.setF2) */
-    addV2(model: FilterModelV2): void;
     /** Заменить фильтр: убрать prev, добавить cur (ftsp.replaceF) */
     replace(current?: FilterModel, previous?: FilterModel): void;
     /** Удалить фильтр по eq (ftsp.removeF) */

package/dist/core/composables/useLoader.d.ts

@@ -0,0 +1,63 @@
+import { ComputedRef, Ref } from 'vue';
+import { TryOpts } from '../helpers/Try';
+/** Функция загрузки: может принимать признак «принудительно» (мимо кэша/флага loaded). */
+export type LoaderFn<T> = (force: boolean) => Promise<T> | T;
+/** Попытка загрузки: сколько раз пробуем и с какой паузой (мс). */
+export interface LoaderRetryOptions {
+    /** Всего попыток, включая первую (по умолчанию 1 — без повторов). */
+    attempts?: number;
+    /** Пауза между попытками, мс (по умолчанию 2000; растёт линейно). */
+    delay?: number;
+}
+export interface UseLoaderOptions extends LoaderRetryOptions {
+    /** Запускать сразу при создании (иначе — вручную: `onMounted(load)`). */
+    immediate?: boolean;
+    /** Загружать один раз: повторные `load()` без `force` выходят сразу. */
+    once?: boolean;
+    /**
+     * Запросы к `PF.UI.Notify` при ошибке. По умолчанию — МОЛЧА: состояние ошибки
+     * показывает сам виджет `PLoader`/экран, и уведомление на каждый отказ — шум.
+     * Включать, когда ошибку больше показать негде.
+     */
+    notify?: boolean | Pick<TryOpts, 'message'>;
+    /** Своё сообщение об ошибке (когда `notify` включён). */
+    message?: string;
+}
+export interface UseLoaderReturn<T> {
+    /** Идёт загрузка (включая повторные попытки). */
+    loading: Ref<boolean>;
+    /** Текст ошибки последней попытки; пустая строка — ошибки нет. */
+    error: Ref<string>;
+    /** Загруженные данные (null — ещё не было успешной загрузки). */
+    data: Ref<T | null>;
+    /** Успешная загрузка состоялась хотя бы раз. */
+    loaded: ComputedRef<boolean>;
+    /** Факт ошибки (для `v-if`/слотов виджета). */
+    failed: ComputedRef<boolean>;
+    /** Ошибка при ПЕРВОЙ загрузке (данных нет) — показываем экран ошибки целиком. */
+    failedFirstLoad: ComputedRef<boolean>;
+    /**
+     * Загрузка людей. При ошибке НЕ бросает: ошибка уходит в `error`
+     * (и в уведомление, если `notify`).
+     */
+    load: (force?: boolean) => Promise<void>;
+    /** Сбросить состояние (данные, ошибку, признак `once`) — перед сменой фильтров. */
+    reset: () => void;
+}
+/**
+ * Единая обёртка загрузки (запрос из rdkb/map, 14.09): убирает `try/catch` +
+ * флаг `loading` + поле `error` + ретрай, которые в 8 клиентах писались руками
+ * (ср. `MyTasksPage.vue` до перевода, панель дерева, онбординг incident).
+ *
+ * ```ts
+ * const { loading, error, data, load } = useLoader(() =>
+ *   PF.H.HttpClient.Get<MyTasks>(), { immediate: true, attempts: 3 },
+ * );
+ * ```
+ *
+ * ⚠️ Не дублирует `PF.H.Try`: `Try` — про разбор ошибки и уведомление,
+ * `useLoader` — про СОСТОЯНИЕ загрузки (loading/error/data). Ретрай вынесен
+ * сюда, потому что он нужен именно циклу загрузки; уведомление включается
+ * опцией `notify` и внутри идёт через `Try.Silent` + `Try.Message`.
+ */
+export declare function useLoader<T>(fn: LoaderFn<T>, options?: UseLoaderOptions): UseLoaderReturn<T>;

package/dist/core/composables/useLoader.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/composables/usePagination.d.ts

@@ -33,8 +33,9 @@ export interface UsePaginationReturn {
 /**
  * Композабл пагинации (бэклог 0.4.0): удобная обёртка над FTSP.p.
  *
- * Важно: у FTSP.p.page — это СМЕЩЕНИЕ (offset), а page из композабла —
- * 1-based номер страницы (как в UI). Смена rowsPerPage сбрасывает на 1-ю.
+ * Важно: `ftsp.p.offset` — СМЕЩЕНИЕ (0, rowsPerPage, 2*rowsPerPage…),
+ * а `page` из композабла — 1-based номер страницы (как в UI).
+ * Смена rowsPerPage сбрасывает на 1-ю.
  *
  * ```ts
  * const { page, rowsPerPage, next, prev, reset } = usePagination();

package/dist/core/ftsp/FTSP.d.ts

@@ -1,4 +1,3 @@
-import { default as FilterModelV2 } from './f/FilterModelV2';
 import { default as FilterModel } from './FilterModel';
 import { default as Pagination } from './Pagination';
 import { default as SortModel } from './SortModel';
@@ -7,7 +6,6 @@ export default class FTSP {
     private static instance;
     id?: string;
     f: FilterModel[];
-    f2: FilterModelV2[];
     s: SortModel[];
     p: Pagination;
     t: TreeModel;
@@ -29,7 +27,6 @@ export default class FTSP {
     setSortModel(sortModel?: SortModel): void;
     setS(sortModel: SortModel): void;
     setF(model: FilterModel): void;
-    setF2(model: FilterModelV2): void;
     replaceF(curF?: FilterModel, prevF?: FilterModel): void;
     removeF(model?: FilterModel): void;
     reset(): void;

package/dist/core/ftsp/Pagination.d.ts

@@ -1,6 +1,14 @@
 import { default as Cursor } from './Cursor';
 export default class Pagination {
-    page: number;
+    /**
+     * Смещение от начала списка (НЕ номер страницы!).
+     *
+     * ⚠️ До 0.9.8 поле называлось `page`, и это регулярно путало: `page = 25`
+     * выглядит как «страница 25», а означает вторую страницу (offset 25).
+     * Номер страницы (1-based) даёт композабл `usePagination` — не считайте его
+     * здесь вручную.
+     */
+    offset: number;
     rowsPerPage: number;
     rowsNumber: number;
     cursor: Cursor;

package/dist/core/ftsp/index.d.ts

@@ -1,10 +1,8 @@
-import { default as FilterModelV2 } from './f/FilterModelV2';
 import { default as FilterModel } from './FilterModel';
 import { default as FTSP } from './FTSP';
 import { default as SortModel } from './SortModel';
 export default abstract class F {
     static SortModel: typeof SortModel;
     static FilterModel: typeof FilterModel;
-    static FilterModelV2: typeof FilterModelV2;
     static FTSP: typeof FTSP;
 }

package/dist/core/store/SearchStore.d.ts

@@ -89,7 +89,7 @@ declare class S {
             label: string;
         }[];
         pagination: {
-            page: number;
+            offset: number;
             rowsPerPage: number;
             rowsNumber: number;
             cursor: {

package/dist/global-components.d.ts

@@ -22,6 +22,7 @@ declare module 'vue' {
         PLeftSlider: typeof Atoms.PLeftSlider;
         PList: typeof Atoms.PList;
         PListItem: typeof Atoms.PListItem;
+        PLoader: typeof Atoms.PLoader;
         POptionsListSingle: typeof Atoms.POptionsListSingle;
         POpts: typeof Atoms.POpts;
         PRadio: typeof Atoms.PRadio;
@@ -39,7 +40,6 @@ declare module 'vue' {
         CarouselImages: typeof Components.CarouselImages;
         ContextWindow: typeof Components.ContextWindow;
         DropList: typeof Components.DropList;
-        FTSPPanel: typeof Components.FTSPPanel;
         FilterCheckbox: typeof Components.FilterCheckbox;
         FilterSelect: typeof Components.FilterSelect;
         FiltersButtonsSelect: typeof Components.FiltersButtonsSelect;

package/dist/index.d.ts

@@ -43,10 +43,13 @@ export type { default as Btn } from './core/ui/Btn';
 export type { default as AnswerVariant } from './modules/forms/classes/AnswerVariant';
 /** @internal Used by unplugin-auto-import configuration */
 export declare const pfName: readonly ["PF", "PFM"];
-export { useCrud, useFilters, usePagination } from './core/composables/index';
+export { useCrud, useFilters, useLoader, usePagination } from './core/composables/index';
 export type { UseCrudOptions, UseCrudReturn } from './core/composables/useCrud';
 export type { UseFiltersReturn } from './core/composables/useFilters';
+export type { LoaderFn, LoaderRetryOptions, UseLoaderOptions, UseLoaderReturn } from './core/composables/useLoader';
 export type { UsePaginationReturn } from './core/composables/usePagination';
+export type { UseOptionsOptions, UseOptionsReturn } from './core/composables/useOptions';
+export { useOptions } from './core/composables/useOptions';
 export type { PlatformName, ThemeName, UseThemeOptions, UseThemeReturn } from './core/composables/useTheme';
 export { DEFAULT_PLATFORM, getStoredTheme, isThemeLockedLight, lockLightTheme, MOBILE_MAX_WIDTH, resolvePlatform, useTheme } from './core/composables/useTheme';
 export type { QuasarBrand } from './core/brand/quasar';