arui-scripts 19.0.4 → 19.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/docs/modules.md CHANGED
@@ -513,6 +513,30 @@ export const MyAwesomeComponent = () => {
513
513
  Этот режим работает как для _default_, так и для _compat_ модулей.
514
514
  Внутри targetElementRef будет создаваться shadowRoot, и модуль и его стили будут монтироваться в него.
515
515
 
516
+ # Кеширование модулей
517
+
518
+ По умолчанию модули будут загружаться каждый раз при использовании. Если ваше приложение будет монтировать/размонтировать модуль несколько раз,
519
+ каждый раз загрузка модуля будет выполняться заново.
520
+ Это поведение можно изменить, с помощью параметра `resourcesCache` функции `createModuleLoader`.
521
+
522
+ ```tsx
523
+ const loader = createModuleLoader({
524
+ resourcesCache: 'single-item', // по умолчанию 'none'
525
+ // другие параметры
526
+ });
527
+ ```
528
+
529
+ Это включит кеширование модуля. В режиме `'single-item'` в кеше будут храниться ресурсы модуля для последнего значения `loaderParams`, если они переданы.
530
+ При повторном монтировании модуля с теми же `loaderParams`, ресурсы будут браться из кеша, а не загружаться заново.
531
+ При изменении `loaderParams` ресурсы будут загружаться заново.
532
+
533
+ Обратите внимание, что кеширование модулей может вызывать проблемы при обновлении приложения, поставляющего модуль.
534
+ Если сессии пользователей очень долгие, а обновления модуля происходят часто, то это может привести к тому, что пользователи будут продолжать видеть старую версию модуля.
535
+ Так же стоит помнить что кеширование может увеличить потребление памяти вашим приложением. Используйте его с осторожностью и только в случае если вы уверены, что оно действительно необходимо.
536
+ Как альтернативу стоит рассмотреть использование кеширования на уровне http протокола, это дает приемлемую скорость работы без рисков утечки памяти и использования "старой" версии ресурсов.
537
+
538
+ **Внимание!** Использование `resourcesCache: 'single-item'` не будет работать вместе с `useShadowDom` из-за особенностей работы со стилями.
539
+
516
540
  # Другие типы модулей
517
541
 
518
542
  Помимо создания монтируемых модулей, есть возможность создавать и другие типы модулей, более подходящие для некоторых вариантов использования.
package/docs/presets.md CHANGED
@@ -3,7 +3,7 @@
3
3
 
4
4
  В случае, если вы хотите использовать определенный набор конфигураций и оверрайдов сразу в нескольких проектах - вам может
5
5
  помочь механизм пресетов. Он позволяет выносить конфигурацию и оверрайды в отдельный пакет.
6
- Для того чтобы использовать персеты на проекте вы должны указать в настройках проекта имя пакета с пресетами:
6
+ Для того, чтобы использовать пресеты на проекте, вы должны указать в настройках проекта имя пакета с пресетами:
7
7
 
8
8
  ```json
9
9
  {
@@ -39,7 +39,7 @@ const settings: PackageSettings = {
39
39
  export default settings;
40
40
  ```
41
41
 
42
- На проекте конфиурация будет загружаться в следующем порядке:
42
+ На проекте конфигурация будет загружаться в следующем порядке:
43
43
  1. базовые настройки из arui-scripts
44
44
  2. настройки из presets
45
45
  3. настройки из package.json проекта
@@ -47,7 +47,7 @@ export default settings;
47
47
 
48
48
  **Важно!**
49
49
 
50
- Если вы будете задавать относительные пути через общие конфигурации (например `serverEntry`, `additionalBuildPath` и другие)
50
+ Если вы будете задавать относительные пути через общие конфигурации (например `serverEntry`, `additionalBuildPath` и другие),
51
51
  они будут вычисляться относительно корня проекта, а не вашей конфигурации.
52
52
  Вы можете использовать абсолютные пути при необходимости задать путь до файла внутри пакета с пресетами.
53
53
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "arui-scripts",
3
- "version": "19.0.4",
3
+ "version": "19.0.6",
4
4
  "main": "./build/index.js",
5
5
  "typings": "./build/index.d.ts",
6
6
  "license": "MPL-2.0",
@@ -42,7 +42,7 @@
42
42
  "@rspack/core": "1.1.5",
43
43
  "@rspack/dev-server": "1.0.9",
44
44
  "@rspack/plugin-react-refresh": "^1.0.0",
45
- "@swc/core": "1.10.1",
45
+ "@swc/core": "1.9.3",
46
46
  "@swc/jest": "^0.2.36",
47
47
  "assets-webpack-plugin": "7.1.1",
48
48
  "autoprefixer": "^10.3.16",