shared-lib-web 0.0.0-stage → 0.0.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 (641) hide show
  1. package/CODING_RULES.md +118 -0
  2. package/LICENSE +21 -0
  3. package/README.md +630 -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 +23 -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 +19 -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 +8 -0
  21. package/dist/components/language-switcher.d.ts.map +1 -0
  22. package/dist/components/language-switcher.js +48 -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 +17 -0
  45. package/dist/components/settings-menu.d.ts.map +1 -0
  46. package/dist/components/settings-menu.js +102 -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 +39 -0
  71. package/dist/context/use-ui.js.map +1 -0
  72. package/dist/i18n/default-messages.d.ts +5 -0
  73. package/dist/i18n/default-messages.d.ts.map +1 -0
  74. package/dist/i18n/default-messages.js +64 -0
  75. package/dist/i18n/default-messages.js.map +1 -0
  76. package/dist/i18n/direction.d.ts +10 -0
  77. package/dist/i18n/direction.d.ts.map +1 -0
  78. package/dist/i18n/direction.js +35 -0
  79. package/dist/i18n/direction.js.map +1 -0
  80. package/dist/i18n/locale-service.d.ts +36 -0
  81. package/dist/i18n/locale-service.d.ts.map +1 -0
  82. package/dist/i18n/locale-service.js +163 -0
  83. package/dist/i18n/locale-service.js.map +1 -0
  84. package/dist/i18n/translator.d.ts +14 -0
  85. package/dist/i18n/translator.d.ts.map +1 -0
  86. package/dist/i18n/translator.js +81 -0
  87. package/dist/i18n/translator.js.map +1 -0
  88. package/dist/index.d.ts +106 -0
  89. package/dist/index.d.ts.map +1 -0
  90. package/dist/index.js +119 -0
  91. package/dist/index.js.map +1 -0
  92. package/dist/interfaces/app-types.d.ts +137 -0
  93. package/dist/interfaces/app-types.d.ts.map +1 -0
  94. package/dist/interfaces/app-types.js +5 -0
  95. package/dist/interfaces/app-types.js.map +1 -0
  96. package/dist/interfaces/toast.d.ts +9 -0
  97. package/dist/interfaces/toast.d.ts.map +1 -0
  98. package/dist/interfaces/toast.js +4 -0
  99. package/dist/interfaces/toast.js.map +1 -0
  100. package/dist/interfaces/ui-config.d.ts +172 -0
  101. package/dist/interfaces/ui-config.d.ts.map +1 -0
  102. package/dist/interfaces/ui-config.js +6 -0
  103. package/dist/interfaces/ui-config.js.map +1 -0
  104. package/dist/interfaces/ui-context.d.ts +37 -0
  105. package/dist/interfaces/ui-context.d.ts.map +1 -0
  106. package/dist/interfaces/ui-context.js +4 -0
  107. package/dist/interfaces/ui-context.js.map +1 -0
  108. package/dist/layout.d.ts +10 -0
  109. package/dist/layout.d.ts.map +1 -0
  110. package/dist/layout.js +22 -0
  111. package/dist/layout.js.map +1 -0
  112. package/dist/layouts/app-layout.d.ts +23 -0
  113. package/dist/layouts/app-layout.d.ts.map +1 -0
  114. package/dist/layouts/app-layout.js +52 -0
  115. package/dist/layouts/app-layout.js.map +1 -0
  116. package/dist/layouts/article-layout.d.ts +7 -0
  117. package/dist/layouts/article-layout.d.ts.map +1 -0
  118. package/dist/layouts/article-layout.js +8 -0
  119. package/dist/layouts/article-layout.js.map +1 -0
  120. package/dist/layouts/aside-layout.d.ts +27 -0
  121. package/dist/layouts/aside-layout.d.ts.map +1 -0
  122. package/dist/layouts/aside-layout.js +70 -0
  123. package/dist/layouts/aside-layout.js.map +1 -0
  124. package/dist/layouts/auth-layout.d.ts +7 -0
  125. package/dist/layouts/auth-layout.d.ts.map +1 -0
  126. package/dist/layouts/auth-layout.js +20 -0
  127. package/dist/layouts/auth-layout.js.map +1 -0
  128. package/dist/layouts/content-layout.d.ts +3 -0
  129. package/dist/layouts/content-layout.d.ts.map +1 -0
  130. package/dist/layouts/content-layout.js +10 -0
  131. package/dist/layouts/content-layout.js.map +1 -0
  132. package/dist/layouts/float-layout.d.ts +3 -0
  133. package/dist/layouts/float-layout.d.ts.map +1 -0
  134. package/dist/layouts/float-layout.js +10 -0
  135. package/dist/layouts/float-layout.js.map +1 -0
  136. package/dist/layouts/grid-layout.d.ts +3 -0
  137. package/dist/layouts/grid-layout.d.ts.map +1 -0
  138. package/dist/layouts/grid-layout.js +10 -0
  139. package/dist/layouts/grid-layout.js.map +1 -0
  140. package/dist/layouts/head-layout.d.ts +16 -0
  141. package/dist/layouts/head-layout.d.ts.map +1 -0
  142. package/dist/layouts/head-layout.js +36 -0
  143. package/dist/layouts/head-layout.js.map +1 -0
  144. package/dist/layouts/header.d.ts +18 -0
  145. package/dist/layouts/header.d.ts.map +1 -0
  146. package/dist/layouts/header.js +26 -0
  147. package/dist/layouts/header.js.map +1 -0
  148. package/dist/layouts/layout-constants.d.ts +3 -0
  149. package/dist/layouts/layout-constants.d.ts.map +1 -0
  150. package/dist/layouts/layout-constants.js +5 -0
  151. package/dist/layouts/layout-constants.js.map +1 -0
  152. package/dist/layouts/mega-menu.d.ts +3 -0
  153. package/dist/layouts/mega-menu.d.ts.map +1 -0
  154. package/dist/layouts/mega-menu.js +104 -0
  155. package/dist/layouts/mega-menu.js.map +1 -0
  156. package/dist/layouts/navigation.d.ts +11 -0
  157. package/dist/layouts/navigation.d.ts.map +1 -0
  158. package/dist/layouts/navigation.js +41 -0
  159. package/dist/layouts/navigation.js.map +1 -0
  160. package/dist/layouts/rail-flyout.d.ts +5 -0
  161. package/dist/layouts/rail-flyout.d.ts.map +1 -0
  162. package/dist/layouts/rail-flyout.js +49 -0
  163. package/dist/layouts/rail-flyout.js.map +1 -0
  164. package/dist/layouts/rail-tooltip.d.ts +8 -0
  165. package/dist/layouts/rail-tooltip.d.ts.map +1 -0
  166. package/dist/layouts/rail-tooltip.js +60 -0
  167. package/dist/layouts/rail-tooltip.js.map +1 -0
  168. package/dist/layouts/sidebar.d.ts +38 -0
  169. package/dist/layouts/sidebar.d.ts.map +1 -0
  170. package/dist/layouts/sidebar.js +137 -0
  171. package/dist/layouts/sidebar.js.map +1 -0
  172. package/dist/markdown.d.ts +4 -0
  173. package/dist/markdown.d.ts.map +1 -0
  174. package/dist/markdown.js +12 -0
  175. package/dist/markdown.js.map +1 -0
  176. package/dist/providers/provider-effects.d.ts +9 -0
  177. package/dist/providers/provider-effects.d.ts.map +1 -0
  178. package/dist/providers/provider-effects.js +26 -0
  179. package/dist/providers/provider-effects.js.map +1 -0
  180. package/dist/providers/register-config.d.ts +4 -0
  181. package/dist/providers/register-config.d.ts.map +1 -0
  182. package/dist/providers/register-config.js +28 -0
  183. package/dist/providers/register-config.js.map +1 -0
  184. package/dist/providers/shared-web-ui-provider.d.ts +31 -0
  185. package/dist/providers/shared-web-ui-provider.d.ts.map +1 -0
  186. package/dist/providers/shared-web-ui-provider.js +54 -0
  187. package/dist/providers/shared-web-ui-provider.js.map +1 -0
  188. package/dist/providers/theme-provider.d.ts +6 -0
  189. package/dist/providers/theme-provider.d.ts.map +1 -0
  190. package/dist/providers/theme-provider.js +11 -0
  191. package/dist/providers/theme-provider.js.map +1 -0
  192. package/dist/providers/translation-provider.d.ts +8 -0
  193. package/dist/providers/translation-provider.d.ts.map +1 -0
  194. package/dist/providers/translation-provider.js +21 -0
  195. package/dist/providers/translation-provider.js.map +1 -0
  196. package/dist/query/page-link.d.ts +20 -0
  197. package/dist/query/page-link.d.ts.map +1 -0
  198. package/dist/query/page-link.js +53 -0
  199. package/dist/query/page-link.js.map +1 -0
  200. package/dist/query/page-path.d.ts +5 -0
  201. package/dist/query/page-path.d.ts.map +1 -0
  202. package/dist/query/page-path.js +24 -0
  203. package/dist/query/page-path.js.map +1 -0
  204. package/dist/query/query-param.d.ts +63 -0
  205. package/dist/query/query-param.d.ts.map +1 -0
  206. package/dist/query/query-param.js +215 -0
  207. package/dist/query/query-param.js.map +1 -0
  208. package/dist/query/use-query-param.d.ts +5 -0
  209. package/dist/query/use-query-param.d.ts.map +1 -0
  210. package/dist/query/use-query-param.js +21 -0
  211. package/dist/query/use-query-param.js.map +1 -0
  212. package/dist/skeleton/skeleton-article.d.ts +2 -0
  213. package/dist/skeleton/skeleton-article.d.ts.map +1 -0
  214. package/dist/skeleton/skeleton-article.js +7 -0
  215. package/dist/skeleton/skeleton-article.js.map +1 -0
  216. package/dist/skeleton/skeleton-auth-form.d.ts +6 -0
  217. package/dist/skeleton/skeleton-auth-form.d.ts.map +1 -0
  218. package/dist/skeleton/skeleton-auth-form.js +9 -0
  219. package/dist/skeleton/skeleton-auth-form.js.map +1 -0
  220. package/dist/skeleton/skeleton-cards.d.ts +6 -0
  221. package/dist/skeleton/skeleton-cards.d.ts.map +1 -0
  222. package/dist/skeleton/skeleton-cards.js +16 -0
  223. package/dist/skeleton/skeleton-cards.js.map +1 -0
  224. package/dist/skeleton/skeleton-chat.d.ts +2 -0
  225. package/dist/skeleton/skeleton-chat.d.ts.map +1 -0
  226. package/dist/skeleton/skeleton-chat.js +17 -0
  227. package/dist/skeleton/skeleton-chat.js.map +1 -0
  228. package/dist/skeleton/skeleton-dashboard.d.ts +2 -0
  229. package/dist/skeleton/skeleton-dashboard.d.ts.map +1 -0
  230. package/dist/skeleton/skeleton-dashboard.js +16 -0
  231. package/dist/skeleton/skeleton-dashboard.js.map +1 -0
  232. package/dist/skeleton/skeleton-float.d.ts +2 -0
  233. package/dist/skeleton/skeleton-float.d.ts.map +1 -0
  234. package/dist/skeleton/skeleton-float.js +7 -0
  235. package/dist/skeleton/skeleton-float.js.map +1 -0
  236. package/dist/skeleton/skeleton-form.d.ts +10 -0
  237. package/dist/skeleton/skeleton-form.d.ts.map +1 -0
  238. package/dist/skeleton/skeleton-form.js +16 -0
  239. package/dist/skeleton/skeleton-form.js.map +1 -0
  240. package/dist/skeleton/skeleton-menu.d.ts +2 -0
  241. package/dist/skeleton/skeleton-menu.d.ts.map +1 -0
  242. package/dist/skeleton/skeleton-menu.js +16 -0
  243. package/dist/skeleton/skeleton-menu.js.map +1 -0
  244. package/dist/skeleton/skeleton-page.d.ts +2 -0
  245. package/dist/skeleton/skeleton-page.d.ts.map +1 -0
  246. package/dist/skeleton/skeleton-page.js +9 -0
  247. package/dist/skeleton/skeleton-page.js.map +1 -0
  248. package/dist/skeleton/skeleton-table.d.ts +2 -0
  249. package/dist/skeleton/skeleton-table.d.ts.map +1 -0
  250. package/dist/skeleton/skeleton-table.js +16 -0
  251. package/dist/skeleton/skeleton-table.js.map +1 -0
  252. package/dist/state/auth-service.d.ts +28 -0
  253. package/dist/state/auth-service.d.ts.map +1 -0
  254. package/dist/state/auth-service.js +92 -0
  255. package/dist/state/auth-service.js.map +1 -0
  256. package/dist/state/branch-service.d.ts +42 -0
  257. package/dist/state/branch-service.d.ts.map +1 -0
  258. package/dist/state/branch-service.js +193 -0
  259. package/dist/state/branch-service.js.map +1 -0
  260. package/dist/state/document-sync.d.ts +7 -0
  261. package/dist/state/document-sync.d.ts.map +1 -0
  262. package/dist/state/document-sync.js +39 -0
  263. package/dist/state/document-sync.js.map +1 -0
  264. package/dist/state/language-service.d.ts +16 -0
  265. package/dist/state/language-service.d.ts.map +1 -0
  266. package/dist/state/language-service.js +73 -0
  267. package/dist/state/language-service.js.map +1 -0
  268. package/dist/state/menu-service.d.ts +20 -0
  269. package/dist/state/menu-service.d.ts.map +1 -0
  270. package/dist/state/menu-service.js +59 -0
  271. package/dist/state/menu-service.js.map +1 -0
  272. package/dist/state/navigation-service.d.ts +37 -0
  273. package/dist/state/navigation-service.d.ts.map +1 -0
  274. package/dist/state/navigation-service.js +131 -0
  275. package/dist/state/navigation-service.js.map +1 -0
  276. package/dist/state/preference-sync.d.ts +15 -0
  277. package/dist/state/preference-sync.d.ts.map +1 -0
  278. package/dist/state/preference-sync.js +85 -0
  279. package/dist/state/preference-sync.js.map +1 -0
  280. package/dist/state/progress-service.d.ts +3 -0
  281. package/dist/state/progress-service.d.ts.map +1 -0
  282. package/dist/state/progress-service.js +17 -0
  283. package/dist/state/progress-service.js.map +1 -0
  284. package/dist/state/screen-access.d.ts +15 -0
  285. package/dist/state/screen-access.d.ts.map +1 -0
  286. package/dist/state/screen-access.js +60 -0
  287. package/dist/state/screen-access.js.map +1 -0
  288. package/dist/state/sidebar-service.d.ts +8 -0
  289. package/dist/state/sidebar-service.d.ts.map +1 -0
  290. package/dist/state/sidebar-service.js +18 -0
  291. package/dist/state/sidebar-service.js.map +1 -0
  292. package/dist/state/signals.d.ts +84 -0
  293. package/dist/state/signals.d.ts.map +1 -0
  294. package/dist/state/signals.js +137 -0
  295. package/dist/state/signals.js.map +1 -0
  296. package/dist/state/toast-service.d.ts +9 -0
  297. package/dist/state/toast-service.d.ts.map +1 -0
  298. package/dist/state/toast-service.js +36 -0
  299. package/dist/state/toast-service.js.map +1 -0
  300. package/dist/styles.css +15 -0
  301. package/dist/theme/dark-themes.d.ts +2 -0
  302. package/dist/theme/dark-themes.d.ts.map +1 -0
  303. package/dist/theme/dark-themes.js +20 -0
  304. package/dist/theme/dark-themes.js.map +1 -0
  305. package/dist/theme/logo.d.ts +4 -0
  306. package/dist/theme/logo.d.ts.map +1 -0
  307. package/dist/theme/logo.js +10 -0
  308. package/dist/theme/logo.js.map +1 -0
  309. package/dist/theme/theme-service.d.ts +21 -0
  310. package/dist/theme/theme-service.d.ts.map +1 -0
  311. package/dist/theme/theme-service.js +69 -0
  312. package/dist/theme/theme-service.js.map +1 -0
  313. package/dist/types/class-names.d.ts +9 -0
  314. package/dist/types/class-names.d.ts.map +1 -0
  315. package/dist/types/class-names.js +45 -0
  316. package/dist/types/class-names.js.map +1 -0
  317. package/dist/types/field-error.d.ts +5 -0
  318. package/dist/types/field-error.d.ts.map +1 -0
  319. package/dist/types/field-error.js +16 -0
  320. package/dist/types/field-error.js.map +1 -0
  321. package/dist/types/field-props.d.ts +20 -0
  322. package/dist/types/field-props.d.ts.map +1 -0
  323. package/dist/types/field-props.js +4 -0
  324. package/dist/types/field-props.js.map +1 -0
  325. package/dist/types/field-registry.d.ts +11 -0
  326. package/dist/types/field-registry.d.ts.map +1 -0
  327. package/dist/types/field-registry.js +18 -0
  328. package/dist/types/field-registry.js.map +1 -0
  329. package/dist/types/field-wrapper.d.ts +13 -0
  330. package/dist/types/field-wrapper.d.ts.map +1 -0
  331. package/dist/types/field-wrapper.js +16 -0
  332. package/dist/types/field-wrapper.js.map +1 -0
  333. package/dist/types/lang-field.d.ts +15 -0
  334. package/dist/types/lang-field.d.ts.map +1 -0
  335. package/dist/types/lang-field.js +68 -0
  336. package/dist/types/lang-field.js.map +1 -0
  337. package/dist/types/markdown-color-mode.d.ts +7 -0
  338. package/dist/types/markdown-color-mode.d.ts.map +1 -0
  339. package/dist/types/markdown-color-mode.js +11 -0
  340. package/dist/types/markdown-color-mode.js.map +1 -0
  341. package/dist/types/media-service.d.ts +24 -0
  342. package/dist/types/media-service.d.ts.map +1 -0
  343. package/dist/types/media-service.js +41 -0
  344. package/dist/types/media-service.js.map +1 -0
  345. package/dist/types/media-viewer.d.ts +2 -0
  346. package/dist/types/media-viewer.d.ts.map +1 -0
  347. package/dist/types/media-viewer.js +23 -0
  348. package/dist/types/media-viewer.js.map +1 -0
  349. package/dist/types/type.button.d.ts +36 -0
  350. package/dist/types/type.button.d.ts.map +1 -0
  351. package/dist/types/type.button.js +27 -0
  352. package/dist/types/type.button.js.map +1 -0
  353. package/dist/types/type.checkbox.d.ts +5 -0
  354. package/dist/types/type.checkbox.d.ts.map +1 -0
  355. package/dist/types/type.checkbox.js +26 -0
  356. package/dist/types/type.checkbox.js.map +1 -0
  357. package/dist/types/type.confirm.d.ts +19 -0
  358. package/dist/types/type.confirm.d.ts.map +1 -0
  359. package/dist/types/type.confirm.js +15 -0
  360. package/dist/types/type.confirm.js.map +1 -0
  361. package/dist/types/type.date.d.ts +16 -0
  362. package/dist/types/type.date.d.ts.map +1 -0
  363. package/dist/types/type.date.js +65 -0
  364. package/dist/types/type.date.js.map +1 -0
  365. package/dist/types/type.drawer.d.ts +20 -0
  366. package/dist/types/type.drawer.d.ts.map +1 -0
  367. package/dist/types/type.drawer.js +31 -0
  368. package/dist/types/type.drawer.js.map +1 -0
  369. package/dist/types/type.dropdown.d.ts +23 -0
  370. package/dist/types/type.dropdown.d.ts.map +1 -0
  371. package/dist/types/type.dropdown.js +34 -0
  372. package/dist/types/type.dropdown.js.map +1 -0
  373. package/dist/types/type.filter.d.ts +17 -0
  374. package/dist/types/type.filter.d.ts.map +1 -0
  375. package/dist/types/type.filter.js +28 -0
  376. package/dist/types/type.filter.js.map +1 -0
  377. package/dist/types/type.icon.d.ts +21 -0
  378. package/dist/types/type.icon.d.ts.map +1 -0
  379. package/dist/types/type.icon.js +24 -0
  380. package/dist/types/type.icon.js.map +1 -0
  381. package/dist/types/type.image.d.ts +34 -0
  382. package/dist/types/type.image.d.ts.map +1 -0
  383. package/dist/types/type.image.js +46 -0
  384. package/dist/types/type.image.js.map +1 -0
  385. package/dist/types/type.input.d.ts +13 -0
  386. package/dist/types/type.input.d.ts.map +1 -0
  387. package/dist/types/type.input.js +29 -0
  388. package/dist/types/type.input.js.map +1 -0
  389. package/dist/types/type.lang-md.d.ts +10 -0
  390. package/dist/types/type.lang-md.d.ts.map +1 -0
  391. package/dist/types/type.lang-md.js +56 -0
  392. package/dist/types/type.lang-md.js.map +1 -0
  393. package/dist/types/type.lang.d.ts +11 -0
  394. package/dist/types/type.lang.d.ts.map +1 -0
  395. package/dist/types/type.lang.js +56 -0
  396. package/dist/types/type.lang.js.map +1 -0
  397. package/dist/types/type.list.d.ts +13 -0
  398. package/dist/types/type.list.d.ts.map +1 -0
  399. package/dist/types/type.list.js +42 -0
  400. package/dist/types/type.list.js.map +1 -0
  401. package/dist/types/type.mdv.d.ts +10 -0
  402. package/dist/types/type.mdv.d.ts.map +1 -0
  403. package/dist/types/type.mdv.js +22 -0
  404. package/dist/types/type.mdv.js.map +1 -0
  405. package/dist/types/type.mdx.d.ts +10 -0
  406. package/dist/types/type.mdx.d.ts.map +1 -0
  407. package/dist/types/type.mdx.js +30 -0
  408. package/dist/types/type.mdx.js.map +1 -0
  409. package/dist/types/type.modal.d.ts +18 -0
  410. package/dist/types/type.modal.d.ts.map +1 -0
  411. package/dist/types/type.modal.js +30 -0
  412. package/dist/types/type.modal.js.map +1 -0
  413. package/dist/types/type.otp.d.ts +8 -0
  414. package/dist/types/type.otp.d.ts.map +1 -0
  415. package/dist/types/type.otp.js +48 -0
  416. package/dist/types/type.otp.js.map +1 -0
  417. package/dist/types/type.search.d.ts +16 -0
  418. package/dist/types/type.search.d.ts.map +1 -0
  419. package/dist/types/type.search.js +48 -0
  420. package/dist/types/type.search.js.map +1 -0
  421. package/dist/types/type.select.d.ts +14 -0
  422. package/dist/types/type.select.d.ts.map +1 -0
  423. package/dist/types/type.select.js +53 -0
  424. package/dist/types/type.select.js.map +1 -0
  425. package/dist/types/type.switch.d.ts +8 -0
  426. package/dist/types/type.switch.d.ts.map +1 -0
  427. package/dist/types/type.switch.js +26 -0
  428. package/dist/types/type.switch.js.map +1 -0
  429. package/dist/types/type.table.d.ts +28 -0
  430. package/dist/types/type.table.d.ts.map +1 -0
  431. package/dist/types/type.table.js +72 -0
  432. package/dist/types/type.table.js.map +1 -0
  433. package/dist/types/type.text-area.d.ts +9 -0
  434. package/dist/types/type.text-area.d.ts.map +1 -0
  435. package/dist/types/type.text-area.js +26 -0
  436. package/dist/types/type.text-area.js.map +1 -0
  437. package/dist/types/type.time.d.ts +9 -0
  438. package/dist/types/type.time.d.ts.map +1 -0
  439. package/dist/types/type.time.js +34 -0
  440. package/dist/types/type.time.js.map +1 -0
  441. package/dist/types/type.upload.d.ts +45 -0
  442. package/dist/types/type.upload.d.ts.map +1 -0
  443. package/dist/types/type.upload.js +90 -0
  444. package/dist/types/type.upload.js.map +1 -0
  445. package/dist/types/type.video.d.ts +19 -0
  446. package/dist/types/type.video.d.ts.map +1 -0
  447. package/dist/types/type.video.js +33 -0
  448. package/dist/types/type.video.js.map +1 -0
  449. package/dist/types/upload-service.d.ts +47 -0
  450. package/dist/types/upload-service.d.ts.map +1 -0
  451. package/dist/types/upload-service.js +191 -0
  452. package/dist/types/upload-service.js.map +1 -0
  453. package/dist/utils/app-config.d.ts +6 -0
  454. package/dist/utils/app-config.d.ts.map +1 -0
  455. package/dist/utils/app-config.js +17 -0
  456. package/dist/utils/app-config.js.map +1 -0
  457. package/dist/utils/app-http.d.ts +49 -0
  458. package/dist/utils/app-http.d.ts.map +1 -0
  459. package/dist/utils/app-http.js +229 -0
  460. package/dist/utils/app-http.js.map +1 -0
  461. package/dist/utils/app-storage.d.ts +56 -0
  462. package/dist/utils/app-storage.d.ts.map +1 -0
  463. package/dist/utils/app-storage.js +236 -0
  464. package/dist/utils/app-storage.js.map +1 -0
  465. package/dist/utils/crypto-util.d.ts +15 -0
  466. package/dist/utils/crypto-util.d.ts.map +1 -0
  467. package/dist/utils/crypto-util.js +76 -0
  468. package/dist/utils/crypto-util.js.map +1 -0
  469. package/dist/utils/event-util.d.ts +16 -0
  470. package/dist/utils/event-util.d.ts.map +1 -0
  471. package/dist/utils/event-util.js +51 -0
  472. package/dist/utils/event-util.js.map +1 -0
  473. package/dist/utils/file-util.d.ts +30 -0
  474. package/dist/utils/file-util.d.ts.map +1 -0
  475. package/dist/utils/file-util.js +165 -0
  476. package/dist/utils/file-util.js.map +1 -0
  477. package/dist/utils/lang-util.d.ts +12 -0
  478. package/dist/utils/lang-util.d.ts.map +1 -0
  479. package/dist/utils/lang-util.js +53 -0
  480. package/dist/utils/lang-util.js.map +1 -0
  481. package/dist/utils/language-util.d.ts +21 -0
  482. package/dist/utils/language-util.d.ts.map +1 -0
  483. package/dist/utils/language-util.js +96 -0
  484. package/dist/utils/language-util.js.map +1 -0
  485. package/dist/utils/leave-guard.d.ts +5 -0
  486. package/dist/utils/leave-guard.d.ts.map +1 -0
  487. package/dist/utils/leave-guard.js +24 -0
  488. package/dist/utils/leave-guard.js.map +1 -0
  489. package/dist/utils/lucide-icon.d.ts +10 -0
  490. package/dist/utils/lucide-icon.d.ts.map +1 -0
  491. package/dist/utils/lucide-icon.js +48 -0
  492. package/dist/utils/lucide-icon.js.map +1 -0
  493. package/dist/utils/menu-util.d.ts +33 -0
  494. package/dist/utils/menu-util.d.ts.map +1 -0
  495. package/dist/utils/menu-util.js +151 -0
  496. package/dist/utils/menu-util.js.map +1 -0
  497. package/dist/utils/option-util.d.ts +21 -0
  498. package/dist/utils/option-util.d.ts.map +1 -0
  499. package/dist/utils/option-util.js +101 -0
  500. package/dist/utils/option-util.js.map +1 -0
  501. package/dist/utils/session-id.d.ts +5 -0
  502. package/dist/utils/session-id.d.ts.map +1 -0
  503. package/dist/utils/session-id.js +44 -0
  504. package/dist/utils/session-id.js.map +1 -0
  505. package/dist/utils/shared-regexp.d.ts +31 -0
  506. package/dist/utils/shared-regexp.d.ts.map +1 -0
  507. package/dist/utils/shared-regexp.js +17 -0
  508. package/dist/utils/shared-regexp.js.map +1 -0
  509. package/dist/utils/storage-keys.d.ts +68 -0
  510. package/dist/utils/storage-keys.d.ts.map +1 -0
  511. package/dist/utils/storage-keys.js +75 -0
  512. package/dist/utils/storage-keys.js.map +1 -0
  513. package/package.json +101 -4
  514. package/src/components/app-brand.tsx +37 -0
  515. package/src/components/branch-switcher.tsx +74 -0
  516. package/src/components/coming-soon.tsx +35 -0
  517. package/src/components/empty-state.tsx +42 -0
  518. package/src/components/language-switcher.tsx +77 -0
  519. package/src/components/page-loader.tsx +11 -0
  520. package/src/components/page-not-found.tsx +42 -0
  521. package/src/components/permission-denied.tsx +21 -0
  522. package/src/components/require-access.tsx +30 -0
  523. package/src/components/scroll-to-top.tsx +62 -0
  524. package/src/components/settings-menu.tsx +224 -0
  525. package/src/components/theme-switcher.tsx +72 -0
  526. package/src/components/toast-container.tsx +73 -0
  527. package/src/components/top-progress.tsx +14 -0
  528. package/src/components/user-menu.tsx +179 -0
  529. package/src/context/ui-context.ts +20 -0
  530. package/src/context/use-ui.ts +42 -0
  531. package/src/i18n/default-messages.ts +67 -0
  532. package/src/i18n/direction.ts +43 -0
  533. package/src/i18n/locale-service.ts +187 -0
  534. package/src/i18n/translator.ts +88 -0
  535. package/src/index.ts +341 -0
  536. package/src/interfaces/app-types.ts +154 -0
  537. package/src/interfaces/toast.ts +12 -0
  538. package/src/interfaces/ui-config.ts +189 -0
  539. package/src/interfaces/ui-context.ts +43 -0
  540. package/src/layout.ts +29 -0
  541. package/src/layouts/app-layout.tsx +103 -0
  542. package/src/layouts/article-layout.tsx +16 -0
  543. package/src/layouts/aside-layout.tsx +118 -0
  544. package/src/layouts/auth-layout.tsx +41 -0
  545. package/src/layouts/content-layout.tsx +11 -0
  546. package/src/layouts/float-layout.tsx +11 -0
  547. package/src/layouts/grid-layout.tsx +11 -0
  548. package/src/layouts/head-layout.tsx +61 -0
  549. package/src/layouts/header.tsx +74 -0
  550. package/src/layouts/layout-constants.ts +5 -0
  551. package/src/layouts/mega-menu.tsx +203 -0
  552. package/src/layouts/navigation.ts +45 -0
  553. package/src/layouts/rail-flyout.tsx +77 -0
  554. package/src/layouts/rail-tooltip.tsx +77 -0
  555. package/src/layouts/sidebar.tsx +296 -0
  556. package/src/markdown.ts +12 -0
  557. package/src/providers/provider-effects.ts +30 -0
  558. package/src/providers/register-config.ts +30 -0
  559. package/src/providers/shared-web-ui-provider.tsx +98 -0
  560. package/src/providers/theme-provider.tsx +15 -0
  561. package/src/providers/translation-provider.tsx +28 -0
  562. package/src/query/page-link.tsx +84 -0
  563. package/src/query/page-path.ts +26 -0
  564. package/src/query/query-param.ts +263 -0
  565. package/src/query/use-query-param.ts +23 -0
  566. package/src/skeleton/skeleton-article.tsx +11 -0
  567. package/src/skeleton/skeleton-auth-form.tsx +20 -0
  568. package/src/skeleton/skeleton-cards.tsx +35 -0
  569. package/src/skeleton/skeleton-chat.tsx +34 -0
  570. package/src/skeleton/skeleton-dashboard.tsx +34 -0
  571. package/src/skeleton/skeleton-float.tsx +10 -0
  572. package/src/skeleton/skeleton-form.tsx +45 -0
  573. package/src/skeleton/skeleton-menu.tsx +30 -0
  574. package/src/skeleton/skeleton-page.tsx +18 -0
  575. package/src/skeleton/skeleton-table.tsx +25 -0
  576. package/src/state/auth-service.ts +104 -0
  577. package/src/state/branch-service.ts +217 -0
  578. package/src/state/document-sync.ts +43 -0
  579. package/src/state/language-service.ts +80 -0
  580. package/src/state/menu-service.ts +67 -0
  581. package/src/state/navigation-service.ts +160 -0
  582. package/src/state/preference-sync.ts +93 -0
  583. package/src/state/progress-service.ts +18 -0
  584. package/src/state/screen-access.ts +70 -0
  585. package/src/state/sidebar-service.ts +22 -0
  586. package/src/state/signals.ts +183 -0
  587. package/src/state/toast-service.ts +45 -0
  588. package/src/styles.css +15 -0
  589. package/src/theme/dark-themes.ts +20 -0
  590. package/src/theme/logo.ts +12 -0
  591. package/src/theme/theme-service.ts +82 -0
  592. package/src/types/class-names.ts +53 -0
  593. package/src/types/field-error.ts +19 -0
  594. package/src/types/field-props.ts +23 -0
  595. package/src/types/field-registry.ts +27 -0
  596. package/src/types/field-wrapper.tsx +42 -0
  597. package/src/types/lang-field.ts +71 -0
  598. package/src/types/markdown-color-mode.ts +13 -0
  599. package/src/types/media-service.ts +61 -0
  600. package/src/types/media-viewer.tsx +57 -0
  601. package/src/types/type.button.tsx +108 -0
  602. package/src/types/type.checkbox.tsx +49 -0
  603. package/src/types/type.confirm.tsx +50 -0
  604. package/src/types/type.date.tsx +97 -0
  605. package/src/types/type.drawer.tsx +86 -0
  606. package/src/types/type.dropdown.tsx +81 -0
  607. package/src/types/type.filter.tsx +64 -0
  608. package/src/types/type.icon.ts +53 -0
  609. package/src/types/type.image.tsx +115 -0
  610. package/src/types/type.input.tsx +57 -0
  611. package/src/types/type.lang-md.tsx +129 -0
  612. package/src/types/type.lang.tsx +156 -0
  613. package/src/types/type.list.tsx +97 -0
  614. package/src/types/type.mdv.tsx +35 -0
  615. package/src/types/type.mdx.tsx +54 -0
  616. package/src/types/type.modal.tsx +77 -0
  617. package/src/types/type.otp.tsx +82 -0
  618. package/src/types/type.search.tsx +87 -0
  619. package/src/types/type.select.tsx +87 -0
  620. package/src/types/type.switch.tsx +52 -0
  621. package/src/types/type.table.tsx +152 -0
  622. package/src/types/type.text-area.tsx +51 -0
  623. package/src/types/type.time.tsx +61 -0
  624. package/src/types/type.upload.tsx +294 -0
  625. package/src/types/type.video.tsx +119 -0
  626. package/src/types/upload-service.ts +229 -0
  627. package/src/utils/app-config.ts +21 -0
  628. package/src/utils/app-http.ts +255 -0
  629. package/src/utils/app-storage.ts +259 -0
  630. package/src/utils/crypto-util.ts +88 -0
  631. package/src/utils/event-util.ts +58 -0
  632. package/src/utils/file-util.ts +186 -0
  633. package/src/utils/lang-util.ts +60 -0
  634. package/src/utils/language-util.ts +107 -0
  635. package/src/utils/leave-guard.ts +26 -0
  636. package/src/utils/lucide-icon.ts +55 -0
  637. package/src/utils/menu-util.ts +165 -0
  638. package/src/utils/option-util.ts +108 -0
  639. package/src/utils/session-id.ts +48 -0
  640. package/src/utils/shared-regexp.ts +18 -0
  641. package/src/utils/storage-keys.ts +80 -0
