shared-lib-web 0.0.0-stage → 0.0.3

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 (692) hide show
  1. package/CODING_RULES.md +118 -0
  2. package/LICENSE +21 -0
  3. package/README.md +884 -2
  4. package/dist/components/app-brand.d.ts +9 -0
  5. package/dist/components/app-brand.d.ts.map +1 -0
  6. package/dist/components/app-brand.js +27 -0
  7. package/dist/components/app-brand.js.map +1 -0
  8. package/dist/components/branch-switcher.d.ts +7 -0
  9. package/dist/components/branch-switcher.d.ts.map +1 -0
  10. package/dist/components/branch-switcher.js +37 -0
  11. package/dist/components/branch-switcher.js.map +1 -0
  12. package/dist/components/coming-soon.d.ts +6 -0
  13. package/dist/components/coming-soon.d.ts.map +1 -0
  14. package/dist/components/coming-soon.js +20 -0
  15. package/dist/components/coming-soon.js.map +1 -0
  16. package/dist/components/empty-state.d.ts +15 -0
  17. package/dist/components/empty-state.d.ts.map +1 -0
  18. package/dist/components/empty-state.js +14 -0
  19. package/dist/components/empty-state.js.map +1 -0
  20. package/dist/components/language-switcher.d.ts +12 -0
  21. package/dist/components/language-switcher.d.ts.map +1 -0
  22. package/dist/components/language-switcher.js +61 -0
  23. package/dist/components/language-switcher.js.map +1 -0
  24. package/dist/components/page-loader.d.ts +2 -0
  25. package/dist/components/page-loader.d.ts.map +1 -0
  26. package/dist/components/page-loader.js +8 -0
  27. package/dist/components/page-loader.js.map +1 -0
  28. package/dist/components/page-not-found.d.ts +2 -0
  29. package/dist/components/page-not-found.d.ts.map +1 -0
  30. package/dist/components/page-not-found.js +18 -0
  31. package/dist/components/page-not-found.js.map +1 -0
  32. package/dist/components/permission-denied.d.ts +2 -0
  33. package/dist/components/permission-denied.d.ts.map +1 -0
  34. package/dist/components/permission-denied.js +12 -0
  35. package/dist/components/permission-denied.js.map +1 -0
  36. package/dist/components/require-access.d.ts +11 -0
  37. package/dist/components/require-access.d.ts.map +1 -0
  38. package/dist/components/require-access.js +15 -0
  39. package/dist/components/require-access.js.map +1 -0
  40. package/dist/components/scroll-to-top.d.ts +12 -0
  41. package/dist/components/scroll-to-top.d.ts.map +1 -0
  42. package/dist/components/scroll-to-top.js +42 -0
  43. package/dist/components/scroll-to-top.js.map +1 -0
  44. package/dist/components/settings-menu.d.ts +21 -0
  45. package/dist/components/settings-menu.d.ts.map +1 -0
  46. package/dist/components/settings-menu.js +115 -0
  47. package/dist/components/settings-menu.js.map +1 -0
  48. package/dist/components/theme-switcher.d.ts +5 -0
  49. package/dist/components/theme-switcher.d.ts.map +1 -0
  50. package/dist/components/theme-switcher.js +33 -0
  51. package/dist/components/theme-switcher.js.map +1 -0
  52. package/dist/components/toast-container.d.ts +5 -0
  53. package/dist/components/toast-container.d.ts.map +1 -0
  54. package/dist/components/toast-container.js +51 -0
  55. package/dist/components/toast-container.js.map +1 -0
  56. package/dist/components/top-progress.d.ts +2 -0
  57. package/dist/components/top-progress.d.ts.map +1 -0
  58. package/dist/components/top-progress.js +14 -0
  59. package/dist/components/top-progress.js.map +1 -0
  60. package/dist/components/user-menu.d.ts +26 -0
  61. package/dist/components/user-menu.d.ts.map +1 -0
  62. package/dist/components/user-menu.js +85 -0
  63. package/dist/components/user-menu.js.map +1 -0
  64. package/dist/context/ui-context.d.ts +5 -0
  65. package/dist/context/ui-context.d.ts.map +1 -0
  66. package/dist/context/ui-context.js +16 -0
  67. package/dist/context/ui-context.js.map +1 -0
  68. package/dist/context/use-ui.d.ts +3 -0
  69. package/dist/context/use-ui.d.ts.map +1 -0
  70. package/dist/context/use-ui.js +40 -0
  71. package/dist/context/use-ui.js.map +1 -0
  72. package/dist/i18n/browser-language.d.ts +9 -0
  73. package/dist/i18n/browser-language.d.ts.map +1 -0
  74. package/dist/i18n/browser-language.js +89 -0
  75. package/dist/i18n/browser-language.js.map +1 -0
  76. package/dist/i18n/default-messages.d.ts +5 -0
  77. package/dist/i18n/default-messages.d.ts.map +1 -0
  78. package/dist/i18n/default-messages.js +67 -0
  79. package/dist/i18n/default-messages.js.map +1 -0
  80. package/dist/i18n/direction.d.ts +10 -0
  81. package/dist/i18n/direction.d.ts.map +1 -0
  82. package/dist/i18n/direction.js +35 -0
  83. package/dist/i18n/direction.js.map +1 -0
  84. package/dist/i18n/locale-groups.d.ts +18 -0
  85. package/dist/i18n/locale-groups.d.ts.map +1 -0
  86. package/dist/i18n/locale-groups.js +74 -0
  87. package/dist/i18n/locale-groups.js.map +1 -0
  88. package/dist/i18n/locale-service.d.ts +54 -0
  89. package/dist/i18n/locale-service.d.ts.map +1 -0
  90. package/dist/i18n/locale-service.js +231 -0
  91. package/dist/i18n/locale-service.js.map +1 -0
  92. package/dist/i18n/locale-signal.d.ts +18 -0
  93. package/dist/i18n/locale-signal.d.ts.map +1 -0
  94. package/dist/i18n/locale-signal.js +142 -0
  95. package/dist/i18n/locale-signal.js.map +1 -0
  96. package/dist/i18n/translator.d.ts +21 -0
  97. package/dist/i18n/translator.d.ts.map +1 -0
  98. package/dist/i18n/translator.js +105 -0
  99. package/dist/i18n/translator.js.map +1 -0
  100. package/dist/index.d.ts +117 -0
  101. package/dist/index.d.ts.map +1 -0
  102. package/dist/index.js +130 -0
  103. package/dist/index.js.map +1 -0
  104. package/dist/interfaces/app-types.d.ts +143 -0
  105. package/dist/interfaces/app-types.d.ts.map +1 -0
  106. package/dist/interfaces/app-types.js +5 -0
  107. package/dist/interfaces/app-types.js.map +1 -0
  108. package/dist/interfaces/toast.d.ts +9 -0
  109. package/dist/interfaces/toast.d.ts.map +1 -0
  110. package/dist/interfaces/toast.js +4 -0
  111. package/dist/interfaces/toast.js.map +1 -0
  112. package/dist/interfaces/ui-config.d.ts +319 -0
  113. package/dist/interfaces/ui-config.d.ts.map +1 -0
  114. package/dist/interfaces/ui-config.js +6 -0
  115. package/dist/interfaces/ui-config.js.map +1 -0
  116. package/dist/interfaces/ui-context.d.ts +37 -0
  117. package/dist/interfaces/ui-context.d.ts.map +1 -0
  118. package/dist/interfaces/ui-context.js +4 -0
  119. package/dist/interfaces/ui-context.js.map +1 -0
  120. package/dist/layout.d.ts +10 -0
  121. package/dist/layout.d.ts.map +1 -0
  122. package/dist/layout.js +22 -0
  123. package/dist/layout.js.map +1 -0
  124. package/dist/layouts/app-layout.d.ts +23 -0
  125. package/dist/layouts/app-layout.d.ts.map +1 -0
  126. package/dist/layouts/app-layout.js +52 -0
  127. package/dist/layouts/app-layout.js.map +1 -0
  128. package/dist/layouts/article-layout.d.ts +7 -0
  129. package/dist/layouts/article-layout.d.ts.map +1 -0
  130. package/dist/layouts/article-layout.js +8 -0
  131. package/dist/layouts/article-layout.js.map +1 -0
  132. package/dist/layouts/aside-layout.d.ts +27 -0
  133. package/dist/layouts/aside-layout.d.ts.map +1 -0
  134. package/dist/layouts/aside-layout.js +70 -0
  135. package/dist/layouts/aside-layout.js.map +1 -0
  136. package/dist/layouts/auth-layout.d.ts +7 -0
  137. package/dist/layouts/auth-layout.d.ts.map +1 -0
  138. package/dist/layouts/auth-layout.js +20 -0
  139. package/dist/layouts/auth-layout.js.map +1 -0
  140. package/dist/layouts/content-layout.d.ts +3 -0
  141. package/dist/layouts/content-layout.d.ts.map +1 -0
  142. package/dist/layouts/content-layout.js +10 -0
  143. package/dist/layouts/content-layout.js.map +1 -0
  144. package/dist/layouts/float-layout.d.ts +3 -0
  145. package/dist/layouts/float-layout.d.ts.map +1 -0
  146. package/dist/layouts/float-layout.js +10 -0
  147. package/dist/layouts/float-layout.js.map +1 -0
  148. package/dist/layouts/grid-layout.d.ts +3 -0
  149. package/dist/layouts/grid-layout.d.ts.map +1 -0
  150. package/dist/layouts/grid-layout.js +10 -0
  151. package/dist/layouts/grid-layout.js.map +1 -0
  152. package/dist/layouts/head-layout.d.ts +16 -0
  153. package/dist/layouts/head-layout.d.ts.map +1 -0
  154. package/dist/layouts/head-layout.js +36 -0
  155. package/dist/layouts/head-layout.js.map +1 -0
  156. package/dist/layouts/header.d.ts +18 -0
  157. package/dist/layouts/header.d.ts.map +1 -0
  158. package/dist/layouts/header.js +26 -0
  159. package/dist/layouts/header.js.map +1 -0
  160. package/dist/layouts/layout-constants.d.ts +3 -0
  161. package/dist/layouts/layout-constants.d.ts.map +1 -0
  162. package/dist/layouts/layout-constants.js +5 -0
  163. package/dist/layouts/layout-constants.js.map +1 -0
  164. package/dist/layouts/mega-menu.d.ts +3 -0
  165. package/dist/layouts/mega-menu.d.ts.map +1 -0
  166. package/dist/layouts/mega-menu.js +104 -0
  167. package/dist/layouts/mega-menu.js.map +1 -0
  168. package/dist/layouts/navigation.d.ts +11 -0
  169. package/dist/layouts/navigation.d.ts.map +1 -0
  170. package/dist/layouts/navigation.js +41 -0
  171. package/dist/layouts/navigation.js.map +1 -0
  172. package/dist/layouts/rail-flyout.d.ts +5 -0
  173. package/dist/layouts/rail-flyout.d.ts.map +1 -0
  174. package/dist/layouts/rail-flyout.js +49 -0
  175. package/dist/layouts/rail-flyout.js.map +1 -0
  176. package/dist/layouts/rail-tooltip.d.ts +8 -0
  177. package/dist/layouts/rail-tooltip.d.ts.map +1 -0
  178. package/dist/layouts/rail-tooltip.js +60 -0
  179. package/dist/layouts/rail-tooltip.js.map +1 -0
  180. package/dist/layouts/sidebar.d.ts +38 -0
  181. package/dist/layouts/sidebar.d.ts.map +1 -0
  182. package/dist/layouts/sidebar.js +137 -0
  183. package/dist/layouts/sidebar.js.map +1 -0
  184. package/dist/markdown.d.ts +4 -0
  185. package/dist/markdown.d.ts.map +1 -0
  186. package/dist/markdown.js +12 -0
  187. package/dist/markdown.js.map +1 -0
  188. package/dist/providers/provider-effects.d.ts +9 -0
  189. package/dist/providers/provider-effects.d.ts.map +1 -0
  190. package/dist/providers/provider-effects.js +29 -0
  191. package/dist/providers/provider-effects.js.map +1 -0
  192. package/dist/providers/register-config.d.ts +4 -0
  193. package/dist/providers/register-config.d.ts.map +1 -0
  194. package/dist/providers/register-config.js +30 -0
  195. package/dist/providers/register-config.js.map +1 -0
  196. package/dist/providers/shared-web-ui-provider.d.ts +19 -0
  197. package/dist/providers/shared-web-ui-provider.d.ts.map +1 -0
  198. package/dist/providers/shared-web-ui-provider.js +53 -0
  199. package/dist/providers/shared-web-ui-provider.js.map +1 -0
  200. package/dist/providers/theme-provider.d.ts +6 -0
  201. package/dist/providers/theme-provider.d.ts.map +1 -0
  202. package/dist/providers/theme-provider.js +11 -0
  203. package/dist/providers/theme-provider.js.map +1 -0
  204. package/dist/providers/translation-provider.d.ts +8 -0
  205. package/dist/providers/translation-provider.d.ts.map +1 -0
  206. package/dist/providers/translation-provider.js +21 -0
  207. package/dist/providers/translation-provider.js.map +1 -0
  208. package/dist/query/page-link.d.ts +20 -0
  209. package/dist/query/page-link.d.ts.map +1 -0
  210. package/dist/query/page-link.js +53 -0
  211. package/dist/query/page-link.js.map +1 -0
  212. package/dist/query/page-path.d.ts +5 -0
  213. package/dist/query/page-path.d.ts.map +1 -0
  214. package/dist/query/page-path.js +24 -0
  215. package/dist/query/page-path.js.map +1 -0
  216. package/dist/query/query-param.d.ts +66 -0
  217. package/dist/query/query-param.d.ts.map +1 -0
  218. package/dist/query/query-param.js +218 -0
  219. package/dist/query/query-param.js.map +1 -0
  220. package/dist/query/use-query-param.d.ts +5 -0
  221. package/dist/query/use-query-param.d.ts.map +1 -0
  222. package/dist/query/use-query-param.js +21 -0
  223. package/dist/query/use-query-param.js.map +1 -0
  224. package/dist/skeleton/skeleton-article.d.ts +2 -0
  225. package/dist/skeleton/skeleton-article.d.ts.map +1 -0
  226. package/dist/skeleton/skeleton-article.js +7 -0
  227. package/dist/skeleton/skeleton-article.js.map +1 -0
  228. package/dist/skeleton/skeleton-auth-form.d.ts +6 -0
  229. package/dist/skeleton/skeleton-auth-form.d.ts.map +1 -0
  230. package/dist/skeleton/skeleton-auth-form.js +9 -0
  231. package/dist/skeleton/skeleton-auth-form.js.map +1 -0
  232. package/dist/skeleton/skeleton-cards.d.ts +6 -0
  233. package/dist/skeleton/skeleton-cards.d.ts.map +1 -0
  234. package/dist/skeleton/skeleton-cards.js +16 -0
  235. package/dist/skeleton/skeleton-cards.js.map +1 -0
  236. package/dist/skeleton/skeleton-chat.d.ts +2 -0
  237. package/dist/skeleton/skeleton-chat.d.ts.map +1 -0
  238. package/dist/skeleton/skeleton-chat.js +17 -0
  239. package/dist/skeleton/skeleton-chat.js.map +1 -0
  240. package/dist/skeleton/skeleton-dashboard.d.ts +2 -0
  241. package/dist/skeleton/skeleton-dashboard.d.ts.map +1 -0
  242. package/dist/skeleton/skeleton-dashboard.js +16 -0
  243. package/dist/skeleton/skeleton-dashboard.js.map +1 -0
  244. package/dist/skeleton/skeleton-float.d.ts +2 -0
  245. package/dist/skeleton/skeleton-float.d.ts.map +1 -0
  246. package/dist/skeleton/skeleton-float.js +7 -0
  247. package/dist/skeleton/skeleton-float.js.map +1 -0
  248. package/dist/skeleton/skeleton-form.d.ts +10 -0
  249. package/dist/skeleton/skeleton-form.d.ts.map +1 -0
  250. package/dist/skeleton/skeleton-form.js +16 -0
  251. package/dist/skeleton/skeleton-form.js.map +1 -0
  252. package/dist/skeleton/skeleton-menu.d.ts +2 -0
  253. package/dist/skeleton/skeleton-menu.d.ts.map +1 -0
  254. package/dist/skeleton/skeleton-menu.js +16 -0
  255. package/dist/skeleton/skeleton-menu.js.map +1 -0
  256. package/dist/skeleton/skeleton-page.d.ts +2 -0
  257. package/dist/skeleton/skeleton-page.d.ts.map +1 -0
  258. package/dist/skeleton/skeleton-page.js +9 -0
  259. package/dist/skeleton/skeleton-page.js.map +1 -0
  260. package/dist/skeleton/skeleton-table.d.ts +2 -0
  261. package/dist/skeleton/skeleton-table.d.ts.map +1 -0
  262. package/dist/skeleton/skeleton-table.js +16 -0
  263. package/dist/skeleton/skeleton-table.js.map +1 -0
  264. package/dist/state/api-loader.d.ts +19 -0
  265. package/dist/state/api-loader.d.ts.map +1 -0
  266. package/dist/state/api-loader.js +187 -0
  267. package/dist/state/api-loader.js.map +1 -0
  268. package/dist/state/auth-service.d.ts +32 -0
  269. package/dist/state/auth-service.d.ts.map +1 -0
  270. package/dist/state/auth-service.js +136 -0
  271. package/dist/state/auth-service.js.map +1 -0
  272. package/dist/state/branch-service.d.ts +42 -0
  273. package/dist/state/branch-service.d.ts.map +1 -0
  274. package/dist/state/branch-service.js +193 -0
  275. package/dist/state/branch-service.js.map +1 -0
  276. package/dist/state/company-service.d.ts +16 -0
  277. package/dist/state/company-service.d.ts.map +1 -0
  278. package/dist/state/company-service.js +97 -0
  279. package/dist/state/company-service.js.map +1 -0
  280. package/dist/state/document-sync.d.ts +7 -0
  281. package/dist/state/document-sync.d.ts.map +1 -0
  282. package/dist/state/document-sync.js +39 -0
  283. package/dist/state/document-sync.js.map +1 -0
  284. package/dist/state/language-service.d.ts +19 -0
  285. package/dist/state/language-service.d.ts.map +1 -0
  286. package/dist/state/language-service.js +78 -0
  287. package/dist/state/language-service.js.map +1 -0
  288. package/dist/state/layout-choice-service.d.ts +10 -0
  289. package/dist/state/layout-choice-service.d.ts.map +1 -0
  290. package/dist/state/layout-choice-service.js +34 -0
  291. package/dist/state/layout-choice-service.js.map +1 -0
  292. package/dist/state/menu-service.d.ts +20 -0
  293. package/dist/state/menu-service.d.ts.map +1 -0
  294. package/dist/state/menu-service.js +59 -0
  295. package/dist/state/menu-service.js.map +1 -0
  296. package/dist/state/navigation-service.d.ts +37 -0
  297. package/dist/state/navigation-service.d.ts.map +1 -0
  298. package/dist/state/navigation-service.js +131 -0
  299. package/dist/state/navigation-service.js.map +1 -0
  300. package/dist/state/preference-sync.d.ts +15 -0
  301. package/dist/state/preference-sync.d.ts.map +1 -0
  302. package/dist/state/preference-sync.js +93 -0
  303. package/dist/state/preference-sync.js.map +1 -0
  304. package/dist/state/progress-service.d.ts +3 -0
  305. package/dist/state/progress-service.d.ts.map +1 -0
  306. package/dist/state/progress-service.js +17 -0
  307. package/dist/state/progress-service.js.map +1 -0
  308. package/dist/state/screen-access.d.ts +15 -0
  309. package/dist/state/screen-access.d.ts.map +1 -0
  310. package/dist/state/screen-access.js +60 -0
  311. package/dist/state/screen-access.js.map +1 -0
  312. package/dist/state/sidebar-service.d.ts +8 -0
  313. package/dist/state/sidebar-service.d.ts.map +1 -0
  314. package/dist/state/sidebar-service.js +18 -0
  315. package/dist/state/sidebar-service.js.map +1 -0
  316. package/dist/state/signals.d.ts +92 -0
  317. package/dist/state/signals.d.ts.map +1 -0
  318. package/dist/state/signals.js +161 -0
  319. package/dist/state/signals.js.map +1 -0
  320. package/dist/state/toast-service.d.ts +9 -0
  321. package/dist/state/toast-service.d.ts.map +1 -0
  322. package/dist/state/toast-service.js +36 -0
  323. package/dist/state/toast-service.js.map +1 -0
  324. package/dist/styles.css +15 -0
  325. package/dist/theme/custom-themes.d.ts +28 -0
  326. package/dist/theme/custom-themes.d.ts.map +1 -0
  327. package/dist/theme/custom-themes.js +218 -0
  328. package/dist/theme/custom-themes.js.map +1 -0
  329. package/dist/theme/dark-themes.d.ts +10 -0
  330. package/dist/theme/dark-themes.d.ts.map +1 -0
  331. package/dist/theme/dark-themes.js +92 -0
  332. package/dist/theme/dark-themes.js.map +1 -0
  333. package/dist/theme/logo.d.ts +7 -0
  334. package/dist/theme/logo.d.ts.map +1 -0
  335. package/dist/theme/logo.js +24 -0
  336. package/dist/theme/logo.js.map +1 -0
  337. package/dist/theme/theme-service.d.ts +32 -0
  338. package/dist/theme/theme-service.d.ts.map +1 -0
  339. package/dist/theme/theme-service.js +123 -0
  340. package/dist/theme/theme-service.js.map +1 -0
  341. package/dist/types/class-names.d.ts +9 -0
  342. package/dist/types/class-names.d.ts.map +1 -0
  343. package/dist/types/class-names.js +45 -0
  344. package/dist/types/class-names.js.map +1 -0
  345. package/dist/types/field-error.d.ts +5 -0
  346. package/dist/types/field-error.d.ts.map +1 -0
  347. package/dist/types/field-error.js +16 -0
  348. package/dist/types/field-error.js.map +1 -0
  349. package/dist/types/field-props.d.ts +20 -0
  350. package/dist/types/field-props.d.ts.map +1 -0
  351. package/dist/types/field-props.js +4 -0
  352. package/dist/types/field-props.js.map +1 -0
  353. package/dist/types/field-registry.d.ts +11 -0
  354. package/dist/types/field-registry.d.ts.map +1 -0
  355. package/dist/types/field-registry.js +18 -0
  356. package/dist/types/field-registry.js.map +1 -0
  357. package/dist/types/field-wrapper.d.ts +13 -0
  358. package/dist/types/field-wrapper.d.ts.map +1 -0
  359. package/dist/types/field-wrapper.js +16 -0
  360. package/dist/types/field-wrapper.js.map +1 -0
  361. package/dist/types/lang-field.d.ts +15 -0
  362. package/dist/types/lang-field.d.ts.map +1 -0
  363. package/dist/types/lang-field.js +68 -0
  364. package/dist/types/lang-field.js.map +1 -0
  365. package/dist/types/markdown-color-mode.d.ts +7 -0
  366. package/dist/types/markdown-color-mode.d.ts.map +1 -0
  367. package/dist/types/markdown-color-mode.js +11 -0
  368. package/dist/types/markdown-color-mode.js.map +1 -0
  369. package/dist/types/media-service.d.ts +24 -0
  370. package/dist/types/media-service.d.ts.map +1 -0
  371. package/dist/types/media-service.js +41 -0
  372. package/dist/types/media-service.js.map +1 -0
  373. package/dist/types/media-viewer.d.ts +2 -0
  374. package/dist/types/media-viewer.d.ts.map +1 -0
  375. package/dist/types/media-viewer.js +23 -0
  376. package/dist/types/media-viewer.js.map +1 -0
  377. package/dist/types/type.button.d.ts +36 -0
  378. package/dist/types/type.button.d.ts.map +1 -0
  379. package/dist/types/type.button.js +27 -0
  380. package/dist/types/type.button.js.map +1 -0
  381. package/dist/types/type.checkbox.d.ts +5 -0
  382. package/dist/types/type.checkbox.d.ts.map +1 -0
  383. package/dist/types/type.checkbox.js +26 -0
  384. package/dist/types/type.checkbox.js.map +1 -0
  385. package/dist/types/type.confirm.d.ts +19 -0
  386. package/dist/types/type.confirm.d.ts.map +1 -0
  387. package/dist/types/type.confirm.js +15 -0
  388. package/dist/types/type.confirm.js.map +1 -0
  389. package/dist/types/type.date.d.ts +16 -0
  390. package/dist/types/type.date.d.ts.map +1 -0
  391. package/dist/types/type.date.js +65 -0
  392. package/dist/types/type.date.js.map +1 -0
  393. package/dist/types/type.drawer.d.ts +20 -0
  394. package/dist/types/type.drawer.d.ts.map +1 -0
  395. package/dist/types/type.drawer.js +31 -0
  396. package/dist/types/type.drawer.js.map +1 -0
  397. package/dist/types/type.dropdown.d.ts +23 -0
  398. package/dist/types/type.dropdown.d.ts.map +1 -0
  399. package/dist/types/type.dropdown.js +34 -0
  400. package/dist/types/type.dropdown.js.map +1 -0
  401. package/dist/types/type.filter.d.ts +17 -0
  402. package/dist/types/type.filter.d.ts.map +1 -0
  403. package/dist/types/type.filter.js +28 -0
  404. package/dist/types/type.filter.js.map +1 -0
  405. package/dist/types/type.icon.d.ts +21 -0
  406. package/dist/types/type.icon.d.ts.map +1 -0
  407. package/dist/types/type.icon.js +24 -0
  408. package/dist/types/type.icon.js.map +1 -0
  409. package/dist/types/type.image.d.ts +34 -0
  410. package/dist/types/type.image.d.ts.map +1 -0
  411. package/dist/types/type.image.js +46 -0
  412. package/dist/types/type.image.js.map +1 -0
  413. package/dist/types/type.input.d.ts +13 -0
  414. package/dist/types/type.input.d.ts.map +1 -0
  415. package/dist/types/type.input.js +29 -0
  416. package/dist/types/type.input.js.map +1 -0
  417. package/dist/types/type.lang-md.d.ts +10 -0
  418. package/dist/types/type.lang-md.d.ts.map +1 -0
  419. package/dist/types/type.lang-md.js +56 -0
  420. package/dist/types/type.lang-md.js.map +1 -0
  421. package/dist/types/type.lang.d.ts +11 -0
  422. package/dist/types/type.lang.d.ts.map +1 -0
  423. package/dist/types/type.lang.js +56 -0
  424. package/dist/types/type.lang.js.map +1 -0
  425. package/dist/types/type.list.d.ts +13 -0
  426. package/dist/types/type.list.d.ts.map +1 -0
  427. package/dist/types/type.list.js +42 -0
  428. package/dist/types/type.list.js.map +1 -0
  429. package/dist/types/type.mdv.d.ts +10 -0
  430. package/dist/types/type.mdv.d.ts.map +1 -0
  431. package/dist/types/type.mdv.js +22 -0
  432. package/dist/types/type.mdv.js.map +1 -0
  433. package/dist/types/type.mdx.d.ts +10 -0
  434. package/dist/types/type.mdx.d.ts.map +1 -0
  435. package/dist/types/type.mdx.js +30 -0
  436. package/dist/types/type.mdx.js.map +1 -0
  437. package/dist/types/type.modal.d.ts +18 -0
  438. package/dist/types/type.modal.d.ts.map +1 -0
  439. package/dist/types/type.modal.js +30 -0
  440. package/dist/types/type.modal.js.map +1 -0
  441. package/dist/types/type.otp.d.ts +8 -0
  442. package/dist/types/type.otp.d.ts.map +1 -0
  443. package/dist/types/type.otp.js +48 -0
  444. package/dist/types/type.otp.js.map +1 -0
  445. package/dist/types/type.search.d.ts +16 -0
  446. package/dist/types/type.search.d.ts.map +1 -0
  447. package/dist/types/type.search.js +48 -0
  448. package/dist/types/type.search.js.map +1 -0
  449. package/dist/types/type.select.d.ts +14 -0
  450. package/dist/types/type.select.d.ts.map +1 -0
  451. package/dist/types/type.select.js +53 -0
  452. package/dist/types/type.select.js.map +1 -0
  453. package/dist/types/type.switch.d.ts +8 -0
  454. package/dist/types/type.switch.d.ts.map +1 -0
  455. package/dist/types/type.switch.js +26 -0
  456. package/dist/types/type.switch.js.map +1 -0
  457. package/dist/types/type.table.d.ts +28 -0
  458. package/dist/types/type.table.d.ts.map +1 -0
  459. package/dist/types/type.table.js +72 -0
  460. package/dist/types/type.table.js.map +1 -0
  461. package/dist/types/type.text-area.d.ts +9 -0
  462. package/dist/types/type.text-area.d.ts.map +1 -0
  463. package/dist/types/type.text-area.js +26 -0
  464. package/dist/types/type.text-area.js.map +1 -0
  465. package/dist/types/type.time.d.ts +9 -0
  466. package/dist/types/type.time.d.ts.map +1 -0
  467. package/dist/types/type.time.js +34 -0
  468. package/dist/types/type.time.js.map +1 -0
  469. package/dist/types/type.upload.d.ts +45 -0
  470. package/dist/types/type.upload.d.ts.map +1 -0
  471. package/dist/types/type.upload.js +90 -0
  472. package/dist/types/type.upload.js.map +1 -0
  473. package/dist/types/type.video.d.ts +19 -0
  474. package/dist/types/type.video.d.ts.map +1 -0
  475. package/dist/types/type.video.js +33 -0
  476. package/dist/types/type.video.js.map +1 -0
  477. package/dist/types/upload-service.d.ts +47 -0
  478. package/dist/types/upload-service.d.ts.map +1 -0
  479. package/dist/types/upload-service.js +191 -0
  480. package/dist/types/upload-service.js.map +1 -0
  481. package/dist/utils/app-config.d.ts +6 -0
  482. package/dist/utils/app-config.d.ts.map +1 -0
  483. package/dist/utils/app-config.js +17 -0
  484. package/dist/utils/app-config.js.map +1 -0
  485. package/dist/utils/app-http.d.ts +77 -0
  486. package/dist/utils/app-http.d.ts.map +1 -0
  487. package/dist/utils/app-http.js +331 -0
  488. package/dist/utils/app-http.js.map +1 -0
  489. package/dist/utils/app-storage.d.ts +56 -0
  490. package/dist/utils/app-storage.d.ts.map +1 -0
  491. package/dist/utils/app-storage.js +236 -0
  492. package/dist/utils/app-storage.js.map +1 -0
  493. package/dist/utils/content-util.d.ts +6 -0
  494. package/dist/utils/content-util.d.ts.map +1 -0
  495. package/dist/utils/content-util.js +45 -0
  496. package/dist/utils/content-util.js.map +1 -0
  497. package/dist/utils/crypto-util.d.ts +15 -0
  498. package/dist/utils/crypto-util.d.ts.map +1 -0
  499. package/dist/utils/crypto-util.js +76 -0
  500. package/dist/utils/crypto-util.js.map +1 -0
  501. package/dist/utils/error-util.d.ts +3 -0
  502. package/dist/utils/error-util.d.ts.map +1 -0
  503. package/dist/utils/error-util.js +58 -0
  504. package/dist/utils/error-util.js.map +1 -0
  505. package/dist/utils/event-util.d.ts +16 -0
  506. package/dist/utils/event-util.d.ts.map +1 -0
  507. package/dist/utils/event-util.js +51 -0
  508. package/dist/utils/event-util.js.map +1 -0
  509. package/dist/utils/file-util.d.ts +30 -0
  510. package/dist/utils/file-util.d.ts.map +1 -0
  511. package/dist/utils/file-util.js +165 -0
  512. package/dist/utils/file-util.js.map +1 -0
  513. package/dist/utils/lang-util.d.ts +12 -0
  514. package/dist/utils/lang-util.d.ts.map +1 -0
  515. package/dist/utils/lang-util.js +53 -0
  516. package/dist/utils/lang-util.js.map +1 -0
  517. package/dist/utils/language-util.d.ts +21 -0
  518. package/dist/utils/language-util.d.ts.map +1 -0
  519. package/dist/utils/language-util.js +96 -0
  520. package/dist/utils/language-util.js.map +1 -0
  521. package/dist/utils/leave-guard.d.ts +5 -0
  522. package/dist/utils/leave-guard.d.ts.map +1 -0
  523. package/dist/utils/leave-guard.js +24 -0
  524. package/dist/utils/leave-guard.js.map +1 -0
  525. package/dist/utils/lucide-icon.d.ts +10 -0
  526. package/dist/utils/lucide-icon.d.ts.map +1 -0
  527. package/dist/utils/lucide-icon.js +48 -0
  528. package/dist/utils/lucide-icon.js.map +1 -0
  529. package/dist/utils/menu-util.d.ts +33 -0
  530. package/dist/utils/menu-util.d.ts.map +1 -0
  531. package/dist/utils/menu-util.js +151 -0
  532. package/dist/utils/menu-util.js.map +1 -0
  533. package/dist/utils/option-util.d.ts +21 -0
  534. package/dist/utils/option-util.d.ts.map +1 -0
  535. package/dist/utils/option-util.js +101 -0
  536. package/dist/utils/option-util.js.map +1 -0
  537. package/dist/utils/session-id.d.ts +5 -0
  538. package/dist/utils/session-id.d.ts.map +1 -0
  539. package/dist/utils/session-id.js +44 -0
  540. package/dist/utils/session-id.js.map +1 -0
  541. package/dist/utils/shared-regexp.d.ts +31 -0
  542. package/dist/utils/shared-regexp.d.ts.map +1 -0
  543. package/dist/utils/shared-regexp.js +17 -0
  544. package/dist/utils/shared-regexp.js.map +1 -0
  545. package/dist/utils/signal-source.d.ts +4 -0
  546. package/dist/utils/signal-source.d.ts.map +1 -0
  547. package/dist/utils/signal-source.js +13 -0
  548. package/dist/utils/signal-source.js.map +1 -0
  549. package/dist/utils/storage-keys.d.ts +73 -0
  550. package/dist/utils/storage-keys.d.ts.map +1 -0
  551. package/dist/utils/storage-keys.js +80 -0
  552. package/dist/utils/storage-keys.js.map +1 -0
  553. package/package.json +101 -4
  554. package/src/components/app-brand.tsx +41 -0
  555. package/src/components/branch-switcher.tsx +74 -0
  556. package/src/components/coming-soon.tsx +36 -0
  557. package/src/components/empty-state.tsx +42 -0
  558. package/src/components/language-switcher.tsx +96 -0
  559. package/src/components/page-loader.tsx +11 -0
  560. package/src/components/page-not-found.tsx +42 -0
  561. package/src/components/permission-denied.tsx +21 -0
  562. package/src/components/require-access.tsx +30 -0
  563. package/src/components/scroll-to-top.tsx +62 -0
  564. package/src/components/settings-menu.tsx +250 -0
  565. package/src/components/theme-switcher.tsx +72 -0
  566. package/src/components/toast-container.tsx +73 -0
  567. package/src/components/top-progress.tsx +14 -0
  568. package/src/components/user-menu.tsx +179 -0
  569. package/src/context/ui-context.ts +20 -0
  570. package/src/context/use-ui.ts +43 -0
  571. package/src/i18n/browser-language.ts +98 -0
  572. package/src/i18n/default-messages.ts +70 -0
  573. package/src/i18n/direction.ts +43 -0
  574. package/src/i18n/locale-groups.ts +87 -0
  575. package/src/i18n/locale-service.ts +259 -0
  576. package/src/i18n/locale-signal.ts +173 -0
  577. package/src/i18n/translator.ts +114 -0
  578. package/src/index.ts +409 -0
  579. package/src/interfaces/app-types.ts +160 -0
  580. package/src/interfaces/toast.ts +12 -0
  581. package/src/interfaces/ui-config.ts +342 -0
  582. package/src/interfaces/ui-context.ts +43 -0
  583. package/src/layout.ts +29 -0
  584. package/src/layouts/app-layout.tsx +103 -0
  585. package/src/layouts/article-layout.tsx +16 -0
  586. package/src/layouts/aside-layout.tsx +118 -0
  587. package/src/layouts/auth-layout.tsx +41 -0
  588. package/src/layouts/content-layout.tsx +11 -0
  589. package/src/layouts/float-layout.tsx +11 -0
  590. package/src/layouts/grid-layout.tsx +11 -0
  591. package/src/layouts/head-layout.tsx +61 -0
  592. package/src/layouts/header.tsx +74 -0
  593. package/src/layouts/layout-constants.ts +5 -0
  594. package/src/layouts/mega-menu.tsx +203 -0
  595. package/src/layouts/navigation.ts +45 -0
  596. package/src/layouts/rail-flyout.tsx +77 -0
  597. package/src/layouts/rail-tooltip.tsx +77 -0
  598. package/src/layouts/sidebar.tsx +296 -0
  599. package/src/markdown.ts +12 -0
  600. package/src/providers/provider-effects.ts +33 -0
  601. package/src/providers/register-config.ts +32 -0
  602. package/src/providers/shared-web-ui-provider.tsx +81 -0
  603. package/src/providers/theme-provider.tsx +15 -0
  604. package/src/providers/translation-provider.tsx +28 -0
  605. package/src/query/page-link.tsx +84 -0
  606. package/src/query/page-path.ts +26 -0
  607. package/src/query/query-param.ts +267 -0
  608. package/src/query/use-query-param.ts +23 -0
  609. package/src/skeleton/skeleton-article.tsx +11 -0
  610. package/src/skeleton/skeleton-auth-form.tsx +20 -0
  611. package/src/skeleton/skeleton-cards.tsx +35 -0
  612. package/src/skeleton/skeleton-chat.tsx +34 -0
  613. package/src/skeleton/skeleton-dashboard.tsx +34 -0
  614. package/src/skeleton/skeleton-float.tsx +10 -0
  615. package/src/skeleton/skeleton-form.tsx +45 -0
  616. package/src/skeleton/skeleton-menu.tsx +30 -0
  617. package/src/skeleton/skeleton-page.tsx +18 -0
  618. package/src/skeleton/skeleton-table.tsx +25 -0
  619. package/src/state/api-loader.ts +205 -0
  620. package/src/state/auth-service.ts +159 -0
  621. package/src/state/branch-service.ts +217 -0
  622. package/src/state/company-service.ts +107 -0
  623. package/src/state/document-sync.ts +43 -0
  624. package/src/state/language-service.ts +85 -0
  625. package/src/state/layout-choice-service.ts +40 -0
  626. package/src/state/menu-service.ts +67 -0
  627. package/src/state/navigation-service.ts +160 -0
  628. package/src/state/preference-sync.ts +101 -0
  629. package/src/state/progress-service.ts +18 -0
  630. package/src/state/screen-access.ts +70 -0
  631. package/src/state/sidebar-service.ts +22 -0
  632. package/src/state/signals.ts +215 -0
  633. package/src/state/toast-service.ts +45 -0
  634. package/src/styles.css +15 -0
  635. package/src/theme/custom-themes.ts +236 -0
  636. package/src/theme/dark-themes.ts +97 -0
  637. package/src/theme/logo.ts +27 -0
  638. package/src/theme/org-themes.json +70 -0
  639. package/src/theme/theme-service.ts +142 -0
  640. package/src/types/class-names.ts +53 -0
  641. package/src/types/field-error.ts +19 -0
  642. package/src/types/field-props.ts +23 -0
  643. package/src/types/field-registry.ts +27 -0
  644. package/src/types/field-wrapper.tsx +42 -0
  645. package/src/types/lang-field.ts +71 -0
  646. package/src/types/markdown-color-mode.ts +13 -0
  647. package/src/types/media-service.ts +61 -0
  648. package/src/types/media-viewer.tsx +57 -0
  649. package/src/types/type.button.tsx +108 -0
  650. package/src/types/type.checkbox.tsx +49 -0
  651. package/src/types/type.confirm.tsx +50 -0
  652. package/src/types/type.date.tsx +97 -0
  653. package/src/types/type.drawer.tsx +86 -0
  654. package/src/types/type.dropdown.tsx +81 -0
  655. package/src/types/type.filter.tsx +64 -0
  656. package/src/types/type.icon.ts +53 -0
  657. package/src/types/type.image.tsx +115 -0
  658. package/src/types/type.input.tsx +57 -0
  659. package/src/types/type.lang-md.tsx +129 -0
  660. package/src/types/type.lang.tsx +156 -0
  661. package/src/types/type.list.tsx +97 -0
  662. package/src/types/type.mdv.tsx +35 -0
  663. package/src/types/type.mdx.tsx +54 -0
  664. package/src/types/type.modal.tsx +77 -0
  665. package/src/types/type.otp.tsx +82 -0
  666. package/src/types/type.search.tsx +87 -0
  667. package/src/types/type.select.tsx +87 -0
  668. package/src/types/type.switch.tsx +52 -0
  669. package/src/types/type.table.tsx +152 -0
  670. package/src/types/type.text-area.tsx +51 -0
  671. package/src/types/type.time.tsx +61 -0
  672. package/src/types/type.upload.tsx +294 -0
  673. package/src/types/type.video.tsx +119 -0
  674. package/src/types/upload-service.ts +229 -0
  675. package/src/utils/app-config.ts +21 -0
  676. package/src/utils/app-http.ts +369 -0
  677. package/src/utils/app-storage.ts +259 -0
  678. package/src/utils/content-util.ts +49 -0
  679. package/src/utils/crypto-util.ts +88 -0
  680. package/src/utils/error-util.ts +64 -0
  681. package/src/utils/event-util.ts +58 -0
  682. package/src/utils/file-util.ts +186 -0
  683. package/src/utils/lang-util.ts +60 -0
  684. package/src/utils/language-util.ts +107 -0
  685. package/src/utils/leave-guard.ts +26 -0
  686. package/src/utils/lucide-icon.ts +55 -0
  687. package/src/utils/menu-util.ts +165 -0
  688. package/src/utils/option-util.ts +108 -0
  689. package/src/utils/session-id.ts +48 -0
  690. package/src/utils/shared-regexp.ts +18 -0
  691. package/src/utils/signal-source.ts +15 -0
  692. package/src/utils/storage-keys.ts +86 -0
