@ryuzaki13/react-foundation-lib 1.4.0 → 1.4.2

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.
Files changed (101) hide show
  1. package/README.md +172 -114
  2. package/dist/chunks/{formatters-CBgrBeSA.js → formatters-D33Uh3si.js} +7 -8
  3. package/dist/chunks/{formatters-CBgrBeSA.js.map → formatters-D33Uh3si.js.map} +1 -1
  4. package/dist/chunks/odata-service-CWkHASdw.js +2211 -0
  5. package/dist/chunks/odata-service-CWkHASdw.js.map +1 -0
  6. package/dist/chunks/{validate-BW-7BZy_.js → validate-DyzojM0w.js} +2 -2
  7. package/dist/chunks/{validate-BW-7BZy_.js.map → validate-DyzojM0w.js.map} +1 -1
  8. package/dist/error-report/index.js +2 -2
  9. package/dist/excel/index.js +20 -21
  10. package/dist/excel/index.js.map +1 -1
  11. package/dist/formatters/index.js +4 -5
  12. package/dist/{odata → odata-service}/buildSeparatedArrays.d.ts +1 -1
  13. package/dist/odata-service/buildSeparatedArrays.d.ts.map +1 -0
  14. package/dist/{odata/types.d.ts → odata-service/collectionTypes.d.ts} +1 -1
  15. package/dist/odata-service/collectionTypes.d.ts.map +1 -0
  16. package/dist/{odata → odata-service}/dateUtils.d.ts +1 -1
  17. package/dist/odata-service/dateUtils.d.ts.map +1 -0
  18. package/dist/{odata → odata-service}/findCollectionPairs.d.ts +1 -1
  19. package/dist/odata-service/findCollectionPairs.d.ts.map +1 -0
  20. package/dist/odata-service/index.d.ts +5 -0
  21. package/dist/odata-service/index.d.ts.map +1 -1
  22. package/dist/odata-service/index.js +2 -2
  23. package/dist/{odata/store.d.ts → odata-service/odataCollectionStore.d.ts} +1 -1
  24. package/dist/odata-service/odataCollectionStore.d.ts.map +1 -0
  25. package/dist/query-client/index.js.map +1 -1
  26. package/dist/query-client/queryClient.d.ts +1 -3
  27. package/dist/query-client/queryClient.d.ts.map +1 -1
  28. package/package.json +1 -5
  29. package/src/array/README.mdx +1630 -0
  30. package/src/binary/README.mdx +1405 -0
  31. package/src/bounded-copy-stack/README.mdx +257 -0
  32. package/src/context-menu/README.mdx +326 -0
  33. package/src/copy/README.mdx +992 -0
  34. package/src/crypto/README.mdx +1052 -0
  35. package/src/currency/README.mdx +155 -0
  36. package/src/date-segments/README.mdx +319 -0
  37. package/src/dom/README.mdx +2179 -0
  38. package/src/error/README.mdx +95 -0
  39. package/src/error-report/README.mdx +612 -0
  40. package/src/excel/README.mdx +449 -0
  41. package/src/file/README.mdx +1957 -0
  42. package/src/fingerprint/README.mdx +100 -0
  43. package/src/form/README.mdx +101 -0
  44. package/src/formatters/README.mdx +469 -0
  45. package/src/formatters/boolean/README.mdx +494 -0
  46. package/src/formatters/date/README.mdx +732 -0
  47. package/src/formatters/number/README.mdx +542 -0
  48. package/src/formatters/pipeline/README.mdx +629 -0
  49. package/src/formatters/rowBased/README.mdx +486 -0
  50. package/src/formatters/strings/README.mdx +442 -0
  51. package/src/formatters/valueState/README.mdx +459 -0
  52. package/src/formulas/README.mdx +1283 -0
  53. package/src/foundationLib.mdx +70 -54
  54. package/src/hooks/README.mdx +988 -0
  55. package/src/http/README.mdx +126 -0
  56. package/src/media/README.mdx +1853 -0
  57. package/src/notifications/README.mdx +323 -0
  58. package/src/number-scale/README.mdx +318 -0
  59. package/src/odata-service/README.mdx +2916 -0
  60. package/src/presets/README.mdx +136 -0
  61. package/src/pwa/README.mdx +394 -0
  62. package/src/query-client/README.mdx +2500 -0
  63. package/src/range-output/README.mdx +161 -0
  64. package/src/seo/README.mdx +279 -0
  65. package/src/session-storage/README.mdx +125 -0
  66. package/src/string-comparison/README.mdx +96 -0
  67. package/src/table/README.mdx +3106 -0
  68. package/src/three-scene/README.mdx +248 -0
  69. package/src/types/README.mdx +172 -0
  70. package/src/utils/README.mdx +1724 -0
  71. package/src/validators/README.mdx +239 -0
  72. package/src/virtualizer/README.mdx +138 -0
  73. package/src/xml/README.mdx +149 -0
  74. package/dist/chunks/dateUtils-B5V5aXB-.js +0 -847
  75. package/dist/chunks/dateUtils-B5V5aXB-.js.map +0 -1
  76. package/dist/chunks/odata-service-B6TxBSLm.js +0 -1277
  77. package/dist/chunks/odata-service-B6TxBSLm.js.map +0 -1
  78. package/dist/odata/buildSeparatedArrays.d.ts.map +0 -1
  79. package/dist/odata/dateUtils.d.ts.map +0 -1
  80. package/dist/odata/findCollectionPairs.d.ts.map +0 -1
  81. package/dist/odata/index.d.ts +0 -6
  82. package/dist/odata/index.d.ts.map +0 -1
  83. package/dist/odata/index.js +0 -102
  84. package/dist/odata/index.js.map +0 -1
  85. package/dist/odata/store.d.ts.map +0 -1
  86. package/dist/odata/types.d.ts.map +0 -1
  87. package/src/binary/README.md +0 -110
  88. package/src/docs/browserAndReact.mdx +0 -150
  89. package/src/docs/filesAndExcel.mdx +0 -163
  90. package/src/docs/formatters-runtime.mdx +0 -455
  91. package/src/docs/formatters.mdx +0 -380
  92. package/src/docs/odataAndTables.mdx +0 -178
  93. package/src/docs/pureUtilities.mdx +0 -96
  94. package/src/docs/runtimeAndState.mdx +0 -155
  95. package/src/file/README.md +0 -289
  96. package/src/formatters/date/README.md +0 -520
  97. package/src/formatters/number/README.md +0 -123
  98. package/src/formatters/valueState/README.md +0 -275
  99. package/src/formulas/README.md +0 -42
  100. package/src/pwa/README.md +0 -638
  101. package/src/query-client/README.md +0 -565
