@andrey4emk/npm-app-front-b24 0.3.0 → 0.4.0

package/ConfigLogs.vue

@@ -110,7 +110,9 @@ function getHeaders() {
 
 function getUrl() {
     const base = props.apiBase.replace(/\/+$/, "");
-    return `${base}/api/config/${props.configName}`;
+    // Имя конфига подставляется в путь URL: без экранирования «#» и «?» обрежут путь,
+    // а «/» уведёт запрос на другой маршрут
+    return `${base}/api/config/${encodeURIComponent(props.configName)}`;
 }
 
 // Разбирает тело ответа: JSON — объект, любой другой Content-Type — null.
@@ -128,6 +130,10 @@ async function parseJsonBody(res) {
     }
 }
 
+// Один и тот же отказ показывается и при загрузке, и при сохранении.
+// Держим текст в одном месте, чтобы формулировки не разъехались
+const NOT_JSON_ERROR_TEXT = "Неожиданный ответ сервера: тело не JSON. Проверьте apiBase";
+
 // Текст ошибки по HTTP-статусу. Если сервер прислал message — он попадает в текст
 // при любом коде, включая 401/403 и 5xx: иначе причина отказа теряется
 function httpErrorText(res, json) {
@@ -173,7 +179,7 @@ async function loadConfig() {
             return;
         }
         if (!json) {
-            error.value = "Неожиданный ответ сервера: тело не JSON. Проверьте apiBase";
+            error.value = NOT_JSON_ERROR_TEXT;
             return;
         }
         if (json.status !== "ok" || !json.data) {
@@ -221,7 +227,7 @@ async function saveConfig() {
             return;
         }
         if (!json) {
-            message.value = "Неожиданный ответ сервера: тело не JSON. Проверьте apiBase";
+            message.value = NOT_JSON_ERROR_TEXT;
             messageType.value = "error";
             return;
         }

package/README.md

@@ -30,9 +30,10 @@ import Subscriptions from "@andrey4emk/npm-app-front-b24/Subscriptions.vue";
 
 | Prop | Тип | По умолчанию | Описание |
 |------|-----|-------------|----------|
-| `b24` | Object | `null` | Клиент Bitrix24 REST API (`B24Frame` из `@bitrix24/b24jssdk`) |
+| `b24` | Object | не задан | Клиент Bitrix24 REST API (`B24Frame` из `@bitrix24/b24jssdk`) |
 | `authConnector` | String | `""` | Значение `auth_connector` для методов работы с событиями |
 | `portalDomain` | String | `""` | Адрес портала для ссылок на сущности, `portal.bitrix24.ru` или с `https://` |
+| `timeZone` | String | `""` | Часовой пояс для колонки «Дата», строка IANA (`Europe/Moscow`). Пусто — зона браузера |
 
 Клиент ищется в таком порядке: prop `b24`, затем `inject("$b24")` (если приложение сделало
 `app.provide("$b24", client)`), затем глобальный `window.$b24`. Без клиента компонент показывает
@@ -41,8 +42,8 @@ import Subscriptions from "@andrey4emk/npm-app-front-b24/Subscriptions.vue";
 Адрес портала без `portalDomain` берётся из `client.getTargetOrigin()`, а если его нет, из
 `client.auth.getAuthData().domain`.
 
-Состояние вкладок хранится внутри компонента, глобальный миксин с `tabs` и `selectTab` больше
-не нужен.
+Автообновление списка сущностей (раз в 3 секунды, включается тумблером) останавливается на
+скрытой вкладке браузера и при уходе со страницы.
 
 ### ConfigLogs
 
@@ -72,43 +73,57 @@ import ConfigLogs from "@andrey4emk/npm-app-front-b24/ConfigLogs.vue";
 
 ## Стили
 
-Стили компонентов глобальные, без `scoped`, классы с префиксами `subscriptions__*` и
-`config-logs__*`. Их можно переопределять из CSS приложения по имени класса.
+Стили компонентов глобальные, без `scoped`, все правила под классами с префиксами
+`subscriptions__*` и `config-logs__*`. Их можно переопределять из CSS приложения по имени класса.
 
-В `Subscriptions` старые имена классов `tooltip`, `tooltipParent`, `switch`, `slider` остаются
-на элементах вторым классом ради совместимости со стилями потребителей. Они будут сняты
-в следующей minor-версии.
+Цвета вынесены в кастомные свойства на корневых элементах `.subscriptions` и `.config-logs`,
+например `--subscriptions-table-line` и `--subscriptions-table-head-ink`. Переопределяйте их
+в своём CSS, если нужна перекраска без переписывания правил.
 
-## Типы
+В `Subscriptions` на элементах вторым классом стоят старые имена `tooltip`, `tooltipParent`,
+`switch`, `slider`, `main` и хуки без правил `subscriptions__title`, `subscriptions__subtitle`.
+Правил под старые имена в пакете нет, они остаются на элементах навсегда как точки подключения
+для стилей приложения. Таблицы получили класс `subscriptions__table` с нейтральным оформлением:
+правила написаны через `:where()`, поэтому любой селектор приложения по `table.main` их перебьёт.
 
-Пакет содержит `index.d.ts` с объявлениями props обоих компонентов. Чтобы TypeScript
-потребителя (Vite + vue-tsc) их подхватил, подключите объявления явно, иначе сработает общий
-shim для `*.vue` и props станут `any`:
+## Типы
 
-```ts
-// env.d.ts
-/// <reference types="@andrey4emk/npm-app-front-b24" />
-```
+Декларации props генерируются из исходников (`types/*.vue.d.ts`) и подключены через условие
+`types` в карте `exports` для каждого файла. Ничего подключать вручную не нужно: TypeScript
+потребителя (Vite + vue-tsc) подхватит их сам и будет проверять типы props при импорте
+`@andrey4emk/npm-app-front-b24/Subscriptions.vue` и `.../ConfigLogs.vue`.
 
-или в `tsconfig.json`:
+Требования на стороне потребителя:
 
-```json
-{
-    "compilerOptions": {
-        "types": ["@andrey4emk/npm-app-front-b24"]
-    }
-}
-```
+- `moduleResolution` в `tsconfig.json` должен быть `bundler`, `node16` или `nodenext`.
+  При устаревшем `node` карта `exports` не читается, типы молча заменяются общим shim `*.vue`,
+  props становятся `any`.
+- Не добавляйте пакет в `compilerOptions.types` и не пишите `/// <reference types=...>`:
+  корневой файл деклараций отсутствует, обе конструкции дают ошибку TS2688.
 
 ## Требования
 
-- Vue 3 (`^3.0.0`) — peer dependency
+- Vue 3 (`^3.5.2`) — peer dependency. Ниже 3.5.2 сгенерированные декларации не компилируются
+  при `skipLibCheck: false`
 - Проект-потребитель должен поддерживать компиляцию `.vue` файлов (Vite / webpack + vue-loader)
 
 Других зависимостей нет: даты форматируются через `Intl.DateTimeFormat`.
 
 ## История версий
 
+### 0.4.0
+
+- `Subscriptions`: prop `timeZone`; автообновление останавливается на скрытой вкладке и
+  перезапускается после операций; ошибка загрузки гаснет после удачного обновления
+- `Subscriptions`: массовое удаление считает снятые пачки по ответу портала на каждую команду,
+  «Удалить все пустые» считает записи по идентификаторам, тексты отчётов уточнены
+- Стили: сняты глобальные правила под старыми именами `tooltip` и `tooltipParent` (имена на
+  элементах остались), добавлены `subscriptions__table` и кастомные свойства цветов
+- `ConfigLogs`: имя конфига экранируется в URL
+- Типы: ручной `index.d.ts` заменён на декларации, генерируемые `vue-tsc` при публикации;
+  подключение на стороне потребителя больше не требуется
+- `peerDependencies.vue` сужен до `^3.5.2`
+
 ### 0.3.0
 
 - `Subscriptions`: состояние вкладок внутри компонента, props `b24`, `authConnector`,
@@ -120,12 +135,13 @@ shim для `*.vue` и props станут `any`:
 - `ConfigLogs`: разбор ответа сервера с проверкой `res.ok` и Content-Type
 - Классы стилей с префиксами, добавлены стили тумблера
 - Снята зависимость `luxon`
-- Добавлен `index.d.ts` с типами props
+- Добавлен `index.d.ts` с типами props (в 0.4.0 заменён на генерируемые декларации)
 
 ### 0.2.0
 
 Пакет поставляет исходные `.vue` файлы вместо скомпилированного бандла. Компиляция
-происходит на стороне проекта-потребителя. При обновлении с `0.1.x` измените импорты:
+происходит на стороне проекта-потребителя. Импорт по голому имени пакета и файл `style.css`
+из 0.1.x больше не существуют. При обновлении с `0.1.x` измените импорты:
 
 ```js
 // Было (0.1.x)
@@ -139,9 +155,12 @@ import Subscriptions from "@andrey4emk/npm-app-front-b24/Subscriptions.vue";
 ## Публикация
 
 Версия по semver: `patch` для исправлений, `minor` для новых функций, `major` для ломающих
-изменений.
+изменений. Декларации типов перегенерируются автоматически скриптом `prepublishOnly`, поэтому
+перед публикацией нужны установленные `devDependencies`.
 
 ```bash
+npm install
+npm run build:types        # обновить types/, закоммитить вместе с правками
 git add .
 git commit -m "upd(client): описание"
 npm version minor          # или patch / major