@evergis/react 4.0.133 → 4.0.135

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Everpoint
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Everpoint
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,7 +1,7 @@
-# @evergis/react
-
-В данном репозитории находятся специфичные (в отличии от `@evergis/uilib-gl`) для `Evergis Online`,
-но в целом переиспользуемые на других проектах, построенных на Evergis API, React-компоненты.
-
-***ВАЖНО!!!***: Разрабатываемые компоненты не должны иметь зависимостей
-от системы поддержки мультиязычности `Evergis Online`!
+# @evergis/react
+
+В данном репозитории находятся специфичные (в отличии от `@evergis/uilib-gl`) для `Evergis Online`,
+но в целом переиспользуемые на других проектах, построенных на Evergis API, React-компоненты.
+
+***ВАЖНО!!!***: Разрабатываемые компоненты не должны иметь зависимостей
+от системы поддержки мультиязычности `Evergis Online`!

package/dist/components/Dashboard/hooks/useFetchImageWithAuth.d.ts

@@ -1 +1,10 @@
+/**
+ * `src` для картинки: свой файл тянется fetch'ем с токеном и отдаётся blob-адресом, чужой
+ * возвращается как есть.
+ *
+ * Внешний адрес намеренно не фетчится: тег `img` грузит кросс-доменную картинку без всякого
+ * CORS, а `fetch` — только если чужой сервер отдал `Access-Control-Allow-Origin`. Заодно
+ * картинка остаётся в HTTP-кеше браузера, которого blob-адрес лишён. Ровно так же поступают
+ * вложения: `useAttachmentPreviewImages` отдаёт внешней ссылке `src: item.link`.
+ */
 export declare const useFetchImageWithAuth: (url: string | null) => string | null;

package/dist/components/Dashboard/utils/getResourceUrl.d.ts

@@ -1 +1,11 @@
+/**
+ * Приводит значение конфига к адресу картинки, иконки или ссылки.
+ *
+ * Развилка одна: готовый адрес отдаётся как есть, всё остальное считается идентификатором
+ * ресурса и разворачивается в путь к файлу каталога.
+ *
+ * Проверка идёт по схеме, а не по префиксу `http`: иначе `data:`-URI, `blob:`, `mailto:` и
+ * `//cdn…` превращались бы в `/sp/resources/file/data:…` — путь к несуществующему файлу,
+ * который дальше по течению неотличим от обычного внутреннего адреса и молча даёт 404.
+ */
 export declare const getResourceUrl: (url?: string) => string;

package/dist/components/Dashboard/utils/index.d.ts

@@ -60,6 +60,7 @@ export * from './getTotalFromAttributes';
 export * from './getTotalFromRelatedFeatures';
 export * from './getRootElementId';
 export * from './hasContainerBgImage';
+export * from './isCrossOriginUrl';
 export * from './isEmptyElementValue';
 export * from './isEmptyValue';
 export * from './isHiddenEmptyValue';

package/dist/components/Dashboard/utils/isCrossOriginUrl.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Ведёт ли адрес на ЧУЖОЙ origin — сервер, который ничего не знает ни про наш токен, ни про
+ * наши заголовки.
+ *
+ * Относительный адрес (`/sp/resources/file/<id>`) всегда свой. Абсолютный сравнивается с
+ * `location.origin`, поэтому `https://<наш хост>/sp/...` тоже считается своим: его файлы
+ * закрыты авторизацией ровно так же, как у относительного пути.
+ *
+ * Проверка НЕ сводится к `^https?://`, как `isExternal` у вложений: там достаточно отличить
+ * ссылку от файла каталога, а здесь решается, отправлять ли на адрес `Authorization`.
+ *
+ * Разобрать адрес не удалось — считаем его своим: пусть с ним разбирается обычный путь
+ * загрузки, а не эта проверка.
+ */
+export declare const isCrossOriginUrl: (url?: string | null) => boolean;