package/src/foundationLib.mdx CHANGED
@@ -40,66 +40,82 @@ import { formatDateAsDate } from "@ryuzaki13/react-foundation-lib";
40
40
 
41
41
  Большинство pure helpers не требуют React. Entry point с React hook, DOM, browser storage или Service Worker должен вызываться только в браузерном runtime и по правилам React hooks. Совместимые peer dependencies должны быть разрешены host-проектом для используемого entrypoint.
42
42
 
43
- | Возможность | Когда нужна в host |
44
- | ----------------------------------------------- | ---------------------------------------------------------------------------- |
45
- | `react` | `hooks`, `dom`, `copy`, `media`, `pwa`, `three-scene`, selection/table hooks |
46
- | `@tanstack/react-query`, persistence, broadcast | `query-client`, часть `error-report` |
47
- | `@tanstack/react-table` | `table` |
48
- | `@tanstack/react-virtual` | `virtualizer` |
49
- | `@tanstack/react-router` | search helpers из `hooks` |
50
- | `@floating-ui/react` | `useFloatingListbox`, DOM reference guards |
51
- | `@dnd-kit/core`, `@dnd-kit/sortable` | `useDndSortableSensors` |
52
- | `zustand`, `immer` | `notifications`, OData store |
53
- | `zod` | `odata-service` schemas |
54
- | `write-excel-file` | `excel` |
43
+ | Возможность | Когда нужна в host |
44
+ | ----------------------------------------------- | ------------------------------------------------------------------------------------------ |
45
+ | `react` | `hooks`, `dom`, `copy`, `media`, `pwa`, `three-scene`, selection/table и OData store hooks |
46
+ | `@tanstack/react-query`, persistence, broadcast | `query-client`, часть `error-report` |
47
+ | `@tanstack/react-table` | `table` |
48
+ | `@tanstack/react-virtual` | `virtualizer` |
49
+ | `@tanstack/react-router` | search helpers из `hooks` |
50
+ | `@floating-ui/react` | `useFloatingListbox`, DOM reference guards |
51
+ | `@dnd-kit/core`, `@dnd-kit/sortable` | `useDndSortableSensors` |
52
+ | `zustand`, `immer`, `zod` | единый `odata-service`: collection store и OData schemas |
53
+ | `zustand` | `notifications` |
54
+ | `write-excel-file` | `excel` |
55
+ | `@fingerprintjs/fingerprintjs` | `fingerprint` |
55
56
 
