sprof 0.3.3 → 0.4.0

package/dist/core/components/organisms/PAuthForm/PAuthForm.stories.d.ts

@@ -145,6 +145,11 @@ declare const _default: {
                 "onUpdate:modelValue"?: ((value: string | number | null | undefined) => any) | undefined;
             }>, {
                 focus: () => void;
+                blur: () => void;
+                select: () => void;
+                getNativeElement: () => HTMLInputElement | undefined;
+                validate: () => Promise<boolean>;
+                resetValidation: () => void;
             }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
                 clear: (...args: any[]) => void;
                 input: (...args: any[]) => void;
@@ -246,8 +251,13 @@ declare const _default: {
             onBlur?: ((...args: any[]) => any) | undefined;
             onFocus?: ((...args: any[]) => any) | undefined;
             "onUpdate:modelValue"?: ((value: string | number | null | undefined) => any) | undefined;
-        }>, "focus" | ("color" | "label" | "padding" | "mask" | "margin" | "width" | "disabled" | "borderColor" | "rules")> & {
+        }>, "validate" | "select" | "blur" | "focus" | "getNativeElement" | "resetValidation" | ("color" | "label" | "padding" | "mask" | "margin" | "width" | "disabled" | "borderColor" | "rules")> & {
             focus: () => void;
+            blur: () => void;
+            select: () => void;
+            getNativeElement: () => HTMLInputElement | undefined;
+            validate: () => Promise<boolean>;
+            resetValidation: () => void;
         } & {} & import('vue').ComponentCustomProperties & {} & {
             $slots: {
                 prepend?(_: {}): any;
@@ -421,6 +431,11 @@ export declare const Default: () => {
                     "onUpdate:modelValue"?: ((value: string | number | null | undefined) => any) | undefined;
                 }>, {
                     focus: () => void;
+                    blur: () => void;
+                    select: () => void;
+                    getNativeElement: () => HTMLInputElement | undefined;
+                    validate: () => Promise<boolean>;
+                    resetValidation: () => void;
                 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
                     clear: (...args: any[]) => void;
                     input: (...args: any[]) => void;
@@ -522,8 +537,13 @@ export declare const Default: () => {
                 onBlur?: ((...args: any[]) => any) | undefined;
                 onFocus?: ((...args: any[]) => any) | undefined;
                 "onUpdate:modelValue"?: ((value: string | number | null | undefined) => any) | undefined;
-            }>, "focus" | ("color" | "label" | "padding" | "mask" | "margin" | "width" | "disabled" | "borderColor" | "rules")> & {
+            }>, "validate" | "select" | "blur" | "focus" | "getNativeElement" | "resetValidation" | ("color" | "label" | "padding" | "mask" | "margin" | "width" | "disabled" | "borderColor" | "rules")> & {
                 focus: () => void;
+                blur: () => void;
+                select: () => void;
+                getNativeElement: () => HTMLInputElement | undefined;
+                validate: () => Promise<boolean>;
+                resetValidation: () => void;
             } & {} & import('vue').ComponentCustomProperties & {} & {
                 $slots: {
                     prepend?(_: {}): any;

package/dist/core/components/organisms/PAuthForm/PAuthForm.vue.d.ts

@@ -143,6 +143,11 @@ declare const _default: import('vue').DefineComponent<globalThis.ExtractPropType
             "onUpdate:modelValue"?: ((value: string | number | null | undefined) => any) | undefined;
         }>, {
             focus: () => void;
+            blur: () => void;
+            select: () => void;
+            getNativeElement: () => HTMLInputElement | undefined;
+            validate: () => Promise<boolean>;
+            resetValidation: () => void;
         }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
             clear: (...args: any[]) => void;
             input: (...args: any[]) => void;
@@ -244,8 +249,13 @@ declare const _default: import('vue').DefineComponent<globalThis.ExtractPropType
         onBlur?: ((...args: any[]) => any) | undefined;
         onFocus?: ((...args: any[]) => any) | undefined;
         "onUpdate:modelValue"?: ((value: string | number | null | undefined) => any) | undefined;
-    }>, "focus" | ("color" | "label" | "padding" | "mask" | "margin" | "width" | "disabled" | "borderColor" | "rules")> & {
+    }>, "validate" | "select" | "blur" | "focus" | "getNativeElement" | "resetValidation" | ("color" | "label" | "padding" | "mask" | "margin" | "width" | "disabled" | "borderColor" | "rules")> & {
         focus: () => void;
+        blur: () => void;
+        select: () => void;
+        getNativeElement: () => HTMLInputElement | undefined;
+        validate: () => Promise<boolean>;
+        resetValidation: () => void;
     } & {} & import('vue').ComponentCustomProperties & {} & {
         $slots: {
             prepend?(_: {}): any;

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

@@ -0,0 +1,16 @@
+/**
+ * Композаблы (бэклог 0.4.0): BaseStore + FTSP в хуки для страниц-списков.
+ *
+ * - 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.
+ *
+ * По умолчанию работают с глобальным синглтоном FTSP.Get(); во всех трёх можно
+ * передать свой экземпляр FTSP (страница/компонент) — см. T1 в TECH_DEBT.md.
+ */
+export type { UseCrudOptions, UseCrudReturn } from './useCrud';
+export { useCrud } from './useCrud';
+export type { UseFiltersReturn } from './useFilters';
+export { useFilters } from './useFilters';
+export type { UsePaginationReturn } from './usePagination';
+export { usePagination } from './usePagination';

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

@@ -0,0 +1,47 @@
+import { ComputedRef, Ref } from 'vue';
+import { default as FTSP } from '../ftsp/FTSP';
+import { default as BaseStore } from '../helpers/BaseStore';
+import { default as IFileInfosGetter } from '../interfaces/IFileInfosGetter';
+import { default as IWithId } from '../interfaces/IWithId';
+export interface UseCrudOptions {
+    /** Свой экземпляр FTSP (по умолчанию — глобальный синглтон FTSP.Get()) */
+    ftsp?: FTSP;
+}
+export interface UseCrudReturn<T extends IWithId & IFileInfosGetter> {
+    /** Идёт ли загрузка списка (store.FTSP) */
+    loading: Ref<boolean>;
+    /** Живой список записей (store.Items) */
+    items: ComputedRef<T[]>;
+    /** Количество записей (store.Count) */
+    count: ComputedRef<number>;
+    /** Текущая выбранная запись (store.Item) */
+    item: ComputedRef<T>;
+    /** Строка поиска (store.searchStr) — v-model-совместимая */
+    searchStr: Ref<string>;
+    /** Экземпляр FTSP, с которым работает композабл */
+    ftsp: FTSP;
+    /** Загрузить список через store.FTSP (с FTSP-фильтрами/сортировкой/пагинацией) */
+    load(): Promise<void>;
+    /** Загрузить одну запись (store.Get: id или из route) */
+    get(id?: string): Promise<void>;
+    /** Создать запись (store.Create) */
+    create(item?: T): Promise<T | void>;
+    /** Обновить запись (store.Update) */
+    update(item?: T): Promise<T | void>;
+    /** Удалить запись (store.Remove — локально убирает из items) */
+    remove(id?: string): Promise<void>;
+    /** Сброс: FTSP + состояние стора (store.ResetState) */
+    reset(): void;
+}
+/**
+ * Композабл CRUD-страницы (бэклог 0.4.0): BaseStore + FTSP в одном хуке.
+ * Типичный список-страница: фильтры/сортировка/пагинация мутируют ftsp,
+ * load() перечитывает список с сервера.
+ *
+ * ```ts
+ * const store = new PF.H.BaseStore(C.Worker, 'workers');
+ * const { items, count, loading, load, remove, reset } = useCrud(store);
+ * onMounted(load);
+ * ```
+ */
+export declare function useCrud<T extends IWithId & IFileInfosGetter>(store: BaseStore<T>, options?: UseCrudOptions): UseCrudReturn<T>;

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

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

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

@@ -0,0 +1,33 @@
+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 {
+    /** Живой список фильтров (реактивный — ссылка на ftsp.f) */
+    filters: ComputedRef<FilterModel[]>;
+    /** Количество активных фильтров */
+    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) */
+    remove(model?: FilterModel): void;
+    /** Есть ли фильтр, эквивалентный model */
+    has(model: FilterModel): boolean;
+    /** Сбросить все фильтры (ftsp.resetF) */
+    clear(): void;
+}
+/**
+ * Композабл фильтрации (бэклог 0.4.0): удобная обёртка над фильтрами FTSP
+ * для страниц-списков. По умолчанию работает с глобальным синглтоном
+ * (FTSP.Get()), на страницу/компонент можно передать свой экземпляр:
+ *
+ * ```ts
+ * const { filters, add, replace, remove, clear, has } = useFilters();
+ * const { filters } = useFilters(myFtsp); // свой экземпляр (T1 из TECH_DEBT)
+ * ```
+ */
+export declare function useFilters(ftsp?: FTSP): UseFiltersReturn;

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

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

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

@@ -0,0 +1,45 @@
+import { ComputedRef } from 'vue';
+import { default as FTSP } from '../ftsp/FTSP';
+export interface UsePaginationReturn {
+    /** Текущая страница (1-based, для v-model пагинаторов/таблиц) */
+    page: ComputedRef<number>;
+    /** Строк на странице; смена сбрасывает на первую страницу */
+    rowsPerPage: ComputedRef<number>;
+    /** Общее количество записей (ftsp.p.rowsNumber) */
+    rowsNumber: ComputedRef<number>;
+    /** Перейти на страницу (1-based) */
+    goTo(pageNum: number): void;
+    /** Следующая страница */
+    next(): void;
+    /** Предыдущая страница (не меньше первой) */
+    prev(): void;
+    /** Сброс на первую страницу с сохранением rowsPerPage */
+    reset(): void;
+    /** Полный сброс пагинации к дефолтам (page 0, rowsPerPage 25, cursorMode off) */
+    drop(): void;
+    /** Курсорный режим: загрузить «ещё» после lastCursor (ftsp.p.setLoadMore) */
+    setLoadMore(lastCursor: string, column: string, table: string): void;
+    /** Курсорный режим v2 (модель вместо таблицы) */
+    setLoadMoreV2(lastCursor: string, column: string, model: string): void;
+    /** Пометить «всё загружено» по длине загруженных записей */
+    setAllLoaded(loadedItemsLength: number): void;
+    /** Пагинация из ftsp (для таблиц/пагинаторов, которым нужен объект) */
+    pagination: ComputedRef<{
+        page: number;
+        rowsPerPage: number;
+        rowsNumber: number;
+    }>;
+}
+/**
+ * Композабл пагинации (бэклог 0.4.0): удобная обёртка над FTSP.p.
+ *
+ * Важно: у FTSP.p.page — это СМЕЩЕНИЕ (offset), а page из композабла —
+ * 1-based номер страницы (как в UI). Смена rowsPerPage сбрасывает на 1-ю.
+ *
+ * ```ts
+ * const { page, rowsPerPage, next, prev, reset } = usePagination();
+ * // QTable-совместимый объект:
+ * const { pagination } = usePagination(ftsp);
+ * ```
+ */
+export declare function usePagination(ftsp?: FTSP): UsePaginationReturn;

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

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

package/dist/index.d.ts

@@ -43,3 +43,7 @@ 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 type { UseCrudOptions, UseCrudReturn } from './core/composables/useCrud';
+export type { UseFiltersReturn } from './core/composables/useFilters';
+export type { UsePaginationReturn } from './core/composables/usePagination';

package/dist/modules/table/cells/PTableNumber.vue.d.ts

@@ -21,11 +21,11 @@ interface Props {
 declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
     label: string;
     readonly: boolean;
-    prop: string;
-    decimals: number;
-    min: number;
     max: number;
+    min: number;
     step: number;
+    prop: string;
+    decimals: number;
     emptyPlaceholder: string;
     tooltipThreshold: number;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {

package/dist/modules/table/cells/PTableString.vue.d.ts

@@ -11,8 +11,8 @@ interface Props {
 declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
     label: string;
     readonly: boolean;
-    prop: string;
     maxLength: number;
+    prop: string;
     truncateLength: number;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     edit: ({