locator-ars-lib 1.1.4 → 1.1.6

package/README.md

@@ -82,7 +82,23 @@ app.mount("#app");
 </template>
 ```
 
+С массивом разрешений:
+
+```vue
+<template>
+  <Check :action="['edit_user', 'manage_users']">
+    <button>Edit User</button>
+
+    <template #fallback>
+      <span>You need edit_user or manage_users permission</span>
+    </template>
+  </Check>
+</template>
+```
+
 > **Важно:** Компонент Check изначально скрывает основной контент до получения подтверждения о правах доступа. Только после успешной проверки прав происходит отображение контента. До этого момента отображается слот `loading`, если он предоставлен.
+>
+> **Массив разрешений:** При передаче массива разрешений компонент отобразит основной контент, если у пользователя есть хотя бы одно из указанных разрешений. Это позволяет реализовать логику "ИЛИ" для проверки прав.
 
 ### 2. Директивы v-can и v-cant
 
@@ -97,10 +113,15 @@ app.mount("#app");
   <div v-can="'view_analytics'">
     <!-- Аналитика будет видна только при наличии прав -->
   </div>
+
+  <!-- Использование массива разрешений -->
+  <button v-can="['edit_user', 'manage_users']">Edit User</button>
 </template>
 ```
 
 > **Важно:** Директива v-can изначально скрывает элементы, к которым она применена. Элементы отображаются только после успешной проверки прав доступа.
+>
+> **Массив разрешений:** При передаче массива разрешений элемент будет отображен, если у пользователя есть хотя бы одно из указанных разрешений. Это позволяет реализовать логику "ИЛИ" для проверки прав.
 
 #### Директива v-cant
 
@@ -112,6 +133,11 @@ app.mount("#app");
   <div v-cant="'edit_user'" class="no-permission-message">
     У вас нет прав на редактирование
   </div>
+
+  <!-- Использование массива разрешений -->
+  <div v-cant="['edit_user', 'manage_users']" class="no-permission-message">
+    У вас нет ни одного из необходимых прав
+  </div>
 </template>
 ```
 
@@ -152,28 +178,28 @@ function handleDelete() {
 
 ### Компонент Check
 
-| Prop     | Тип     | По умолчанию | Описание                                        |
-| -------- | ------- | ------------ | ----------------------------------------------- |
-| action   | string  |              | Название действия для проверки                  |
-| fallback | boolean | false        | Показывать ли fallback слот при отсутствии прав |
+| Prop     | Тип                | По умолчанию | Описание                                           |
+| -------- | ------------------ | ------------ | -------------------------------------------------- |
+| action   | string \| string[] |              | Название действия или массив действий для проверки |
+| fallback | boolean            | false        | Показывать ли fallback слот при отсутствии прав    |
 
 ### Директивы
 
 #### Директива v-can
 
 ```vue
-v-can="'action_name'"
+v-can="'action_name'" // или v-can="['action_name1', 'action_name2']"
 ```
 
-Показывает элемент только при наличии прав доступа.
+Показывает элемент только при наличии прав доступа. При передаче массива разрешений элемент будет отображен, если у пользователя есть хотя бы одно из указанных разрешений.
 
 #### Директива v-cant
 
 ```vue
-v-cant="'action_name'"
+v-cant="'action_name'" // или v-cant="['action_name1', 'action_name2']"
 ```
 
-Показывает элемент только при отсутствии прав доступа (противоположность v-can).
+Показывает элемент только при отсутствии прав доступа (противоположность v-can). При передаче массива разрешений элемент будет отображен только если у пользователя нет ни одного из указанных разрешений.
 
 ### usePermissions composable
 
@@ -186,10 +212,10 @@ const {
 } = usePermissions(action, options);
 ```
 
-| Параметр          | Тип                   | По умолчанию | Описание                             |
-| ----------------- | --------------------- | ------------ | ------------------------------------ |
-| action            | string \| Ref<string> |              | Название действия для проверки       |
-| options.autoCheck | boolean               | true         | Автоматически проверять при создании |
+| Параметр          | Тип                                           | По умолчанию | Описание                                           |
+| ----------------- | --------------------------------------------- | ------------ | -------------------------------------------------- |
+| action            | string \| string[] \| Ref<string \| string[]> |              | Название действия или массив действий для проверки |
+| options.autoCheck | boolean                                       | true         | Автоматически проверять при создании               |
 
 ## Особенности реализации
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "locator-ars-lib",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "Permissions library for Vue 3 applications",
   "type": "module",
   "main": "./dist/locator-ars-lib.umd.js",

package/types/index.d.ts

@@ -3,6 +3,7 @@ import { App, Component, Ref, ComputedRef, ObjectDirective } from 'vue'
 export interface PermissionsOptions {
     baseUrl?: string
     endpoint?: string
+    application?: string
 }
 
 export interface UsePermissionsOptions {
@@ -27,7 +28,7 @@ export const Check: Component
 export const vCan: ObjectDirective
 
 export function usePermissions(
-    action: string | Ref<string>,
+    action: string | string[] | Ref<string | string[]>,
     options?: UsePermissionsOptions
 ): UsePermissionsResult
 

package/types/locator-ars-lib.d.ts

@@ -4,6 +4,7 @@ declare module 'locator-ars-lib' {
     export interface PermissionsOptions {
         baseUrl?: string
         endpoint?: string
+        application?: string
     }
 
     export interface UsePermissionsOptions {
@@ -28,7 +29,7 @@ declare module 'locator-ars-lib' {
     export const vCan: ObjectDirective
 
     export function usePermissions(
-        action: string | Ref<string>,
+        action: string | string[] | Ref<string | string[]>,
         options?: UsePermissionsOptions
     ): UsePermissionsResult