56
57
  ## Выбор entrypoint
57
58
 
58
- | Сценарий | Точный import |
59
- | ---------------------------------------------------- | ----------------------------------------------------- |
60
- | Массивы, дедупликация, grouping, reorder | `@ryuzaki13/react-foundation-lib/array` |
61
- | Base64 и `Blob` | `@ryuzaki13/react-foundation-lib/binary` |
62
- | Ограниченный стек копий | `@ryuzaki13/react-foundation-lib/bounded-copy-stack` |
63
- | Anchor и state контекстного меню | `@ryuzaki13/react-foundation-lib/context-menu` |
64
- | Clipboard и feedback hooks | `@ryuzaki13/react-foundation-lib/copy` |
65
- | Hash и UUID | `@ryuzaki13/react-foundation-lib/crypto` |
66
- | Валютные labels по OData-параметрам | `@ryuzaki13/react-foundation-lib/currency` |
67
- | Сегменты маски даты | `@ryuzaki13/react-foundation-lib/date-segments` |
68
- | Portal, focus, observers, browser download | `@ryuzaki13/react-foundation-lib/dom` |
69
- | Ошибка отсутствующего React context | `@ryuzaki13/react-foundation-lib/error` |
70
- | Подготовка и диагностика error report | `@ryuzaki13/react-foundation-lib/error-report` |
71
- | Excel и экспорт таблиц | `@ryuzaki13/react-foundation-lib/excel` |
72
- | `FileReader`, MIME, Content-Disposition, изображения | `@ryuzaki13/react-foundation-lib/file` |
73
- | Client fingerprint | `@ryuzaki13/react-foundation-lib/fingerprint` |
74
- | Form errors и presets | `@ryuzaki13/react-foundation-lib/form` |
75
- | Даты, числа, строки, pipeline и value state | `@ryuzaki13/react-foundation-lib/formatters` |
76
- | Реестр и выполнение клиентских формул таблицы | `@ryuzaki13/react-foundation-lib/formulas` |
77
- | Общие React hooks | `@ryuzaki13/react-foundation-lib/hooks` |
78
- | HTTP headers и text `Response` | `@ryuzaki13/react-foundation-lib/http` |
79
- | Breakpoints и media-query hooks | `@ryuzaki13/react-foundation-lib/media` |
80
- | Imperative notifications и store | `@ryuzaki13/react-foundation-lib/notifications` |
81
- | Математика slider/scale | `@ryuzaki13/react-foundation-lib/number-scale` |
82
- | OData code/text collections и store | `@ryuzaki13/react-foundation-lib/odata` |
83
- | OData V2 metadata, builder, filters, formats | `@ryuzaki13/react-foundation-lib/odata-service` |
84
- | Нормализация сохранённых preset ids | `@ryuzaki13/react-foundation-lib/presets` |
85
- | Service Worker update и cache policy | `@ryuzaki13/react-foundation-lib/pwa` |
86
- | Только cache policy | `@ryuzaki13/react-foundation-lib/pwa/sw-cache-policy` |
87
- | QueryClient, persistence, broadcast | `@ryuzaki13/react-foundation-lib/query-client` |
88
- | Вывод открытых границ диапазона | `@ryuzaki13/react-foundation-lib/range-output` |
89
- | SEO/head metadata contracts | `@ryuzaki13/react-foundation-lib/seo` |
90
- | ID в `sessionStorage` | `@ryuzaki13/react-foundation-lib/session-storage` |
91
- | Предсказуемое строковое сравнение | `@ryuzaki13/react-foundation-lib/string-comparison` |
92
- | TanStack Table layout, selection и OData adapter | `@ryuzaki13/react-foundation-lib/table` |
93
- | Проверка доступности Three.js | `@ryuzaki13/react-foundation-lib/three-scene` |
94
- | Построение tree-table rows | `@ryuzaki13/react-foundation-lib/tree-table` |
95
- | Общие TypeScript contracts | `@ryuzaki13/react-foundation-lib/types` |
96
- | Clone, className, keyboard, stable stringify, tree | `@ryuzaki13/react-foundation-lib/utils` |
97
- | Runtime guards и URL/image validation | `@ryuzaki13/react-foundation-lib/validators` |
98
- | Infinite-query подгрузка virtualizer | `@ryuzaki13/react-foundation-lib/virtualizer` |
99
- | XML parse/build | `@ryuzaki13/react-foundation-lib/xml` |
59
+ | Сценарий | Точный import |
60
+ | --------------------------------------------------------------------------------- | ----------------------------------------------------- |
61
+ | Массивы, дедупликация, grouping, reorder | `@ryuzaki13/react-foundation-lib/array` |
62
+ | Base64 и `Blob` | `@ryuzaki13/react-foundation-lib/binary` |
63
+ | Ограниченный стек копий | `@ryuzaki13/react-foundation-lib/bounded-copy-stack` |
64
+ | Anchor и state контекстного меню | `@ryuzaki13/react-foundation-lib/context-menu` |
65
+ | Clipboard и feedback hooks | `@ryuzaki13/react-foundation-lib/copy` |
66
+ | Hash и UUID | `@ryuzaki13/react-foundation-lib/crypto` |
67
+ | Валютные labels по OData-параметрам | `@ryuzaki13/react-foundation-lib/currency` |
68
+ | Сегменты маски даты | `@ryuzaki13/react-foundation-lib/date-segments` |
69
+ | Portal, focus, observers, browser download | `@ryuzaki13/react-foundation-lib/dom` |
70
+ | Ошибка отсутствующего React context | `@ryuzaki13/react-foundation-lib/error` |
71
+ | Подготовка и диагностика error report | `@ryuzaki13/react-foundation-lib/error-report` |
72
+ | Excel и экспорт таблиц | `@ryuzaki13/react-foundation-lib/excel` |
73
+ | `FileReader`, MIME, Content-Disposition, изображения | `@ryuzaki13/react-foundation-lib/file` |
74
+ | Client fingerprint | `@ryuzaki13/react-foundation-lib/fingerprint` |
75
+ | Form errors и presets | `@ryuzaki13/react-foundation-lib/form` |
76
+ | Даты, числа, строки, pipeline и value state | `@ryuzaki13/react-foundation-lib/formatters` |
77
+ | Реестр и выполнение клиентских формул таблицы | `@ryuzaki13/react-foundation-lib/formulas` |
78
+ | Общие React hooks | `@ryuzaki13/react-foundation-lib/hooks` |
79
+ | HTTP headers и text `Response` | `@ryuzaki13/react-foundation-lib/http` |
80
+ | Breakpoints и media-query hooks | `@ryuzaki13/react-foundation-lib/media` |
81
+ | Imperative notifications и store | `@ryuzaki13/react-foundation-lib/notifications` |
82
+ | Математика slider/scale | `@ryuzaki13/react-foundation-lib/number-scale` |
83
+ | OData V2 metadata, values, builder, filters, sorts, code/text collections и store | `@ryuzaki13/react-foundation-lib/odata-service` |
84
+ | Нормализация сохранённых preset ids | `@ryuzaki13/react-foundation-lib/presets` |
85
+ | Service Worker update и cache policy | `@ryuzaki13/react-foundation-lib/pwa` |
86
+ | Только cache policy | `@ryuzaki13/react-foundation-lib/pwa/sw-cache-policy` |
87
+ | QueryClient, persistence, broadcast | `@ryuzaki13/react-foundation-lib/query-client` |
88
+ | Вывод открытых границ диапазона | `@ryuzaki13/react-foundation-lib/range-output` |
89
+ | SEO/head metadata contracts | `@ryuzaki13/react-foundation-lib/seo` |
90
+ | ID в `sessionStorage` | `@ryuzaki13/react-foundation-lib/session-storage` |
91
+ | Предсказуемое строковое сравнение | `@ryuzaki13/react-foundation-lib/string-comparison` |
92
+ | TanStack Table layout, selection и OData adapter | `@ryuzaki13/react-foundation-lib/table` |
93
+ | Проверка доступности Three.js | `@ryuzaki13/react-foundation-lib/three-scene` |
94
+ | Построение tree-table rows | `@ryuzaki13/react-foundation-lib/tree-table` |
95
+ | Общие TypeScript contracts | `@ryuzaki13/react-foundation-lib/types` |
96
+ | Clone, className, keyboard, stable stringify, tree | `@ryuzaki13/react-foundation-lib/utils` |
97
+ | Runtime guards и URL/image validation | `@ryuzaki13/react-foundation-lib/validators` |
98
+ | Infinite-query подгрузка virtualizer | `@ryuzaki13/react-foundation-lib/virtualizer` |
99
+ | XML parse/build | `@ryuzaki13/react-foundation-lib/xml` |
100
100
 
