sprof 0.9.12 → 0.9.14

package/dist/auto-import.d.ts

@@ -27,7 +27,7 @@
  *    его можно использовать в любом vite-конфиге без бандла sprof.
  */
 /** Идентификаторы, которые инжектит unplugin-auto-import */
-export declare const sprofAutoImportNames: readonly ["PF", "PFM", "useCrud", "useFilters", "useLoader", "useOptions", "usePagination"];
+export declare const sprofAutoImportNames: readonly ["PF", "PFM", "useCrud", "useFilters", "useLoader", "useOptions", "usePageFTSP", "usePagination"];
 export interface SprofAutoImportsPreset {
     from: string;
     imports: string[];

package/dist/auto-import.js

@@ -1,20 +1,20 @@
-const e = ["PF", "PFM", "useCrud", "useFilters", "useLoader", "useOptions", "usePagination"], f = {
+const t = ["PF", "PFM", "useCrud", "useFilters", "useLoader", "useOptions", "usePageFTSP", "usePagination"], u = {
   from: "sprof",
-  imports: [...e]
+  imports: [...t]
 };
-function p(r = {}) {
-  const s = r.prefix ?? "P", t = r.from ?? "sprof";
+function f(r = {}) {
+  const s = r.prefix ?? "P", e = r.from ?? "sprof";
   return {
     type: "component",
     resolve: (o) => {
       if (o.startsWith(s))
-        return { name: o, from: t };
+        return { name: o, from: e };
     }
   };
 }
 export {
-  p as SprofResolver,
-  f as default,
-  e as sprofAutoImportNames,
-  f as sprofAutoImports
+  f as SprofResolver,
+  u as default,
+  t as sprofAutoImportNames,
+  u as sprofAutoImports
 };

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

@@ -5,7 +5,9 @@
  * - useFilters — фильтры FTSP: add/replace/remove/has/clear;
  * - usePagination — пагинация FTSP: page (1-based)/rowsPerPage/next/prev/reset;
  * - useOptions — справочник для селекта: кэш + дедуп (К1, Т8);
- * - useLoader — состояния загрузки: loading/error/data + ретрай (Т2a, пара к `PLoader`).
+ * - useLoader — состояния загрузки: loading/error/data + ретрай (Т2а, пара к `PLoader`);
+ * - usePageFTSP — FTSP НА СТРАНИЦУ через provide/inject (Ф2.3): фильтры/таблица
+ *   делят одно состояние, не трогая глобальный синглтон.
  *
  * По умолчанию работают с глобальным синглтоном FTSP.Get(); во всех трёх можно
  * передать свой экземпляр FTSP (страница/компонент) — см. T1 в TECH_DEBT.md.
@@ -18,6 +20,7 @@ export type { LoaderFn, LoaderRetryOptions, UseLoaderOptions, UseLoaderReturn }
 export { useLoader } from './useLoader';
 export type { UseOptionsOptions, UseOptionsReturn } from './useOptions';
 export { useOptions } from './useOptions';
+export { createPageFTSP, PageFTSPKey, providePageFTSP, usePageFTSP, usePageFTSPRef } from './usePageFTSP';
 export type { UsePaginationReturn } from './usePagination';
 export { usePagination } from './usePagination';
 export type { PlatformName, ThemeName, UseThemeOptions, UseThemeReturn } from './useTheme';

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

@@ -0,0 +1,55 @@
+import { InjectionKey, Ref } from 'vue';
+import { default as FTSP } from '../ftsp/FTSP';
+/**
+ * FTSP на СТРАНИЦУ (а не на всё приложение) — через `provide`/`inject`.
+ *
+ * ⚠️ ЗАЧЕМ (Ф2.3). `FTSP.Get()` — синглтон на всё SPA: фильтры, сортировка и
+ * пагинация «перетекают» между разделами, и каждый список вынужден вручную
+ * звать `reset()`. Хуже того — состояние НЕЛЬЗЯ увидеть локально: глядя на
+ * страницу, не понимаешь, чьи фильтры в ней сейчас.
+ *
+ * Решение: корень страницы-списка создаёт СВОЙ экземпляр и публикует его для
+ * поддерева. Подкомпоненты (тулбар фильтров, таблица, под-списки) берут его
+ * через `usePageFTSP()` — и получают ОДНО состояние на всех, не зная друг о
+ * друге и не трогая глобальное.
+ *
+ * ```ts
+ * // Корень страницы
+ * const ftsp = providePageFTSP();
+ * onMounted(() => store.FTSP({ ftsp }));
+ * ```
+ *
+ * ```ts
+ * // Тулбар/таблица ниже в дереве
+ * const ftsp = usePageFTSP(); // тот же экземпляр
+ * ```
+ *
+ * ⚠️ Вне провайдера `usePageFTSP()` возвращает ГЛОБАЛЬНЫЙ синглтон —
+ * поведение существующих компонентов не меняется, миграция постепенная.
+ * ⚠️ `createPageFTSP()` (без регистрации) — для мест, где экземпляр нужен
+ * вне компонентного дерева (сервисы, хелперы).
+ */
+type PageFTSPInstance = InstanceType<typeof FTSP>;
+/** Ключ provide/inject: FTSP текущей страницы-списка. */
+export declare const PageFTSPKey: InjectionKey<PageFTSPInstance>;
+/**
+ * Свежий экземпляр FTSP (реактивный — как `FTSP.Get()`, C2.3), БЕЗ регистрации
+ * в дереве. Нужен сервисам/хелперам, которые не могут вызвать `provide`.
+ */
+export declare function createPageFTSP(): PageFTSPInstance;
+/**
+ * Создать FTSP страницы И опубликовать его для поддерева.
+ *
+ * Возвращает тот же экземпляр — вызывающий код передаёт его в `store.FTSP({ ftsp })`.
+ * ⚠️ Вызывать в `setup()` компонента-корня списка (вне `setup` `provide`
+ * бессмыслен — предупреждаем явно, иначе ошибка всплывёт далеко от места).
+ */
+export declare function providePageFTSP(existing?: PageFTSPInstance): PageFTSPInstance;
+/**
+ * FTSP текущей страницы: внутри поддерева страницы-списка — её экземпляр,
+ * иначе — глобальный синглтон (`FTSP.Get()`), то есть прежнее поведение.
+ */
+export declare function usePageFTSP(): PageFTSPInstance;
+/** Реактивная ссылка на FTSP текущей страницы (удобно для `watch`). */
+export declare function usePageFTSPRef(): Readonly<Ref<PageFTSPInstance>>;
+export {};

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

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

package/dist/index.d.ts

@@ -50,6 +50,7 @@ export type { LoaderFn, LoaderRetryOptions, UseLoaderOptions, UseLoaderReturn }
 export type { UsePaginationReturn } from './core/composables/usePagination';
 export type { UseOptionsOptions, UseOptionsReturn } from './core/composables/useOptions';
 export { useOptions } from './core/composables/useOptions';
+export { createPageFTSP, PageFTSPKey, providePageFTSP, usePageFTSP, usePageFTSPRef } from './core/composables/usePageFTSP';
 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';