bms-shared-components 1.0.8 → 1.0.10

package/README.md

@@ -8,201 +8,76 @@
 npm install bms-shared-components
 ```
 
+## Что тут есть
+
+- `ReSimpleTable`
+- `ReSimpleSelect`
+- `TheTable` - Обертка над DataTable
+- `TheSelect` - Был создан как обертка над Select чтобы в модель класть айди объекта а не весь объект
+- `TheDateInput` - Был создан когда то как обертка над DateInput которая всегда сохраняет ISO формат даты
+- `RequestingSelect` - Select поддерживающий поиск на сервере
+- `NewMkbSelectBox` - компонент для быстрого поиска МКБ
+- `STable`
+- `ConstructorReports` - Список отчетов созданных на конструкторе форм с возможностью генерации оных
+- `ConstructorReportsQueue` - Просмотр очереди отчетов (созданных на конструкторе форм и добавленных в очередь на формирование)
+- `ScanWriteOffMedicalDevicesFormMDLP` - Списание мед. изделий и препаратов посредством документов выбытия
+
 ## Использование
 
-### Как плагин (глобальная регистрация)
+### Как плагин (рекомендуется)
+
+Компоненты используют Pinia через **provide/inject** (без глобальной регистрации). Передайте `pinia` при установке:
 
 ```js
 import { createApp } from "vue";
+import { createPinia } from "pinia";
 import App from "./App.vue";
 import BmsSharedComponents from "bms-shared-components";
 import "bms-shared-components/style.css";
 
+const pinia = createPinia();
 const app = createApp(App);
-app.use(BmsSharedComponents);
+app.use(BmsSharedComponents, { pinia });
 app.mount("#app");
 ```
 
-### С настройкой API при установке плагина
+### С настройкой API и Pinia
 
 ```js
 import { createApp } from "vue";
+import { createPinia } from "pinia";
 import App from "./App.vue";
 import BmsSharedComponents from "bms-shared-components";
 import "bms-shared-components/style.css";
 
+const pinia = createPinia();
 const app = createApp(App);
 app.use(BmsSharedComponents, {
+  pinia,
   apiConfig: {
     baseURL: "https://api.example.com",
     token: "your-auth-token",
   },
+  // или axiosConfig (рекомендуется):
+  // axiosConfig: { baseURL: "...", headers: { Authorization: "..." } },
 });
 app.mount("#app");
 ```
 
-### Импорт отдельных компонентов
+### Через createBmsComponentsPlugin
 
 ```js
-import { FullLoader } from "bms-shared-components";
+import { createApp } from "vue";
+import { createPinia } from "pinia";
+import { createBmsComponentsPlugin } from "bms-shared-components";
 import "bms-shared-components/style.css";
 
-export default {
-  components: {
-    FullLoader,
-  },
-};
-```
-
-## Настройка API
-
-Если ваши компоненты будут обращаться к API, необходимо настроить базовый URL и токен авторизации.
-
-### Настройка с помощью configureApi
-
-```js
-import { configureApi } from "bms-shared-components";
-
-// Настройка API перед использованием компонентов
-configureApi({
+const pinia = createPinia();
+const app = createApp(App);
+app.use(createBmsComponentsPlugin({
+  pinia,
   baseURL: "https://api.example.com",
-  token: "your-auth-token",
-  headers: {
-    // Дополнительные заголовки (опционально)
-    "Custom-Header": "value",
-  },
-});
-```
-
-### Обновление токена
-
-```js
-import { updateToken } from "bms-shared-components";
-
-// Обновить токен авторизации
-updateToken("new-auth-token");
-```
-
-### Получение текущей конфигурации
-
-```js
-import { getApiConfig } from "bms-shared-components";
-
-const config = getApiConfig();
-console.log(config.baseURL); // текущий базовый URL
-console.log(config.token); // текущий токен
-```
-
-## Композаблы
-
-### useAxios
-
-Композабл для выполнения HTTP запросов с использованием настроенной конфигурации API.
-
-```vue
-<template>
-  <div>
-    <button @click="loadData" :disabled="loading">Загрузить данные</button>
-
-    <div v-if="loading">Загрузка...</div>
-    <div v-if="error">Ошибка: {{ error }}</div>
-    <div v-if="data">
-      <pre>{{ JSON.stringify(data, null, 2) }}</pre>
-    </div>
-  </div>
-</template>
-
-<script setup>
-import { useAxios } from "bms-shared-components";
-
-const { loading, error, data, get, post, put, delete: del } = useAxios();
-
-async function loadData() {
-  try {
-    // GET запрос
-    await get("/api/users");
-
-    // POST запрос
-    // await post("/api/users", { name: "John", email: "john@example.com" });
-
-    // PUT запрос
-    // await put("/api/users/1", { name: "Jane" });
-
-    // DELETE запрос
-    // await del("/api/users/1");
-  } catch (err) {
-    console.error("Ошибка запроса:", err);
-  }
-}
-</script>
-```
-
-#### Возвращаемые значения useAxios
-
-- `loading` - реактивное значение состояния загрузки
-- `error` - реактивное значение с текстом ошибки
-- `data` - реактивное значение с данными ответа
-- `request(url, options)` - универсальный метод запроса
-- `get(url, options)` - GET запрос
-- `post(url, body, options)` - POST запрос
-- `put(url, body, options)` - PUT запрос
-- `delete(url, options)` - DELETE запрос
-
-## Компоненты
-
-### FullLoader
-
-Компонент полноэкранного загрузчика с красивой анимацией.
-
-#### Пропсы
-
-- `modelValue` (Boolean) - управляет видимостью загрузчика
-- `minShowTime` (Number) - минимальное время показа в миллисекундах (по умолчанию 750)
-
-#### Пример использования
-
-```vue
-<template>
-  <div>
-    <button @click="showLoader = true">Показать загрузчик</button>
-
-    <FullLoader v-model="showLoader"> Загружаем данные... </FullLoader>
-  </div>
-</template>
-
-<script setup>
-import { ref } from "vue";
-import { FullLoader } from "bms-shared-components";
-
-const showLoader = ref(false);
-
-// Автоматически скрыть через 3 секунды
-setTimeout(() => {
-  showLoader.value = false;
-}, 3000);
-</script>
-```
-
-## Примеры
-
-Полные примеры использования смотрите в папке `example/`.
-
-## Разработка
-
-```bash
-# Установка зависимостей
-npm install
-
-# Запуск в режиме разработки
-npm run dev
-
-# Сборка библиотеки
-npm run build:lib
-
-# Публикация
-npm publish
+  token: "your-jwt-token",
+}));
+app.mount("#app");
 ```
-
-## Лицензия
-
-MIT