101
101
  ## Как читать справочник
102
102
 
103
103
  Каждая последующая страница построена вокруг **published subpath**, а не каталога исходников. В ней указаны точный import, публичные contracts, обязательная инициализация, результат, lifecycle/cleanup и ограничения. Для pure helpers достаточно вызвать функцию; registry, browser и global-store API требуют отдельного раздела «Инициализация и side effects».
104
104
 
105
+ Связанные entrypoint `table` и `tree-table` описаны на одной странице [Table и Tree Table](./table/README.mdx): документ общий, но публичные import path остаются раздельными.
106
+
107
+ Для общего entrypoint clone, className, keyboard, stable stringify, lazy React components и tree helpers доступен подробный справочник [Utils](./utils/README.mdx).
108
+
109
+ ## Каталог подробных страниц
110
+
111
+ | Область | Документы |
112
+ | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
113
+ | Данные и низкоуровневые helpers | [Array](./array/README.mdx), [Binary](./binary/README.mdx), [Bounded Copy Stack](./bounded-copy-stack/README.mdx), [Crypto](./crypto/README.mdx), [Types](./types/README.mdx), [Utils](./utils/README.mdx), [Validators](./validators/README.mdx), [XML](./xml/README.mdx) |
114
+ | Значения и форматирование | [Currency](./currency/README.mdx), [Date Segments](./date-segments/README.mdx), [Formatters](./formatters/README.mdx), [Formulas](./formulas/README.mdx), [Number Scale](./number-scale/README.mdx), [Presets](./presets/README.mdx), [Range Output](./range-output/README.mdx), [String Comparison](./string-comparison/README.mdx) |
115
+ | Browser и React | [Context Menu](./context-menu/README.mdx), [Copy](./copy/README.mdx), [DOM](./dom/README.mdx), [File](./file/README.mdx), [Fingerprint](./fingerprint/README.mdx), [Hooks](./hooks/README.mdx), [Media](./media/README.mdx), [PWA](./pwa/README.mdx), [Three Scene](./three-scene/README.mdx), [Virtualizer](./virtualizer/README.mdx) |
116
+ | State и инфраструктура | [Error](./error/README.mdx), [Error Report](./error-report/README.mdx), [Form](./form/README.mdx), [HTTP](./http/README.mdx), [Notifications](./notifications/README.mdx), [Query Client](./query-client/README.mdx), [Session Storage](./session-storage/README.mdx) |
117
+ | OData, таблицы и представление | [Excel](./excel/README.mdx), [OData Service](./odata-service/README.mdx), [SEO](./seo/README.mdx), [Table и Tree Table](./table/README.mdx) |
118
+
119
+ У `formatters` есть дополнительные страницы для [boolean](./formatters/boolean/README.mdx), [date](./formatters/date/README.mdx), [number](./formatters/number/README.mdx), [pipeline](./formatters/pipeline/README.mdx), [row-based форматирования](./formatters/rowBased/README.mdx), [strings](./formatters/strings/README.mdx) и [value state](./formatters/valueState/README.mdx).
120
+
105
121
  Если API не описан как публичный на соответствующей странице, не импортируйте его глубоким путём из `src` или `dist`: это не часть стабильного consumer contract.