@dskripchenko/laravel-admin 1.26.0 → 1.27.1

package/dist/stores/manifest.d.ts

@@ -1,16 +1,18 @@
 /**
- * Manifest store: lazy-load JSON-манифеста админки + кеширование по version.
+ * The manifest store: it lazy-loads the admin's JSON manifest and caches it by
+ * version.
  *
- * Manifest содержит описание всех Resource'ов, Screen'ов, Settings'ов,
- * Plugin'ов. SPA загружает один раз на старте и переиспользует.
+ * The manifest describes every resource, screen, settings page and plugin. The
+ * SPA loads it once at start-up and reuses it.
  *
- * ETag-based 304 Not Modified backend-side — фронт ничего особенного не
- * делает (axios + browser handle If-None-Match). Свежий version записывается
- * в lastVersion для cheap-сравнения.
+ * The 304 Not Modified handling is ETag-based on the backend side, so the
+ * frontend does nothing special — axios and the browser handle If-None-Match.
+ * The fresh version is written into lastVersion for cheap comparisons.
  */
 /**
- * Узел manifest'а с обязательным `type`. Совместим с LayoutNode/FieldNode/
- * InfolistNode — позволяет передавать массив прямо в renderer без cast'а.
+ * A manifest node with a mandatory `type`. It is compatible with LayoutNode,
+ * FieldNode and InfolistNode, so an array can go straight into a renderer
+ * without a cast.
  */
 export interface ManifestNode extends Record<string, unknown> {
     type: string;
@@ -21,18 +23,19 @@ export interface ManifestResourceMeta {
     icon?: string;
     group?: string | null;
     /**
-     * Eloquent morph-class либо FQCN модели — нужен AuditTimeline'у как
-     * `subject_type` параметр для /audit/timeline endpoint'а.
+     * The Eloquent morph class or the model's FQCN — AuditTimeline needs it as
+     * the `subject_type` parameter of the /audit/timeline endpoint.
      */
     subject_type?: string | null;
     permissions: Record<string, string>;
     fields: ManifestNode[];
     /**
-     * Раскладка формы СОЗДАНИЯ. Приходит только когда отличается от `fields` —
-     * например, у ресурса, чьи вкладки нечем наполнить до сохранения записи.
+     * The layout of the CREATE form. It only arrives when it differs from
+     * `fields` — for a resource whose tabs have nothing to show before the
+     * record is saved, say.
      */
     create_fields?: ManifestNode[];
-    /** Read-only entries для view-page. Default — auto-generated из fields(). */
+    /** The read-only entries of the view page. By default they are generated from fields(). */
     infolist?: ManifestNode[];
     columns: ManifestNode[];
     filters: ManifestNode[];
@@ -42,9 +45,9 @@ export interface ManifestResourceMeta {
     view_mode?: 'list' | 'tree';
     hierarchy_parent_key?: string | null;
     /**
-     * Slug ресурса, чей index используется как "back" контекст для form/view
-     * страниц. Default null (back ведёт на собственный index). См.
-     * Resource::parentSlug() на бэкенде.
+     * The slug of the resource whose index serves as the "back" context of the
+     * form and view pages. null by default, meaning back leads to this
+     * resource's own index. See Resource::parentSlug() on the backend.
      */
     parent_slug?: string | null;
     features: Record<string, unknown>;
@@ -83,8 +86,8 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
             icon?: string | undefined;
             group?: string | null
             /**
-             * Eloquent morph-class либо FQCN модели — нужен AuditTimeline'у как
-             * `subject_type` параметр для /audit/timeline endpoint'а.
+             * The Eloquent morph class or the model's FQCN — AuditTimeline needs it as
+             * the `subject_type` parameter of the /audit/timeline endpoint.
              */
              | undefined;
             subject_type?: string | null | undefined;
@@ -118,9 +121,9 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
             view_mode?: "list" | "tree" | undefined;
             hierarchy_parent_key?: string | null
             /**
-             * Slug ресурса, чей index используется как "back" контекст для form/view
-             * страниц. Default null (back ведёт на собственный index). См.
-             * Resource::parentSlug() на бэкенде.
+             * The slug of the resource whose index serves as the "back" context of the
+             * form and view pages. null by default, meaning back leads to this
+             * resource's own index. See Resource::parentSlug() on the backend.
              */
              | undefined;
             parent_slug?: string | null | undefined;
@@ -155,8 +158,8 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
             icon?: string | undefined;
             group?: string | null
             /**
-             * Eloquent morph-class либо FQCN модели — нужен AuditTimeline'у как
-             * `subject_type` параметр для /audit/timeline endpoint'а.
+             * The Eloquent morph class or the model's FQCN — AuditTimeline needs it as
+             * the `subject_type` parameter of the /audit/timeline endpoint.
              */
              | undefined;
             subject_type?: string | null | undefined;
@@ -190,9 +193,9 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
             view_mode?: "list" | "tree" | undefined;
             hierarchy_parent_key?: string | null
             /**
-             * Slug ресурса, чей index используется как "back" контекст для form/view
-             * страниц. Default null (back ведёт на собственный index). См.
-             * Resource::parentSlug() на бэкенде.
+             * The slug of the resource whose index serves as the "back" context of the
+             * form and view pages. null by default, meaning back leads to this
+             * resource's own index. See Resource::parentSlug() on the backend.
              */
              | undefined;
             parent_slug?: string | null | undefined;
@@ -230,8 +233,8 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
         icon?: string | undefined;
         group?: string | null
         /**
-         * Eloquent morph-class либо FQCN модели — нужен AuditTimeline'у как
-         * `subject_type` параметр для /audit/timeline endpoint'а.
+         * The Eloquent morph class or the model's FQCN — AuditTimeline needs it as
+         * the `subject_type` parameter of the /audit/timeline endpoint.
          */
          | undefined;
         subject_type?: string | null | undefined;
@@ -265,9 +268,9 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
         view_mode?: "list" | "tree" | undefined;
         hierarchy_parent_key?: string | null
         /**
-         * Slug ресурса, чей index используется как "back" контекст для form/view
-         * страниц. Default null (back ведёт на собственный index). См.
-         * Resource::parentSlug() на бэкенде.
+         * The slug of the resource whose index serves as the "back" context of the
+         * form and view pages. null by default, meaning back leads to this
+         * resource's own index. See Resource::parentSlug() on the backend.
          */
          | undefined;
         parent_slug?: string | null | undefined;
@@ -308,8 +311,8 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
             icon?: string | undefined;
             group?: string | null
             /**
-             * Eloquent morph-class либо FQCN модели — нужен AuditTimeline'у как
-             * `subject_type` параметр для /audit/timeline endpoint'а.
+             * The Eloquent morph class or the model's FQCN — AuditTimeline needs it as
+             * the `subject_type` parameter of the /audit/timeline endpoint.
              */
              | undefined;
             subject_type?: string | null | undefined;
@@ -343,9 +346,9 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
             view_mode?: "list" | "tree" | undefined;
             hierarchy_parent_key?: string | null
             /**
-             * Slug ресурса, чей index используется как "back" контекст для form/view
-             * страниц. Default null (back ведёт на собственный index). См.
-             * Resource::parentSlug() на бэкенде.
+             * The slug of the resource whose index serves as the "back" context of the
+             * form and view pages. null by default, meaning back leads to this
+             * resource's own index. See Resource::parentSlug() on the backend.
              */
              | undefined;
             parent_slug?: string | null | undefined;
@@ -380,8 +383,8 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
             icon?: string | undefined;
             group?: string | null
             /**
-             * Eloquent morph-class либо FQCN модели — нужен AuditTimeline'у как
-             * `subject_type` параметр для /audit/timeline endpoint'а.
+             * The Eloquent morph class or the model's FQCN — AuditTimeline needs it as
+             * the `subject_type` parameter of the /audit/timeline endpoint.
              */
              | undefined;
             subject_type?: string | null | undefined;
@@ -415,9 +418,9 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
             view_mode?: "list" | "tree" | undefined;
             hierarchy_parent_key?: string | null
             /**
-             * Slug ресурса, чей index используется как "back" контекст для form/view
-             * страниц. Default null (back ведёт на собственный index). См.
-             * Resource::parentSlug() на бэкенде.
+             * The slug of the resource whose index serves as the "back" context of the
+             * form and view pages. null by default, meaning back leads to this
+             * resource's own index. See Resource::parentSlug() on the backend.
              */
              | undefined;
             parent_slug?: string | null | undefined;
@@ -455,8 +458,8 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
         icon?: string | undefined;
         group?: string | null
         /**
-         * Eloquent morph-class либо FQCN модели — нужен AuditTimeline'у как
-         * `subject_type` параметр для /audit/timeline endpoint'а.
+         * The Eloquent morph class or the model's FQCN — AuditTimeline needs it as
+         * the `subject_type` parameter of the /audit/timeline endpoint.
          */
          | undefined;
         subject_type?: string | null | undefined;
@@ -490,9 +493,9 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
         view_mode?: "list" | "tree" | undefined;
         hierarchy_parent_key?: string | null
         /**
-         * Slug ресурса, чей index используется как "back" контекст для form/view
-         * страниц. Default null (back ведёт на собственный index). См.
-         * Resource::parentSlug() на бэкенде.
+         * The slug of the resource whose index serves as the "back" context of the
+         * form and view pages. null by default, meaning back leads to this
+         * resource's own index. See Resource::parentSlug() on the backend.
          */
          | undefined;
         parent_slug?: string | null | undefined;
@@ -533,8 +536,8 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
             icon?: string | undefined;
             group?: string | null
             /**
-             * Eloquent morph-class либо FQCN модели — нужен AuditTimeline'у как
-             * `subject_type` параметр для /audit/timeline endpoint'а.
+             * The Eloquent morph class or the model's FQCN — AuditTimeline needs it as
+             * the `subject_type` parameter of the /audit/timeline endpoint.
              */
              | undefined;
             subject_type?: string | null | undefined;
@@ -568,9 +571,9 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
             view_mode?: "list" | "tree" | undefined;
             hierarchy_parent_key?: string | null
             /**
-             * Slug ресурса, чей index используется как "back" контекст для form/view
-             * страниц. Default null (back ведёт на собственный index). См.
-             * Resource::parentSlug() на бэкенде.
+             * The slug of the resource whose index serves as the "back" context of the
+             * form and view pages. null by default, meaning back leads to this
+             * resource's own index. See Resource::parentSlug() on the backend.
              */
              | undefined;
             parent_slug?: string | null | undefined;
@@ -605,8 +608,8 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
             icon?: string | undefined;
             group?: string | null
             /**
-             * Eloquent morph-class либо FQCN модели — нужен AuditTimeline'у как
-             * `subject_type` параметр для /audit/timeline endpoint'а.
+             * The Eloquent morph class or the model's FQCN — AuditTimeline needs it as
+             * the `subject_type` parameter of the /audit/timeline endpoint.
              */
              | undefined;
             subject_type?: string | null | undefined;
@@ -640,9 +643,9 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
             view_mode?: "list" | "tree" | undefined;
             hierarchy_parent_key?: string | null
             /**
-             * Slug ресурса, чей index используется как "back" контекст для form/view
-             * страниц. Default null (back ведёт на собственный index). См.
-             * Resource::parentSlug() на бэкенде.
+             * The slug of the resource whose index serves as the "back" context of the
+             * form and view pages. null by default, meaning back leads to this
+             * resource's own index. See Resource::parentSlug() on the backend.
              */
              | undefined;
             parent_slug?: string | null | undefined;
@@ -680,8 +683,8 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
         icon?: string | undefined;
         group?: string | null
         /**
-         * Eloquent morph-class либо FQCN модели — нужен AuditTimeline'у как
-         * `subject_type` параметр для /audit/timeline endpoint'а.
+         * The Eloquent morph class or the model's FQCN — AuditTimeline needs it as
+         * the `subject_type` parameter of the /audit/timeline endpoint.
          */
          | undefined;
         subject_type?: string | null | undefined;
@@ -715,9 +718,9 @@ export declare const useManifestStore: import("pinia").StoreDefinition<"admin-ma
         view_mode?: "list" | "tree" | undefined;
         hierarchy_parent_key?: string | null
         /**
-         * Slug ресурса, чей index используется как "back" контекст для form/view
-         * страниц. Default null (back ведёт на собственный index). См.
-         * Resource::parentSlug() на бэкенде.
+         * The slug of the resource whose index serves as the "back" context of the
+         * form and view pages. null by default, meaning back leads to this
+         * resource's own index. See Resource::parentSlug() on the backend.
          */
          | undefined;
         parent_slug?: string | null | undefined;

package/dist/stores/menu.d.ts

@@ -1,34 +1,35 @@
 /**
- * Menu store: дерево пунктов сайдбара.
+ * The menu store: the tree of sidebar items.
  *
- * Источник — /system/menu (backend строит из ResourceRegistry/ScreenRegistry/
- * Settings + plugin-вкладов). Фронт фильтрует по permission'ам залогиненного
- * пользователя через auth-store.
+ * They come from /system/menu, which the backend builds out of
+ * ResourceRegistry, ScreenRegistry, the settings and the plugins'
+ * contributions. The frontend filters them by the logged-in user's permissions
+ * through the auth store.
  */
 export interface MenuItem {
-    /** Уникальный идентификатор. */
+    /** The unique identifier. */
     key: string;
-    /** Текст пункта. */
+    /** The item's text. */
     label: string;
-    /** Имя icon'а (опционально — host-проект сам резолвит icon-set). */
+    /** The icon's name; optional, since the host project resolves the icon set itself. */
     icon?: string | null;
-    /** URL (внутренний router-target) либо null для группы. */
+    /** The URL — an internal router target — or null for a group. */
     url?: string | null;
-    /** Имя router-route (если задано — приоритет над url). */
+    /** The router route's name; when set it wins over the url. */
     routeName?: string | null;
-    /** Бейдж справа (число unread, ярлык вроде "new"). */
+    /** The badge on the right: an unread count, or a label such as "new". */
     badge?: string | number | null;
-    /** Группа (header в sidebar). */
+    /** The group, rendered as a header in the sidebar. */
     group?: string | null;
-    /** Сортировочный вес. */
+    /** The sorting weight. */
     order?: number;
-    /** Permission-keys; если заданы — пункт виден только при hasAnyPermission. */
+    /** The permission keys; when set, the item is visible only if hasAnyPermission passes. */
     permissions?: string[];
-    /** Вложенные пункты. */
+    /** The nested items. */
     children?: MenuItem[];
 }
 export interface MenuGroup {
-    /** Заголовок группы (null = пункты без группы). */
+    /** The group's heading; null for the items outside any group. */
     group: string | null;
     items: MenuItem[];
 }
@@ -37,50 +38,50 @@ export declare const useMenuStore: import("pinia").StoreDefinition<"admin-menu",
         key: string;
         label: string;
         icon?: string | null
-        /** URL (внутренний router-target) либо null для группы. */
+        /** The URL — an internal router target — or null for a group. */
          | undefined;
         url?: string | null
-        /** Имя router-route (если задано — приоритет над url). */
+        /** The router route's name; when set it wins over the url. */
          | undefined;
         routeName?: string | null
-        /** Бейдж справа (число unread, ярлык вроде "new"). */
+        /** The badge on the right: an unread count, or a label such as "new". */
          | undefined;
         badge?: string | number | null
-        /** Группа (header в sidebar). */
+        /** The group, rendered as a header in the sidebar. */
          | undefined;
         group?: string | null
-        /** Сортировочный вес. */
+        /** The sorting weight. */
          | undefined;
         order?: number
-        /** Permission-keys; если заданы — пункт виден только при hasAnyPermission. */
+        /** The permission keys; when set, the item is visible only if hasAnyPermission passes. */
          | undefined;
         permissions?: string[]
-        /** Вложенные пункты. */
+        /** The nested items. */
          | undefined;
         children?: /*elided*/ any[] | undefined;
     }[], MenuItem[] | {
         key: string;
         label: string;
         icon?: string | null
-        /** URL (внутренний router-target) либо null для группы. */
+        /** The URL — an internal router target — or null for a group. */
          | undefined;
         url?: string | null
-        /** Имя router-route (если задано — приоритет над url). */
+        /** The router route's name; when set it wins over the url. */
          | undefined;
         routeName?: string | null
-        /** Бейдж справа (число unread, ярлык вроде "new"). */
+        /** The badge on the right: an unread count, or a label such as "new". */
          | undefined;
         badge?: string | number | null
-        /** Группа (header в sidebar). */
+        /** The group, rendered as a header in the sidebar. */
          | undefined;
         group?: string | null
-        /** Сортировочный вес. */
+        /** The sorting weight. */
          | undefined;
         order?: number
-        /** Permission-keys; если заданы — пункт виден только при hasAnyPermission. */
+        /** The permission keys; when set, the item is visible only if hasAnyPermission passes. */
          | undefined;
         permissions?: string[]
-        /** Вложенные пункты. */
+        /** The nested items. */
          | undefined;
         children?: /*elided*/ any[] | undefined;
     }[]>;
@@ -97,50 +98,50 @@ export declare const useMenuStore: import("pinia").StoreDefinition<"admin-menu",
         key: string;
         label: string;
         icon?: string | null
-        /** URL (внутренний router-target) либо null для группы. */
+        /** The URL — an internal router target — or null for a group. */
          | undefined;
         url?: string | null
-        /** Имя router-route (если задано — приоритет над url). */
+        /** The router route's name; when set it wins over the url. */
          | undefined;
         routeName?: string | null
-        /** Бейдж справа (число unread, ярлык вроде "new"). */
+        /** The badge on the right: an unread count, or a label such as "new". */
          | undefined;
         badge?: string | number | null
-        /** Группа (header в sidebar). */
+        /** The group, rendered as a header in the sidebar. */
          | undefined;
         group?: string | null
-        /** Сортировочный вес. */
+        /** The sorting weight. */
          | undefined;
         order?: number
-        /** Permission-keys; если заданы — пункт виден только при hasAnyPermission. */
+        /** The permission keys; when set, the item is visible only if hasAnyPermission passes. */
          | undefined;
         permissions?: string[]
-        /** Вложенные пункты. */
+        /** The nested items. */
          | undefined;
         children?: /*elided*/ any[] | undefined;
     }[], MenuItem[] | {
         key: string;
         label: string;
         icon?: string | null
-        /** URL (внутренний router-target) либо null для группы. */
+        /** The URL — an internal router target — or null for a group. */
          | undefined;
         url?: string | null
-        /** Имя router-route (если задано — приоритет над url). */
+        /** The router route's name; when set it wins over the url. */
          | undefined;
         routeName?: string | null
-        /** Бейдж справа (число unread, ярлык вроде "new"). */
+        /** The badge on the right: an unread count, or a label such as "new". */
          | undefined;
         badge?: string | number | null
-        /** Группа (header в sidebar). */
+        /** The group, rendered as a header in the sidebar. */
          | undefined;
         group?: string | null
-        /** Сортировочный вес. */
+        /** The sorting weight. */
          | undefined;
         order?: number
-        /** Permission-keys; если заданы — пункт виден только при hasAnyPermission. */
+        /** The permission keys; when set, the item is visible only if hasAnyPermission passes. */
          | undefined;
         permissions?: string[]
-        /** Вложенные пункты. */
+        /** The nested items. */
          | undefined;
         children?: /*elided*/ any[] | undefined;
     }[]>;
@@ -157,50 +158,50 @@ export declare const useMenuStore: import("pinia").StoreDefinition<"admin-menu",
         key: string;
         label: string;
         icon?: string | null
-        /** URL (внутренний router-target) либо null для группы. */
+        /** The URL — an internal router target — or null for a group. */
          | undefined;
         url?: string | null
-        /** Имя router-route (если задано — приоритет над url). */
+        /** The router route's name; when set it wins over the url. */
          | undefined;
         routeName?: string | null
-        /** Бейдж справа (число unread, ярлык вроде "new"). */
+        /** The badge on the right: an unread count, or a label such as "new". */
          | undefined;
         badge?: string | number | null
-        /** Группа (header в sidebar). */
+        /** The group, rendered as a header in the sidebar. */
          | undefined;
         group?: string | null
-        /** Сортировочный вес. */
+        /** The sorting weight. */
          | undefined;
         order?: number
-        /** Permission-keys; если заданы — пункт виден только при hasAnyPermission. */
+        /** The permission keys; when set, the item is visible only if hasAnyPermission passes. */
          | undefined;
         permissions?: string[]
-        /** Вложенные пункты. */
+        /** The nested items. */
          | undefined;
         children?: /*elided*/ any[] | undefined;
     }[], MenuItem[] | {
         key: string;
         label: string;
         icon?: string | null
-        /** URL (внутренний router-target) либо null для группы. */
+        /** The URL — an internal router target — or null for a group. */
          | undefined;
         url?: string | null
-        /** Имя router-route (если задано — приоритет над url). */
+        /** The router route's name; when set it wins over the url. */
          | undefined;
         routeName?: string | null
-        /** Бейдж справа (число unread, ярлык вроде "new"). */
+        /** The badge on the right: an unread count, or a label such as "new". */
          | undefined;
         badge?: string | number | null
-        /** Группа (header в sidebar). */
+        /** The group, rendered as a header in the sidebar. */
          | undefined;
         group?: string | null
-        /** Сортировочный вес. */
+        /** The sorting weight. */
          | undefined;
         order?: number
-        /** Permission-keys; если заданы — пункт виден только при hasAnyPermission. */
+        /** The permission keys; when set, the item is visible only if hasAnyPermission passes. */
          | undefined;
         permissions?: string[]
-        /** Вложенные пункты. */
+        /** The nested items. */
          | undefined;
         children?: /*elided*/ any[] | undefined;
     }[]>;

