arui-scripts 19.0.3 → 19.0.5

package/docs/modules.md

@@ -513,6 +513,30 @@ export const MyAwesomeComponent = () => {
 Этот режим работает как для _default_, так и для _compat_ модулей.
 Внутри targetElementRef будет создаваться shadowRoot, и модуль и его стили будут монтироваться в него.
 
+# Кеширование модулей
+
+По умолчанию модули будут загружаться каждый раз при использовании. Если ваше приложение будет монтировать/размонтировать модуль несколько раз,
+каждый раз загрузка модуля будет выполняться заново.
+Это поведение можно изменить, с помощью параметра `resourcesCache` функции `createModuleLoader`.
+
+```tsx
+const loader = createModuleLoader({
+    resourcesCache: 'single-item', // по умолчанию 'none'
+    // другие параметры
+});
+```
+
+Это включит кеширование модуля. В режиме `'single-item'` в кеше будут храниться ресурсы модуля для последнего значения `loaderParams`, если они переданы.
+При повторном монтировании модуля с теми же `loaderParams`, ресурсы будут браться из кеша, а не загружаться заново.
+При изменении `loaderParams` ресурсы будут загружаться заново.
+
+Обратите внимание, что кеширование модулей может вызывать проблемы при обновлении приложения, поставляющего модуль.
+Если сессии пользователей очень долгие, а обновления модуля происходят часто, то это может привести к тому, что пользователи будут продолжать видеть старую версию модуля.
+Так же стоит помнить что кеширование может увеличить потребление памяти вашим приложением. Используйте его с осторожностью и только в случае если вы уверены, что оно действительно необходимо.
+Как альтернативу стоит рассмотреть использование кеширования на уровне http протокола, это дает приемлемую скорость работы без рисков утечки памяти и использования "старой" версии ресурсов.
+
+**Внимание!** Использование `resourcesCache: 'single-item'` не будет работать вместе с `useShadowDom` из-за особенностей работы со стилями.
+
 # Другие типы модулей
 
 Помимо создания монтируемых модулей, есть возможность создавать и другие типы модулей, более подходящие для некоторых вариантов использования.

package/docs/presets.md

@@ -3,7 +3,7 @@
 
 В случае, если вы хотите использовать определенный набор конфигураций и оверрайдов сразу в нескольких проектах - вам может
 помочь механизм пресетов. Он позволяет выносить конфигурацию и оверрайды в отдельный пакет.
-Для того чтобы использовать персеты на проекте вы должны указать в настройках проекта имя пакета с пресетами:
+Для того, чтобы использовать пресеты на проекте, вы должны указать в настройках проекта имя пакета с пресетами:
 
 ```json
 {
@@ -39,7 +39,7 @@ const settings: PackageSettings = {
 export default settings;
 ```
 
-На проекте конфиурация будет загружаться в следующем порядке:
+На проекте конфигурация будет загружаться в следующем порядке:
 1. базовые настройки из arui-scripts
 2. настройки из presets
 3. настройки из package.json проекта
@@ -47,7 +47,7 @@ export default settings;
 
 **Важно!**
 
-Если вы будете задавать относительные пути через общие конфигурации (например `serverEntry`, `additionalBuildPath` и другие)
+Если вы будете задавать относительные пути через общие конфигурации (например `serverEntry`, `additionalBuildPath` и другие),
 они будут вычисляться относительно корня проекта, а не вашей конфигурации.
 Вы можете использовать абсолютные пути при необходимости задать путь до файла внутри пакета с пресетами.
 

package/docs/settings.md

@@ -241,6 +241,10 @@ const settings = {
 Добавлять ли инструменты для сборки coverage при сборке. По умолчанию определяется по env переменным - будет выставлено в `true` если `NODE_ENV = 'cypress'` или `USE_ISTANBUL = 'enabled'`.
 Сбор coverage не будет работать при использовании `codeLoader=tsc`.
 
+#### disableDevWebpackTypecheck
+Выключает проверку типов вебпаком во время разработки. По умолчанию `true`.
+Вместо этого будет запускаться отдельный процесс `tsc`, который будет выдавать сообщения об ошибках в типах только в консоль.
+
 ### Обработка изображений
 #### dataUrlMaxSize
 Ресурсы, не превышающие данный размер (в байтах), будут включены в исходники `inline`, иначе вынесены в отдельный файл. По умолчанию `1536`.
@@ -278,8 +282,6 @@ const settings = {
 #### compatModules
 Позволяет настроить работу с `compat` модулями. По умолчанию `{}`. Подробнее в разделе [модули](modules.md).
 
-#### disableDevWebpackTypecheck
-Выключает проверку типов вебпаком во время разработки.
-Вместо этого будет запускаться отдельный процесс `tsc`, который будет выдавать сообщения об ошибках в типах только в консоль.
-
-По умолчанию `true`.
+#### disableModulesSupport
+Полностью выключает любые манипуляции с WMF плагином. По умолчанию `false`.
+Нужно для проектов, которые хотят реализовывать модули самостоятельно, чтобы избежать конфликтов в конфигурации плагинов.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "arui-scripts",
-    "version": "19.0.3",
+    "version": "19.0.5",
     "main": "./build/index.js",
     "typings": "./build/index.d.ts",
     "license": "MPL-2.0",
@@ -42,7 +42,7 @@
         "@rspack/core": "1.1.5",
         "@rspack/dev-server": "1.0.9",
         "@rspack/plugin-react-refresh": "^1.0.0",
-        "@swc/core": "1.10.1",
+        "@swc/core": "1.9.3",
         "@swc/jest": "^0.2.36",
         "assets-webpack-plugin": "7.1.1",
         "autoprefixer": "^10.3.16",