@@ -0,0 +1,369 @@
1
+ // app-http.ts
2
+ // The one HTTP client of an app. Wraps dff-util Http with the token, session id, branch, extra headers
3
+ // and the top progress bar. Reads the http* settings from the saved config (no signals).
4
+ //
5
+ // // config.ts
6
+ // http: { baseUrl: "https://api.example.com/api", logoutUrl: "/login", loadUrl: "https://api.example.com/api/app-sor/load" }
7
+ //
8
+ // Every request sends: Content-Type, Authorization: Bearer <TOKEN>, x-session-id (per tab, AppStorage ACTIVE_SESSION_ID),
9
+ // x-branch-id (AppStorage BRANCH_ID, set with setBranch(id); "" when no branch), http.headers, setHeader() values.
10
+ //
11
+ // Base URL: window.env.REACT_APP_<APPNAMEKEY>_API_BASE_URL (AppStorage.envData("API_BASE_URL")) wins over
12
+ // config.http.baseUrl, so one build can run against several backends.
13
+ //
14
+ // Service URLs (MsUrl) are NOT part of AppHttp: each project keeps them in its own config.ts.
15
+ //
16
+ // Every method takes a full URL or a path: a URL that starts with http:// or https:// is used as it is,
17
+ // anything else is appended to the base URL ("/profile/search" -> "<baseUrl>/profile/search").
18
+ //
19
+ // // hooks/service-http.ts
20
+ // const listUrl = `${MsUrl.main}/profile/search`;
21
+ // const response = await AppHttp.Get(listUrl, params);
22
+ // const saved = await AppHttp.Post(saveUrl, body);
23
+ // AppHttp.setHeader("x-custom", value);
24
+ //
25
+ // // file upload to a signed URL
26
+ // const signed = await AppHttp.Post(`${MsUrl.utils}/s3/upload-url`, { fileName: file.name });
27
+ // const uploaded = await uploadToSignedUrl(file, signed.data.upload, signed.data.download);
28
+ // // uploaded = { filename, mimetype, url }
29
+
30
+ import { Http, type FileType } from "dff-util";
31
+ import type { UiConfig } from "../interfaces/ui-config.ts";
32
+ import { ShowProgress } from "../state/progress-service.ts";
33
+ import { readAppConfig } from "./app-config.ts";
34
+ import { AppStorage } from "./app-storage.ts";
35
+ import { setLeaveGuard } from "./leave-guard.ts";
36
+ import { readSessionId } from "./session-id.ts";
37
+ import { BRANCH_ID, TOKEN } from "./storage-keys.ts";
38
+
39
+ export type HttpParams = Record<string, string | number | boolean | null | undefined>;
40
+ export type HttpHeaders = Record<string, string>;
41
+
42
+ const CONFIG_MISSING = "shared-lib-web: config is missing. Render <SharedWebUiProvider config={config}> or call setAppConfig(config) first.";
43
+ const BASE_URL_MISSING = "shared-lib-web: no API base URL. Set config.http.baseUrl or window.env.REACT_APP_<APPNAMEKEY>_API_BASE_URL.";
44
+
45
+ /** window.env name (without prefix) of the API base URL. */
46
+ export const API_BASE_URL_ENV = "API_BASE_URL";
47
+
48
+
49
+ const runtimeHeaders: HttpHeaders = {};
50
+
51
+ /** Returns the saved config or throws a clear error. */
52
+ function readSavedConfig(): UiConfig {
53
+ const config = readAppConfig();
54
+ if (!config) {
55
+ throw new Error(CONFIG_MISSING);
56
+ }
57
+ return config;
58
+ }
59
+
60
+ /** true when the progress bar should show. */
61
+ function isProgressEnabled(): boolean {
62
+ const config = readAppConfig();
63
+ return config?.http?.showProgress ?? true;
64
+ }
65
+
66
+ /** JWT from AppStorage (config.http.tokenKey, default TOKEN, sessionStorage). "" when missing. */
67
+ /**
68
+ * Requests shared by every copy of the library on the page (a shell and its microfrontends each bundle their own
69
+ * copy): the key is global (Symbol.for), so the cache lives on window once for all copies.
70
+ */
71
+ const SHARED_GET_KEY = Symbol.for("shared-lib-web:shared-get");
72
+
73
+ type SharedGetCache = Map<string, Promise<unknown>>;
74
+
75
+ /** The page-wide cache of GetShared (created by the first copy that needs it). */
76
+ function readSharedGetCache(): SharedGetCache {
77
+ const holder = globalThis as unknown as Record<symbol, SharedGetCache | undefined>;
78
+ let cache = holder[SHARED_GET_KEY];
79
+ if (!cache) {
80
+ cache = new Map();
81
+ holder[SHARED_GET_KEY] = cache;
82
+ }
83
+ return cache;
84
+ }
85
+
86
+ /** Cache key of a request: the full URL + the params sorted by name. */
87
+ export function buildSharedGetKey(fullUrl: string, params: HttpParams): string {
88
+ const names = Object.keys(params);
89
+ names.sort();
90
+ const parts: string[] = [];
91
+ for (const name of names) {
92
+ const value = params[name];
93
+ parts.push(`${name}=${String(value)}`);
94
+ }
95
+ const paramText = parts.join("&");
96
+ return `${fullUrl}?${paramText}`;
97
+ }
98
+
99
+ /** A failed shared request is removed, so the next call tries again. */
100
+ function forgetSharedGet(key: string): void {
101
+ const cache = readSharedGetCache();
102
+ cache.delete(key);
103
+ }
104
+
105
+ /** Empties the shared request cache (for example after the texts or themes changed on the server, or in tests). */
106
+ export function clearSharedGetCache(): void {
107
+ const cache = readSharedGetCache();
108
+ cache.clear();
109
+ }
110
+
111
+ export function readJwtToken(): string {
112
+ const config = readAppConfig();
113
+ const tokenKey = config?.http?.tokenKey ?? TOKEN;
114
+ const storedToken = AppStorage.getText(tokenKey);
115
+ const plainToken = storedToken.replace(/^Bearer\s+/i, "");
116
+ const token = plainToken.trim();
117
+ const isMissing = token.length === 0 || token === "null" || token === "undefined";
118
+ return isMissing ? "" : token;
119
+ }
120
+
121
+ /** "/api" -> "https://this-site/api". Absolute URLs stay as they are. A trailing "/" is removed. */
122
+ export function toAbsoluteUrl(url: string): string {
123
+ const hasWindow = typeof window !== "undefined";
124
+ const isAbsolute = /^https?:\/\//i.test(url);
125
+ const fullUrl = isAbsolute || !hasWindow ? url : `${window.location.origin}${url}`;
126
+ return fullUrl.replace(/\/+$/, "");
127
+ }
128
+
129
+ /** true for "http://..." and "https://..." (any case). */
130
+ export function isHttpUrl(url: string): boolean {
131
+ return /^https?:\/\//i.test(url);
132
+ }
133
+
134
+ /** Joins a base URL and a path with exactly one "/" between them. */
135
+ export function joinUrl(baseUrl: string, path: string): string {
136
+ const trimmedBase = baseUrl.replace(/\/+$/, "");
137
+ const trimmedPath = path.replace(/^\/+/, "");
138
+ return trimmedPath.length > 0 ? `${trimmedBase}/${trimmedPath}` : trimmedBase;
139
+ }
140
+
141
+ /** Turns a Response body into JSON or text. */
142
+ async function readResponseBody(response: Response): Promise<unknown> {
143
+ const contentType = response.headers.get("content-type") ?? "";
144
+ if (contentType.includes("application/json")) {
145
+ return response.json();
146
+ }
147
+ return response.text();
148
+ }
149
+
150
+ export class AppHttp {
151
+ /**
152
+ * API base URL: window.env REACT_APP_<APPNAMEKEY>_API_BASE_URL first, then config.http.baseUrl.
153
+ * A relative base ("/api") becomes absolute ("https://this-site/api"). Also set as dff-util Http.API_BASE_URL,
154
+ * so AppHttp.Get("/profile/search") works with a path only.
155
+ */
156
+ static BaseUrl(): string {
157
+ const envBaseUrl = AppStorage.envData(API_BASE_URL_ENV);
158
+ const savedConfig = readSavedConfig();
159
+ const baseUrl = envBaseUrl ?? savedConfig.http?.baseUrl;
160
+ if (!baseUrl) {
161
+ throw new Error(BASE_URL_MISSING);
162
+ }
163
+ const absoluteBaseUrl = toAbsoluteUrl(baseUrl);
164
+ Http.API_BASE_URL = absoluteBaseUrl;
165
+ return absoluteBaseUrl;
166
+ }
167
+
168
+ /**
169
+ * The URL a request goes to: a URL starting with http:// or https:// stays as it is,
170
+ * anything else is appended to BaseUrl() ("/profile/search" or "profile/search" -> "<baseUrl>/profile/search").
171
+ */
172
+ static FullUrl(url: string): string {
173
+ const isAbsolute = isHttpUrl(url);
174
+ if (isAbsolute) {
175
+ return url;
176
+ }
177
+ const baseUrl = AppHttp.BaseUrl();
178
+ return joinUrl(baseUrl, url);
179
+ }
180
+
181
+ /** Adds (or with "" removes) a header sent with every request, for example the selected branch. */
182
+ static setHeader(headerName: string, value: string): void {
183
+ if (value.length === 0) {
184
+ delete runtimeHeaders[headerName];
185
+ return;
186
+ }
187
+ runtimeHeaders[headerName] = value;
188
+ }
189
+
190
+ /** JSON headers: content type, bearer token, session id, branch, config and runtime headers. */
191
+ static Headers(): HttpHeaders {
192
+ const rawHeaders = AppHttp.RawHeaders();
193
+ return { "Content-Type": "application/json", ...rawHeaders };
194
+ }
195
+
196
+ /** Headers without Content-Type (for FormData uploads, the browser sets the boundary). */
197
+ static RawHeaders(): HttpHeaders {
198
+ const savedConfig = readSavedConfig();
199
+ const configHeaders = savedConfig.http?.headers ?? {};
200
+ const headers: HttpHeaders = { ...configHeaders, ...runtimeHeaders };
201
+ const token = readJwtToken();
202
+ if (token.length > 0) {
203
+ headers.Authorization = `Bearer ${token}`;
204
+ }
205
+ headers["x-session-id"] = readSessionId();
206
+ headers["x-branch-id"] = AppStorage.getText(BRANCH_ID);
207
+ return headers;
208
+ }
209
+
210
+ /** GET with query params. */
211
+ static async Get(url: string, params: HttpParams = {}, customHeaders: HttpHeaders = {}): Promise<unknown> {
212
+ const baseHeaders = AppHttp.Headers();
213
+ const headers = { ...baseHeaders, ...customHeaders };
214
+ const fullUrl = AppHttp.FullUrl(url);
215
+ const request = Http.Get(fullUrl, params, headers);
216
+ return AppHttp.withProgress(request);
217
+ }
218
+
219
+ /**
220
+ * GET once per page, shared by every copy of the library (shell + microfrontends): the same URL + params while a
221
+ * request is running or after it answered gives the same promise — no second call. For data that is the same for
222
+ * everyone on the page (languages, themes, texts, company details), not for user data. A failed request is not kept.
223
+ * const reply = await AppHttp.GetShared(`${MsUrl.sor}/load/LANG`, { active: true });
224
+ */
225
+ static GetShared(url: string, params: HttpParams = {}): Promise<unknown> {
226
+ const fullUrl = AppHttp.FullUrl(url);
227
+ const key = buildSharedGetKey(fullUrl, params);
228
+ const cache = readSharedGetCache();
229
+ const cached = cache.get(key);
230
+ if (cached) {
231
+ return cached;
232
+ }
233
+ const request = AppHttp.Get(url, params);
234
+ cache.set(key, request);
235
+ const forget = forgetSharedGet.bind(null, key);
236
+ request.catch(forget);
237
+ return request;
238
+ }
239
+
240
+ /** POST a JSON body. */
241
+ static async Post(url: string, body: unknown, customHeaders: HttpHeaders = {}): Promise<unknown> {
242
+ const baseHeaders = AppHttp.Headers();
243
+ const headers = { ...baseHeaders, ...customHeaders };
244
+ const fullUrl = AppHttp.FullUrl(url);
245
+ const request = Http.Post(fullUrl, body, headers);
246
+ return AppHttp.withProgress(request);
247
+ }
248
+
249
+ /** PUT a JSON body to url/id. */
250
+ static async Put(url: string, id: string, body: unknown): Promise<unknown> {
251
+ const headers = AppHttp.Headers();
252
+ const fullUrl = AppHttp.FullUrl(url);
253
+ const itemUrl = `${fullUrl}/${id}`;
254
+ const request = Http.Put(itemUrl, body, headers);
255
+ return AppHttp.withProgress(request);
256
+ }
257
+
258
+ /** DELETE url/id. */
259
+ static async Delete(url: string, id: string, params: HttpParams = {}): Promise<unknown> {
260
+ const headers = AppHttp.Headers();
261
+ const fullUrl = AppHttp.FullUrl(url);
262
+ const itemUrl = `${fullUrl}/${id}`;
263
+ const request = Http.Delete(itemUrl, params, headers);
264
+ return AppHttp.withProgress(request);
265
+ }
266
+
267
+ /** PATCH a JSON body. */
268
+ static async Patch(url: string, body: unknown): Promise<unknown> {
269
+ const headers = AppHttp.Headers();
270
+ const bodyText = JSON.stringify(body ?? {});
271
+ const requestInit = { method: "PATCH", headers: headers, body: bodyText };
272
+ const fullUrl = AppHttp.FullUrl(url);
273
+ const request = fetch(fullUrl, requestInit);
274
+ const response = await AppHttp.withProgress(request);
275
+ if (!response.ok) {
276
+ const errorText = await response.text();
277
+ throw new Error(errorText || `PATCH ${response.status}`);
278
+ }
279
+ return readResponseBody(response);
280
+ }
281
+
282
+ /** Option lists from the backend loader: GET `${config.http.loadUrl}/${id}`. */
283
+ static async Load(id: string, params: HttpParams = {}): Promise<unknown> {
284
+ const savedConfig = readSavedConfig();
285
+ const loadUrl = savedConfig.http?.loadUrl ?? "/load";
286
+ const fullLoadUrl = AppHttp.FullUrl(loadUrl);
287
+ const itemUrl = `${fullLoadUrl}/${id}`;
288
+ return AppHttp.Get(itemUrl, params);
289
+ }
290
+
291
+ /** PUT a file to a signed upload URL (plain PUT, no extra headers, so bucket CORS accepts it). */
292
+ static async CloudUpload(uploadUrl: string, file: File): Promise<Response> {
293
+ const requestInit = { method: "PUT", body: file };
294
+ const fullUrl = AppHttp.FullUrl(uploadUrl);
295
+ const request = fetch(fullUrl, requestInit);
296
+ const response = await AppHttp.withProgress(request);
297
+ if (!response.ok) {
298
+ throw new Error(`Upload failed: ${response.status}`);
299
+ }
300
+ return response;
301
+ }
302
+
303
+ /** Same as CloudUpload (the name the apps used). */
304
+ static async uploadFile(uploadUrl: string, file: File): Promise<Response> {
305
+ return AppHttp.CloudUpload(uploadUrl, file);
306
+ }
307
+
308
+ /**
309
+ * GET that returns the raw body as a Blob (images, video, audio, any binary file).
310
+ * The URL rule of every method applies (a path gets the base URL), and the same headers are sent (token,
311
+ * x-session-id, x-branch-id, http.headers, setHeader values; no Content-Type). No progress bar: pages often load
312
+ * many media files at once.
313
+ * const blob = await AppHttp.Media(`${MsUrl.utils}/files/${id}`);
314
+ * const objectUrl = URL.createObjectURL(blob); // <img src={objectUrl}>; URL.revokeObjectURL(objectUrl) later
315
+ */
316
+ static async Media(url: string, params?: HttpParams): Promise<Blob> {
317
+ const fullUrl = AppHttp.FullUrl(url);
318
+ const headers = AppHttp.RawHeaders();
319
+ return Http.FileDownload(fullUrl, params, headers);
320
+ }
321
+
322
+ /** Downloads a file and saves it in the browser. */
323
+ static async DownloadFile(url: string, params: HttpParams = {}, fileName?: string): Promise<void> {
324
+ const headers = AppHttp.RawHeaders();
325
+ const fullUrl = AppHttp.FullUrl(url);
326
+ const request = Http.FileDownload(fullUrl, params, headers);
327
+ const blob = await AppHttp.withProgress(request);
328
+ const downloadUrl = window.URL.createObjectURL(blob);
329
+ const link = document.createElement("a");
330
+ const urlParts = url.split("/");
331
+ const lastPart = urlParts[urlParts.length - 1];
332
+ link.href = downloadUrl;
333
+ link.download = fileName ?? lastPart ?? "download";
334
+ document.body.appendChild(link);
335
+ link.click();
336
+ link.remove();
337
+ window.URL.revokeObjectURL(downloadUrl);
338
+ }
339
+
340
+ /** Shows the progress bar while the request runs. */
341
+ static async withProgress<TResult>(request: Promise<TResult>): Promise<TResult> {
342
+ const showProgress = isProgressEnabled();
343
+ if (showProgress) {
344
+ ShowProgress(true);
345
+ }
346
+ try {
347
+ const result = await request;
348
+ return result;
349
+ } finally {
350
+ if (showProgress) {
351
+ ShowProgress(false);
352
+ }
353
+ }
354
+ }
355
+ }
356
+
357
+ /**
358
+ * PUTs the file to a signed (pre-signed S3 / GCS) uploadUrl and returns a dff-util FileType with its download URL.
359
+ * The browser warns before closing the page while the upload runs.
360
+ */
361
+ export async function uploadToSignedUrl(file: File, uploadUrl: string, downloadUrl: string): Promise<FileType> {
362
+ setLeaveGuard(true);
363
+ try {
364
+ await AppHttp.CloudUpload(uploadUrl, file);
365
+ } finally {
366
+ setLeaveGuard(false);
367
+ }
368
+ return { filename: file.name, mimetype: file.type, url: downloadUrl };
369
+ }
@@ -0,0 +1,259 @@
1
+ // app-storage.ts
2
+ // Prefixed browser storage for app data (token, session info, branch, preferences ...).
3
+ // The key names are the shared constants from storage-keys.ts (TOKEN, LANG, THEME, BRANCH_ID ...).
4
+ //
5
+ // AppStorage.setData(TOKEN, token); // sessionStorage "ORG-TOKEN"
6
+ // AppStorage.setData(THEME, "org-dark"); // localStorage "ORG-THEME" (a preference key)
7
+ // const token = AppStorage.getData(TOKEN);
8
+ // AppStorage.removeData(BRANCH_ID); // removed from both storages
9
+ // AppStorage.clearData(); // log out: keeps LANG, THEME, MENU_MODE ...
10
+ // const apiUrl = AppStorage.envData("API_BASE_URL"); // window.env.REACT_APP_ORG_API_BASE_URL
11
+ //
12
+ // Prefix: config.appNameKey ("ORG" -> "ORG-TOKEN"). Objects are saved as JSON.
13
+ // Where a value goes depends ONLY on the key:
14
+ // localStorage LANG, THEME, LAYOUT_CHOICE, MENU_MODE, SIDEBAR_COLLAPSED, REMEMBER_ME (+ config.localStorageKeys)
15
+ // sessionStorage everything else (TOKEN, AUTH_USER, SESSION_INFO, NAV, TRANS, DIR, BRANCH_ID ...)
16
+
17
+ import { ConstValue } from "dff-util";
18
+ import { readAppConfig } from "./app-config.ts";
19
+ import { DEFAULT_APP_STORAGE_PREFIX, ENV_NAME_START, LOCAL_STORAGE_KEYS, PREFERENCE_EVENT } from "./storage-keys.ts";
20
+
21
+ /** Any value that can be saved. */
22
+ export type StoredValue = string | number | boolean | null | object;
23
+
24
+ /** window with the runtime settings object (window.env, set by env.js in the deployed app). */
25
+ type WindowWithEnv = Window & { env?: Record<string, string | undefined> };
26
+
27
+ /** Prefix of every key: config.appNameKey ("ORG"), default "UI". */
28
+ export function readAppStoragePrefix(): string {
29
+ const config = readAppConfig();
30
+ return config?.appNameKey || DEFAULT_APP_STORAGE_PREFIX;
31
+ }
32
+
33
+ /** Start of the window.env names of this app: "REACT_APP_ORG_" (or "REACT_APP_" without appNameKey). */
34
+ export function readEnvPrefix(): string {
35
+ const config = readAppConfig();
36
+ const appNameKey = config?.appNameKey;
37
+ return buildEnvPrefix(appNameKey);
38
+ }
39
+
40
+ /** "ORG" -> "REACT_APP_ORG_" ("REACT_APP_" without a key). */
41
+ export function buildEnvPrefix(appNameKey: string | undefined): string {
42
+ if (!appNameKey) {
43
+ return ENV_NAME_START;
44
+ }
45
+ const upperAppNameKey = appNameKey.toUpperCase();
46
+ return `${ENV_NAME_START}${upperAppNameKey}${ConstValue.UNDERSCORE}`;
47
+ }
48
+
49
+ /** Returns localStorage or sessionStorage, or null when not available. */
50
+ function readStorage(isLocal: boolean): Storage | null {
51
+ try {
52
+ const hasWindow = typeof window !== "undefined";
53
+ if (!hasWindow) {
54
+ return null;
55
+ }
56
+ return isLocal ? window.localStorage : window.sessionStorage;
57
+ } catch {
58
+ return null;
59
+ }
60
+ }
61
+
62
+ /** Adds the app prefix to a key: "TOKEN" -> "AS-TOKEN". */
63
+ export function readPrefixedKey(key: string): string {
64
+ const prefix = readAppStoragePrefix();
65
+ return `${prefix}${ConstValue.HYPHEN}${key}`;
66
+ }
67
+
68
+ /** The keys kept in localStorage: the library preferences plus config.localStorageKeys. */
69
+ export function readLocalStorageKeys(): string[] {
70
+ const config = readAppConfig();
71
+ const projectKeys = config?.localStorageKeys ?? [];
72
+ return [...LOCAL_STORAGE_KEYS, ...projectKeys];
73
+ }
74
+
75
+ /** true when the key lives in localStorage (a preference); every other key is in sessionStorage. */
76
+ export function isLocalStorageKey(key: string): boolean {
77
+ const localKeys = readLocalStorageKeys();
78
+ return localKeys.includes(key);
79
+ }
80
+
81
+ /** Turns a value into text for storage. */
82
+ function toStoredText(value: StoredValue): string {
83
+ if (typeof value === "string") {
84
+ return value;
85
+ }
86
+ return JSON.stringify(value);
87
+ }
88
+
89
+ /** Turns stored text back into a value (JSON objects and arrays are parsed). */
90
+ function fromStoredText(text: string): StoredValue {
91
+ const firstCharacter = text.charAt(0);
92
+ const looksLikeJson = firstCharacter === "{" || firstCharacter === "[";
93
+ if (!looksLikeJson) {
94
+ return text;
95
+ }
96
+ try {
97
+ const parsedValue = JSON.parse(text) as StoredValue;
98
+ return parsedValue;
99
+ } catch {
100
+ return text;
101
+ }
102
+ }
103
+
104
+ /** Saves a value: localStorage for preference keys, sessionStorage for every other key. */
105
+ function setData(key: string, value: StoredValue): void {
106
+ const isLocalKey = isLocalStorageKey(key);
107
+ const storage = readStorage(isLocalKey);
108
+ if (!storage) {
109
+ return;
110
+ }
111
+ const prefixedKey = readPrefixedKey(key);
112
+ const storedText = toStoredText(value);
113
+ try {
114
+ storage.setItem(prefixedKey, storedText);
115
+ } catch {
116
+ // Storage is full or blocked: the value is not saved.
117
+ }
118
+ if (isLocalKey) {
119
+ notifyPreferenceSaved(key);
120
+ }
121
+ }
122
+
123
+ /** Tells every library copy on the page (microfrontends) that a preference was saved. */
124
+ function notifyPreferenceSaved(key: string): void {
125
+ const eventInit = { detail: { key: key } };
126
+ const preferenceEvent = new CustomEvent(PREFERENCE_EVENT, eventInit);
127
+ window.dispatchEvent(preferenceEvent);
128
+ }
129
+
130
+ /** Reads a value from the storage of its key. Returns null when nothing is saved. */
131
+ function getData(key: string): StoredValue {
132
+ const isLocalKey = isLocalStorageKey(key);
133
+ const storage = readStorage(isLocalKey);
134
+ if (!storage) {
135
+ return null;
136
+ }
137
+ const prefixedKey = readPrefixedKey(key);
138
+ const storedText = storage.getItem(prefixedKey);
139
+ if (storedText === null) {
140
+ return null;
141
+ }
142
+ return fromStoredText(storedText);
143
+ }
144
+
145
+ /** Reads a value as text ("" when nothing is saved). */
146
+ function getText(key: string): string {
147
+ const storedValue = getData(key);
148
+ if (storedValue === null) {
149
+ return ConstValue.EMPTY;
150
+ }
151
+ return toStoredText(storedValue);
152
+ }
153
+
154
+ /** Removes a value from both storages. */
155
+ function removeData(key: string): void {
156
+ const prefixedKey = readPrefixedKey(key);
157
+ const storages = [readStorage(true), readStorage(false)];
158
+ for (const storage of storages) {
159
+ storage?.removeItem(prefixedKey);
160
+ }
161
+ }
162
+
163
+ /** Prefixed keys that clearData keeps: the preferences and keepKeys. */
164
+ function readKeptPrefixedKeys(keepKeys: string[]): string[] {
165
+ const localKeys = readLocalStorageKeys();
166
+ const allKeepKeys = [...localKeys, ...keepKeys];
167
+ const keptPrefixedKeys: string[] = [];
168
+ for (const keepKey of allKeepKeys) {
169
+ const prefixedKeepKey = readPrefixedKey(keepKey);
170
+ keptPrefixedKeys.push(prefixedKeepKey);
171
+ }
172
+ return keptPrefixedKeys;
173
+ }
174
+
175
+ /**
176
+ * Log out: removes every value with the app prefix from both storages.
177
+ * Keeps the preferences (LANG, THEME, LAYOUT_CHOICE, MENU_MODE, SIDEBAR_COLLAPSED, REMEMBER_ME and
178
+ * config.localStorageKeys) and the keys passed in keepKeys.
179
+ */
180
+ function clearData(keepKeys: string[] = []): void {
181
+ const storages = [readStorage(true), readStorage(false)];
182
+ const prefix = readAppStoragePrefix();
183
+ const prefixWithHyphen = `${prefix}${ConstValue.HYPHEN}`;
184
+ const keptPrefixedKeys = readKeptPrefixedKeys(keepKeys);
185
+ for (const storage of storages) {
186
+ if (!storage) {
187
+ continue;
188
+ }
189
+ const storageKeys = Object.keys(storage);
190
+ for (const storageKey of storageKeys) {
191
+ const isAppKey = storageKey.startsWith(prefixWithHyphen);
192
+ const isKept = keptPrefixedKeys.includes(storageKey);
193
+ if (isAppKey && !isKept) {
194
+ storage.removeItem(storageKey);
195
+ }
196
+ }
197
+ }
198
+ }
199
+
200
+ /**
201
+ * Removes app values from localStorage that do not belong there (for example a TOKEN or NAV saved by an older
202
+ * version), so localStorage only holds the preference keys. Called once when the provider gets its config.
203
+ */
204
+ function cleanLocalStorage(): void {
205
+ const storage = readStorage(true);
206
+ if (!storage) {
207
+ return;
208
+ }
209
+ const prefix = readAppStoragePrefix();
210
+ const prefixWithHyphen = `${prefix}${ConstValue.HYPHEN}`;
211
+ const keptPrefixedKeys = readKeptPrefixedKeys([]);
212
+ const storageKeys = Object.keys(storage);
213
+ for (const storageKey of storageKeys) {
214
+ const isAppKey = storageKey.startsWith(prefixWithHyphen);
215
+ const isKept = keptPrefixedKeys.includes(storageKey);
216
+ if (isAppKey && !isKept) {
217
+ storage.removeItem(storageKey);
218
+ }
219
+ }
220
+ }
221
+
222
+ /**
223
+ * Reads a runtime setting from window.env (set by env.js when the app is deployed).
224
+ * The name is REACT_APP_ + config.appNameKey + _ + KEY: envData("api_base_url") -> window.env.REACT_APP_ORG_API_BASE_URL.
225
+ * Returns null when it is not set.
226
+ */
227
+ function envData(key: string): string | null {
228
+ const config = readAppConfig();
229
+ const appNameKey = config?.appNameKey;
230
+ return readEnvData(appNameKey, key);
231
+ }
232
+
233
+ /**
234
+ * Reads window.env.REACT_APP_<APPNAMEKEY>_<KEY> without needing the saved config, so a project's config.ts can use it:
235
+ * const API_BASE_URL = readEnvData(APP_NAME_KEY, "API_BASE_URL") ?? "/api";
236
+ * Returns null when it is not set.
237
+ */
238
+ export function readEnvData(appNameKey: string | undefined, key: string): string | null {
239
+ const hasWindow = typeof window !== "undefined";
240
+ if (!hasWindow) {
241
+ return null;
242
+ }
243
+ const envPrefix = buildEnvPrefix(appNameKey);
244
+ const upperKey = key.toUpperCase();
245
+ const envName = `${envPrefix}${upperKey}`;
246
+ const windowWithEnv = window as WindowWithEnv;
247
+ const envValue = windowWithEnv.env?.[envName];
248
+ return envValue || null;
249
+ }
250
+
251
+ export const AppStorage = {
252
+ getData: getData,
253
+ getText: getText,
254
+ setData: setData,
255
+ removeData: removeData,
256
+ clearData: clearData,
257
+ cleanLocalStorage: cleanLocalStorage,
258
+ envData: envData,
259
+ };
@@ -0,0 +1,49 @@
1
+ // content-util.ts
2
+ // Reads the content out of a content-load reply, for example sor /content-load?query=locales.en-US:
3
+ //
4
+ // readContent(reply, "locales.en-US")
5
+ // { "data": { "locales": { "en-US": {...} } } } -> {...}
6
+ // { "data": {...} } -> {...}
7
+ // {...} -> {...}
8
+ //
9
+ // "data" is taken off first; then each part of the query ("locales", "en-US") is followed while the object has it.
10
+ // So the reply may be the content itself or wrapped in the query path — both give the same result.
11
+
12
+ /** Separator of the query parts: "locales.en-US" -> ["locales", "en-US"]. */
13
+ const QUERY_SEPARATOR = ".";
14
+
15
+ /** true for a plain object (not null, not a list). */
16
+ function isPlainObject(value: unknown): value is Record<string, unknown> {
17
+ const isObject = typeof value === "object" && value !== null;
18
+ return isObject && !Array.isArray(value);
19
+ }
20
+
21
+ /** The reply without its "data" wrapper (when it has one). */
22
+ function unwrapData(reply: unknown): unknown {
23
+ if (!isPlainObject(reply)) {
24
+ return reply;
25
+ }
26
+ const hasData = "data" in reply;
27
+ return hasData ? reply.data : reply;
28
+ }
29
+
30
+ /** Follows one query part when the value has it; otherwise the value stays. */
31
+ function followQueryPart(value: unknown, part: string): unknown {
32
+ if (isPlainObject(value) && part in value) {
33
+ return value[part];
34
+ }
35
+ return value;
36
+ }
37
+
38
+ /**
39
+ * The content of a content-load reply for a query ("theme", "locales", "locales.en-US"):
40
+ * takes off "data", then follows the query parts the reply has.
41
+ */
42
+ export function readContent(reply: unknown, query: string): unknown {
43
+ let content = unwrapData(reply);
44
+ const parts = query.split(QUERY_SEPARATOR);
45
+ for (const part of parts) {
46
+ content = followQueryPart(content, part);
47
+ }
48
+ return content;
49
+ }