package/dist/stores/navigation.d.ts

@@ -1,11 +1,11 @@
 /**
- * useNavigationStore — глобальный pending-counter для top-loading-bar.
+ * useNavigationStore — the global pending counter behind the top loading bar.
  *
- * При router.beforeEach (старт навигации) — вызываем `start()`.
- * При router.afterEach + resource-page завершила data-fetch — вызываем `end()`.
+ * `start()` is called from router.beforeEach, as a navigation begins; `end()`
+ * from router.afterEach and once a resource page has finished fetching.
  *
- * Counter (а не bool) защищает от race condition'ов: если несколько
- * параллельных fetch'ей, bar остаётся видимым пока хоть один pending.
+ * It is a counter rather than a boolean to survive the races: with several
+ * fetches in flight the bar stays visible while at least one is pending.
  */
 export declare const useNavigationStore: import("pinia").StoreDefinition<"admin-navigation", Pick<{
     pending: import("vue").Ref<number, number>;

package/dist/stores/notifications.d.ts

@@ -1,9 +1,10 @@
 /**
- * Notifications store: список + unread count + read/delete actions.
+ * The notifications store: the list, the unread count, and the read and delete
+ * actions.
  *
- * Bell-badge polling реализуется на уровне UI через setInterval +
- * вызов loadUnread() — store сам не polling'ит, чтобы не дублировать
- * SetInterval'ы между tab'ами.
+ * The bell badge is polled by the UI, through a setInterval calling
+ * loadUnread(); the store does no polling of its own, so as not to multiply
+ * intervals across the tabs.
  */
 import type { AdminBootstrap } from '../types/bootstrap';
 export interface NotificationItem {

package/dist/stores/registry.d.ts

@@ -1,13 +1,13 @@
 /**
- * Глобальный registry AdminClient'а для Pinia stores.
+ * The global registry of the AdminClient, for the Pinia stores.
  *
- * Stores не получают client через параметры — это сильно усложняет API
- * (`useAuthStore(client)` каждый раз). Вместо этого client регистрируется
- * один раз при bootstrap'е приложения через `setAdminClient()`, и stores
- * читают его через `getAdminClient()`.
+ * The stores do not take the client as a parameter — that would make the API
+ * much clumsier, with `useAuthStore(client)` every single time. Instead the
+ * client is registered once, while the application bootstraps, through
+ * `setAdminClient()`, and the stores read it with `getAdminClient()`.
  *
- * Это singleton-pattern — допустим в случае admin-SPA, потому что
- * client всегда один на весь жизненный цикл.
+ * It is a singleton, which is acceptable for an admin SPA: there is only ever
+ * one client for the whole lifetime.
  */
 import type { AdminClient } from '../api/client';
 export declare function setAdminClient(client: AdminClient): void;