@@ -0,0 +1,229 @@
1
+ // upload-service.ts
2
+ // Logic of TypeUpload / TypeUploadBox without arrow functions inside components.
3
+ // Each upload area registers its current settings, files and change function under an id
4
+ // (data-upload-id). The top-level event handlers below look the area up by that id.
5
+
6
+ import { signal } from "@preact/signals-react";
7
+ import { ConstValue } from "dff-util";
8
+ import type { ChangeEvent, DragEvent, KeyboardEvent, MouseEvent } from "react";
9
+ import { translate } from "../i18n/translator.ts";
10
+ import { ShowToast } from "../state/toast-service.ts";
11
+ import { formatBytes, isFileTypeAllowed, sumFileSizes, type FileTypeRules } from "../utils/file-util.ts";
12
+
13
+ /** Form value of an upload: one File, several Files, or nothing. */
14
+ export type UploadValue = File | File[] | null;
15
+
16
+ export interface UploadSettings {
17
+ rules: FileTypeRules;
18
+ maxSizeBytes: number;
19
+ /** Combined limit for multiple files (0 = no limit). */
20
+ totalSizeBytes: number;
21
+ isMultiple: boolean;
22
+ isDisabled: boolean;
23
+ }
24
+
25
+ export interface UploadBinding {
26
+ settings: UploadSettings;
27
+ files: File[];
28
+ onValueChange: (value: UploadValue) => void;
29
+ onError?: (message: string) => void;
30
+ }
31
+
32
+ const uploadBindings = new Map<string, UploadBinding>();
33
+
34
+ /** Last warning per upload area id. */
35
+ export const uploadWarningsSignal = signal<Record<string, string>>({});
36
+
37
+ /** Saves the latest settings and change function of an upload area. Called while it renders. */
38
+ export function registerUploadBinding(uploadId: string, binding: UploadBinding): void {
39
+ uploadBindings.set(uploadId, binding);
40
+ }
41
+
42
+ /** Turns the form value into a file list. */
43
+ export function readUploadFiles(value: unknown): File[] {
44
+ if (Array.isArray(value)) {
45
+ const files: File[] = [];
46
+ for (const item of value) {
47
+ if (item instanceof File) {
48
+ files.push(item);
49
+ }
50
+ }
51
+ return files;
52
+ }
53
+ if (value instanceof File) {
54
+ return [value];
55
+ }
56
+ return [];
57
+ }
58
+
59
+ /** Sets (or clears with "") the warning of one upload area. */
60
+ export function setUploadWarning(uploadId: string, message: string): void {
61
+ const currentWarnings = uploadWarningsSignal.value;
62
+ const nextWarnings = { ...currentWarnings, [uploadId]: message };
63
+ uploadWarningsSignal.value = nextWarnings;
64
+ }
65
+
66
+ /** Shows a warning in the area, as a toast, and tells the app. */
67
+ function reportUploadProblem(uploadId: string, binding: UploadBinding, message: string): void {
68
+ setUploadWarning(uploadId, message);
69
+ ShowToast(message, "warning");
70
+ if (binding.onError) {
71
+ binding.onError(message);
72
+ }
73
+ }
74
+
75
+ /** Returns the first validation problem of the new files, or "" when they are fine. */
76
+ export function findUploadProblem(candidates: File[], currentFiles: File[], settings: UploadSettings): string {
77
+ for (const file of candidates) {
78
+ const isAllowed = isFileTypeAllowed(file, settings.rules);
79
+ if (!isAllowed) {
80
+ const typeParams = { name: file.name, types: settings.rules.displayText };
81
+ return translate("ui.uploadTypeError", typeParams);
82
+ }
83
+ if (file.size > settings.maxSizeBytes) {
84
+ const fileSizeText = formatBytes(file.size);
85
+ const maxSizeText = formatBytes(settings.maxSizeBytes);
86
+ const sizeParams = { name: file.name, size: fileSizeText, max: maxSizeText };
87
+ return translate("ui.uploadSizeError", sizeParams);
88
+ }
89
+ }
90
+ const hasTotalLimit = settings.isMultiple && settings.totalSizeBytes > 0;
91
+ if (!hasTotalLimit) {
92
+ return ConstValue.EMPTY;
93
+ }
94
+ const allFiles = [...currentFiles, ...candidates];
95
+ const combinedBytes = sumFileSizes(allFiles);
96
+ if (combinedBytes > settings.totalSizeBytes) {
97
+ const combinedText = formatBytes(combinedBytes);
98
+ const totalText = formatBytes(settings.totalSizeBytes);
99
+ const totalParams = { size: combinedText, max: totalText };
100
+ return translate("ui.uploadTotalError", totalParams);
101
+ }
102
+ return ConstValue.EMPTY;
103
+ }
104
+
105
+ /** Validates new files and passes them to the form (single: the first file; multiple: added to the list). */
106
+ export function processUploadFiles(uploadId: string, incomingFiles: File[]): void {
107
+ const binding = uploadBindings.get(uploadId);
108
+ if (!binding || binding.settings.isDisabled || incomingFiles.length === 0) {
109
+ return;
110
+ }
111
+ const settings = binding.settings;
112
+ const firstFile = incomingFiles[0];
113
+ const candidates = settings.isMultiple || !firstFile ? incomingFiles : [firstFile];
114
+ const currentFiles = settings.isMultiple ? binding.files : [];
115
+ const problem = findUploadProblem(candidates, currentFiles, settings);
116
+ if (problem) {
117
+ reportUploadProblem(uploadId, binding, problem);
118
+ return;
119
+ }
120
+ setUploadWarning(uploadId, ConstValue.EMPTY);
121
+ if (settings.isMultiple) {
122
+ const nextFiles = [...currentFiles, ...candidates];
123
+ binding.onValueChange(nextFiles);
124
+ return;
125
+ }
126
+ binding.onValueChange(candidates[0] ?? null);
127
+ }
128
+
129
+ /** Finds the hidden file input of the upload area and opens the file picker. */
130
+ function openFilePicker(areaElement: HTMLElement | null): void {
131
+ if (!areaElement) {
132
+ return;
133
+ }
134
+ const fileInput = areaElement.querySelector<HTMLInputElement>("input[type=file]");
135
+ if (fileInput && !fileInput.disabled) {
136
+ fileInput.click();
137
+ }
138
+ }
139
+
140
+ /** Reads the upload id from the closest element with data-upload-id. */
141
+ function readUploadId(element: HTMLElement): string {
142
+ const area = element.closest<HTMLElement>("[data-upload-id]");
143
+ return area?.dataset.uploadId ?? ConstValue.EMPTY;
144
+ }
145
+
146
+ /** Click on the drop zone or the browse button opens the picker. */
147
+ export function handleUploadAreaClick(event: MouseEvent<HTMLElement>): void {
148
+ event.stopPropagation();
149
+ const element = event.currentTarget;
150
+ const area = element.closest<HTMLElement>("[data-upload-id]");
151
+ openFilePicker(area);
152
+ }
153
+
154
+ /** Enter or Space on the drop zone opens the picker. */
155
+ export function handleUploadAreaKeyDown(event: KeyboardEvent<HTMLElement>): void {
156
+ const isActivateKey = event.key === "Enter" || event.key === " ";
157
+ if (!isActivateKey) {
158
+ return;
159
+ }
160
+ event.preventDefault();
161
+ const area = event.currentTarget;
162
+ openFilePicker(area);
163
+ }
164
+
165
+ /** Marks the drop zone while a file is dragged over it. */
166
+ export function handleUploadDragOver(event: DragEvent<HTMLElement>): void {
167
+ event.preventDefault();
168
+ const area = event.currentTarget;
169
+ area.dataset.dragging = "true";
170
+ }
171
+
172
+ /** Removes the drag mark. */
173
+ export function handleUploadDragLeave(event: DragEvent<HTMLElement>): void {
174
+ event.preventDefault();
175
+ const area = event.currentTarget;
176
+ area.dataset.dragging = "false";
177
+ }
178
+
179
+ /** Takes the dropped files. */
180
+ export function handleUploadDrop(event: DragEvent<HTMLElement>): void {
181
+ event.preventDefault();
182
+ const area = event.currentTarget;
183
+ area.dataset.dragging = "false";
184
+ const uploadId = readUploadId(area);
185
+ const droppedFiles = event.dataTransfer.files;
186
+ const files = Array.from(droppedFiles);
187
+ processUploadFiles(uploadId, files);
188
+ }
189
+
190
+ /** Takes the files picked in the browser dialog, then clears the input so the same file can be picked again. */
191
+ export function handleUploadInputChange(event: ChangeEvent<HTMLInputElement>): void {
192
+ const input = event.currentTarget;
193
+ const uploadId = readUploadId(input);
194
+ const pickedFiles = input.files ?? [];
195
+ const files = Array.from(pickedFiles);
196
+ processUploadFiles(uploadId, files);
197
+ input.value = ConstValue.EMPTY;
198
+ }
199
+
200
+ /** Removes the file whose index is in data-file-index. */
201
+ export function handleUploadRemoveClick(event: MouseEvent<HTMLButtonElement>): void {
202
+ event.stopPropagation();
203
+ const button = event.currentTarget;
204
+ const uploadId = readUploadId(button);
205
+ const binding = uploadBindings.get(uploadId);
206
+ if (!binding) {
207
+ return;
208
+ }
209
+ const indexText = button.dataset.fileIndex ?? "-1";
210
+ const removeIndex = Number(indexText);
211
+ const remainingFiles: File[] = [];
212
+ for (let index = 0; index < binding.files.length; index += 1) {
213
+ const file = binding.files[index];
214
+ if (file && index !== removeIndex) {
215
+ remainingFiles.push(file);
216
+ }
217
+ }
218
+ setUploadWarning(uploadId, ConstValue.EMPTY);
219
+ const nextValue = binding.settings.isMultiple ? remainingFiles : null;
220
+ binding.onValueChange(nextValue);
221
+ }
222
+
223
+ /** Closes the warning banner. */
224
+ export function handleUploadWarningClose(event: MouseEvent<HTMLButtonElement>): void {
225
+ event.stopPropagation();
226
+ const button = event.currentTarget;
227
+ const uploadId = readUploadId(button);
228
+ setUploadWarning(uploadId, ConstValue.EMPTY);
229
+ }
@@ -0,0 +1,21 @@
1
+ // app-config.ts
2
+ // The app config as a plain object (no signal), for the non-React helpers AppHttp and AppStorage.
3
+ // <SharedWebUiProvider config={config}> saves it. Code that runs before the provider (module load,
4
+ // a service worker ...) can save it earlier:
5
+ //
6
+ // setAppConfig(config); // for example in main.tsx, before createRoot(...)
7
+ // const config = readAppConfig(); // the saved config, or null
8
+
9
+ import type { UiConfig } from "../interfaces/ui-config.ts";
10
+
11
+ let appConfig: UiConfig | null = null;
12
+
13
+ /** Saves the config for AppHttp and AppStorage. */
14
+ export function setAppConfig(config: UiConfig): void {
15
+ appConfig = config;
16
+ }
17
+
18
+ /** The saved config, or null before setAppConfig / SharedWebUiProvider. */
19
+ export function readAppConfig(): UiConfig | null {
20
+ return appConfig;
21
+ }
@@ -0,0 +1,255 @@
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
+ // // hooks/service-http.ts
17
+ // const listUrl = `${MsUrl.main}/profile/search`;
18
+ // const response = await AppHttp.Get(listUrl, params);
19
+ // const saved = await AppHttp.Post(saveUrl, body);
20
+ // AppHttp.setHeader("x-custom", value);
21
+ //
22
+ // // file upload to a signed URL
23
+ // const signed = await AppHttp.Post(`${MsUrl.utils}/s3/upload-url`, { fileName: file.name });
24
+ // const uploaded = await uploadToSignedUrl(file, signed.data.upload, signed.data.download);
25
+ // // uploaded = { filename, mimetype, url }
26
+
27
+ import { Http, type FileType } from "dff-util";
28
+ import type { UiConfig } from "../interfaces/ui-config.ts";
29
+ import { ShowProgress } from "../state/progress-service.ts";
30
+ import { readAppConfig } from "./app-config.ts";
31
+ import { AppStorage } from "./app-storage.ts";
32
+ import { setLeaveGuard } from "./leave-guard.ts";
33
+ import { readSessionId } from "./session-id.ts";
34
+ import { BRANCH_ID, TOKEN } from "./storage-keys.ts";
35
+
36
+ export type HttpParams = Record<string, string | number | boolean | null | undefined>;
37
+ export type HttpHeaders = Record<string, string>;
38
+
39
+ const CONFIG_MISSING = "shared-lib-web: config is missing. Render <SharedWebUiProvider config={config}> or call setAppConfig(config) first.";
40
+ const BASE_URL_MISSING = "shared-lib-web: no API base URL. Set config.http.baseUrl or window.env.REACT_APP_<APPNAMEKEY>_API_BASE_URL.";
41
+
42
+ /** window.env name (without prefix) of the API base URL. */
43
+ export const API_BASE_URL_ENV = "API_BASE_URL";
44
+
45
+
46
+ const runtimeHeaders: HttpHeaders = {};
47
+
48
+ /** Returns the saved config or throws a clear error. */
49
+ function readSavedConfig(): UiConfig {
50
+ const config = readAppConfig();
51
+ if (!config) {
52
+ throw new Error(CONFIG_MISSING);
53
+ }
54
+ return config;
55
+ }
56
+
57
+ /** true when the progress bar should show. */
58
+ function isProgressEnabled(): boolean {
59
+ const config = readAppConfig();
60
+ return config?.http?.showProgress ?? true;
61
+ }
62
+
63
+ /** JWT from AppStorage (config.http.tokenKey, default TOKEN, sessionStorage). "" when missing. */
64
+ export function readJwtToken(): string {
65
+ const config = readAppConfig();
66
+ const tokenKey = config?.http?.tokenKey ?? TOKEN;
67
+ const storedToken = AppStorage.getText(tokenKey);
68
+ const plainToken = storedToken.replace(/^Bearer\s+/i, "");
69
+ const token = plainToken.trim();
70
+ const isMissing = token.length === 0 || token === "null" || token === "undefined";
71
+ return isMissing ? "" : token;
72
+ }
73
+
74
+ /** "/api" -> "https://this-site/api". Absolute URLs stay as they are. A trailing "/" is removed. */
75
+ export function toAbsoluteUrl(url: string): string {
76
+ const hasWindow = typeof window !== "undefined";
77
+ const isAbsolute = /^https?:\/\//i.test(url);
78
+ const fullUrl = isAbsolute || !hasWindow ? url : `${window.location.origin}${url}`;
79
+ return fullUrl.replace(/\/+$/, "");
80
+ }
81
+
82
+ /** Turns a Response body into JSON or text. */
83
+ async function readResponseBody(response: Response): Promise<unknown> {
84
+ const contentType = response.headers.get("content-type") ?? "";
85
+ if (contentType.includes("application/json")) {
86
+ return response.json();
87
+ }
88
+ return response.text();
89
+ }
90
+
91
+ export class AppHttp {
92
+ /**
93
+ * API base URL: window.env REACT_APP_<APPNAMEKEY>_API_BASE_URL first, then config.http.baseUrl.
94
+ * A relative base ("/api") becomes absolute ("https://this-site/api"). Also set as dff-util Http.API_BASE_URL,
95
+ * so AppHttp.Get("/profile/search") works with a path only.
96
+ */
97
+ static BaseUrl(): string {
98
+ const envBaseUrl = AppStorage.envData(API_BASE_URL_ENV);
99
+ const savedConfig = readSavedConfig();
100
+ const baseUrl = envBaseUrl ?? savedConfig.http?.baseUrl;
101
+ if (!baseUrl) {
102
+ throw new Error(BASE_URL_MISSING);
103
+ }
104
+ const absoluteBaseUrl = toAbsoluteUrl(baseUrl);
105
+ Http.API_BASE_URL = absoluteBaseUrl;
106
+ return absoluteBaseUrl;
107
+ }
108
+
109
+ /** Adds (or with "" removes) a header sent with every request, for example the selected branch. */
110
+ static setHeader(headerName: string, value: string): void {
111
+ if (value.length === 0) {
112
+ delete runtimeHeaders[headerName];
113
+ return;
114
+ }
115
+ runtimeHeaders[headerName] = value;
116
+ }
117
+
118
+ /** JSON headers: content type, bearer token, session id, branch, config and runtime headers. */
119
+ static Headers(): HttpHeaders {
120
+ const rawHeaders = AppHttp.RawHeaders();
121
+ return { "Content-Type": "application/json", ...rawHeaders };
122
+ }
123
+
124
+ /** Headers without Content-Type (for FormData uploads, the browser sets the boundary). */
125
+ static RawHeaders(): HttpHeaders {
126
+ const savedConfig = readSavedConfig();
127
+ const configHeaders = savedConfig.http?.headers ?? {};
128
+ const headers: HttpHeaders = { ...configHeaders, ...runtimeHeaders };
129
+ const token = readJwtToken();
130
+ if (token.length > 0) {
131
+ headers.Authorization = `Bearer ${token}`;
132
+ }
133
+ headers["x-session-id"] = readSessionId();
134
+ headers["x-branch-id"] = AppStorage.getText(BRANCH_ID);
135
+ return headers;
136
+ }
137
+
138
+ /** GET with query params. */
139
+ static async Get(url: string, params: HttpParams = {}, customHeaders: HttpHeaders = {}): Promise<unknown> {
140
+ const baseHeaders = AppHttp.Headers();
141
+ const headers = { ...baseHeaders, ...customHeaders };
142
+ const request = Http.Get(url, params, headers);
143
+ return AppHttp.withProgress(request);
144
+ }
145
+
146
+ /** POST a JSON body. */
147
+ static async Post(url: string, body: unknown, customHeaders: HttpHeaders = {}): Promise<unknown> {
148
+ const baseHeaders = AppHttp.Headers();
149
+ const headers = { ...baseHeaders, ...customHeaders };
150
+ const request = Http.Post(url, body, headers);
151
+ return AppHttp.withProgress(request);
152
+ }
153
+
154
+ /** PUT a JSON body to url/id. */
155
+ static async Put(url: string, id: string, body: unknown): Promise<unknown> {
156
+ const headers = AppHttp.Headers();
157
+ const itemUrl = `${url}/${id}`;
158
+ const request = Http.Put(itemUrl, body, headers);
159
+ return AppHttp.withProgress(request);
160
+ }
161
+
162
+ /** DELETE url/id. */
163
+ static async Delete(url: string, id: string, params: HttpParams = {}): Promise<unknown> {
164
+ const headers = AppHttp.Headers();
165
+ const itemUrl = `${url}/${id}`;
166
+ const request = Http.Delete(itemUrl, params, headers);
167
+ return AppHttp.withProgress(request);
168
+ }
169
+
170
+ /** PATCH a JSON body. */
171
+ static async Patch(url: string, body: unknown): Promise<unknown> {
172
+ const headers = AppHttp.Headers();
173
+ const bodyText = JSON.stringify(body ?? {});
174
+ const requestInit = { method: "PATCH", headers: headers, body: bodyText };
175
+ const request = fetch(url, requestInit);
176
+ const response = await AppHttp.withProgress(request);
177
+ if (!response.ok) {
178
+ const errorText = await response.text();
179
+ throw new Error(errorText || `PATCH ${response.status}`);
180
+ }
181
+ return readResponseBody(response);
182
+ }
183
+
184
+ /** Option lists from the backend loader: GET `${config.http.loadUrl}/${id}`. */
185
+ static async Load(id: string, params: HttpParams = {}): Promise<unknown> {
186
+ const savedConfig = readSavedConfig();
187
+ const baseUrl = AppHttp.BaseUrl();
188
+ const loadUrl = savedConfig.http?.loadUrl ?? `${baseUrl}/load`;
189
+ const fullUrl = `${loadUrl}/${id}`;
190
+ return AppHttp.Get(fullUrl, params);
191
+ }
192
+
193
+ /** PUT a file to a signed upload URL (plain PUT, no extra headers, so bucket CORS accepts it). */
194
+ static async CloudUpload(uploadUrl: string, file: File): Promise<Response> {
195
+ const requestInit = { method: "PUT", body: file };
196
+ const request = fetch(uploadUrl, requestInit);
197
+ const response = await AppHttp.withProgress(request);
198
+ if (!response.ok) {
199
+ throw new Error(`Upload failed: ${response.status}`);
200
+ }
201
+ return response;
202
+ }
203
+
204
+ /** Same as CloudUpload (the name the apps used). */
205
+ static async uploadFile(uploadUrl: string, file: File): Promise<Response> {
206
+ return AppHttp.CloudUpload(uploadUrl, file);
207
+ }
208
+
209
+ /** Downloads a file and saves it in the browser. */
210
+ static async DownloadFile(url: string, params: HttpParams = {}, fileName?: string): Promise<void> {
211
+ const headers = AppHttp.RawHeaders();
212
+ const request = Http.FileDownload(url, params, headers);
213
+ const blob = await AppHttp.withProgress(request);
214
+ const downloadUrl = window.URL.createObjectURL(blob);
215
+ const link = document.createElement("a");
216
+ const urlParts = url.split("/");
217
+ const lastPart = urlParts[urlParts.length - 1];
218
+ link.href = downloadUrl;
219
+ link.download = fileName ?? lastPart ?? "download";
220
+ document.body.appendChild(link);
221
+ link.click();
222
+ link.remove();
223
+ window.URL.revokeObjectURL(downloadUrl);
224
+ }
225
+
226
+ /** Shows the progress bar while the request runs. */
227
+ static async withProgress<TResult>(request: Promise<TResult>): Promise<TResult> {
228
+ const showProgress = isProgressEnabled();
229
+ if (showProgress) {
230
+ ShowProgress(true);
231
+ }
232
+ try {
233
+ const result = await request;
234
+ return result;
235
+ } finally {
236
+ if (showProgress) {
237
+ ShowProgress(false);
238
+ }
239
+ }
240
+ }
241
+ }
242
+
243
+ /**
244
+ * PUTs the file to a signed (pre-signed S3 / GCS) uploadUrl and returns a dff-util FileType with its download URL.
245
+ * The browser warns before closing the page while the upload runs.
246
+ */
247
+ export async function uploadToSignedUrl(file: File, uploadUrl: string, downloadUrl: string): Promise<FileType> {
248
+ setLeaveGuard(true);
249
+ try {
250
+ await AppHttp.CloudUpload(uploadUrl, file);
251
+ } finally {
252
+ setLeaveGuard(false);
253
+ }
254
+ return { filename: file.name, mimetype: file.type, url: downloadUrl };
255
+ }