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,107 @@
1
+ // company-service.ts
2
+ // Company / brand details from the backend (config.loadCompanyDetails, or setCompanyDetails by hand):
3
+ //
4
+ // { "appName": "YourAppName", "companyName": "YourBrandName",
5
+ // "faviconUrl": "https://www.w3.org/favicon.ico", "logoUrl": "https://www.w3.org/Icons/w3c_home.png",
6
+ // "logoDarkUrl": "https://www.w3.org/Icons/w3c_home.png" }
7
+ //
8
+ // appName header / sidebar / login label and the browser tab title (wins over config.appName)
9
+ // companyName alt text of the logo; read companyDetailsSignal to show it anywhere (a footer, the login page)
10
+ // faviconUrl <link rel="icon" href="...">
11
+ // logoUrl the logo on light themes, and on dark themes without logoDarkUrl (wins over config.logoUrl / logoDarkUrl)
12
+ // logoDarkUrl the logo on dark themes (wins over config.logoDarkUrl)
13
+ // A reply may also be { data: {...} }. A missing field keeps the config value.
14
+
15
+ import type { CompanyDetails, CompanySource, UiConfig } from "../interfaces/ui-config.ts";
16
+ import { companyDetailsSignal } from "./signals.ts";
17
+
18
+ /** The fields of CompanyDetails (only text values are kept). */
19
+ const COMPANY_FIELDS: Array<keyof CompanyDetails> = ["appName", "companyName", "faviconUrl", "logoUrl", "logoDarkUrl"];
20
+
21
+ /** true for a plain object (not null, not a list). */
22
+ function isPlainObject(value: unknown): value is Record<string, unknown> {
23
+ const isObject = typeof value === "object" && value !== null;
24
+ return isObject && !Array.isArray(value);
25
+ }
26
+
27
+ /** The details inside a reply: the object itself, or its "data" object. */
28
+ function unwrapCompanyReply(reply: unknown): Record<string, unknown> | null {
29
+ if (!isPlainObject(reply)) {
30
+ return null;
31
+ }
32
+ const data = reply.data;
33
+ return isPlainObject(data) ? data : reply;
34
+ }
35
+
36
+ /** Reads the company details from a reply ({...} or { data: {...} }); empty or unknown values are left out. */
37
+ export function readCompanyDetails(reply: unknown): CompanyDetails | null {
38
+ const source = unwrapCompanyReply(reply);
39
+ if (!source) {
40
+ return null;
41
+ }
42
+ const details: CompanyDetails = {};
43
+ for (const field of COMPANY_FIELDS) {
44
+ const value = source[field];
45
+ const isText = typeof value === "string" && value !== "";
46
+ if (isText) {
47
+ details[field] = value;
48
+ }
49
+ }
50
+ return details;
51
+ }
52
+
53
+ /** Points <link rel="icon"> at the favicon URL (created when the page has none). */
54
+ function writeFavicon(faviconUrl: string): void {
55
+ let iconElement = document.querySelector<HTMLLinkElement>('link[rel~="icon"]');
56
+ if (!iconElement) {
57
+ iconElement = document.createElement("link");
58
+ iconElement.rel = "icon";
59
+ document.head.append(iconElement);
60
+ }
61
+ iconElement.href = faviconUrl;
62
+ }
63
+
64
+ /** Writes the favicon and the tab title of the company details (fields that are missing are left alone). */
65
+ function applyCompanyToDocument(details: CompanyDetails | null): void {
66
+ const hasDocument = typeof document !== "undefined";
67
+ if (!hasDocument || !details) {
68
+ return;
69
+ }
70
+ if (details.faviconUrl) {
71
+ writeFavicon(details.faviconUrl);
72
+ }
73
+ if (details.appName) {
74
+ document.title = details.appName;
75
+ }
76
+ }
77
+
78
+ /**
79
+ * Sets the company details (the backend reply as it is: {...} or { data: {...} }); null = none (config values).
80
+ * The brand (logo, app name) updates at once; faviconUrl and appName also go to the browser tab.
81
+ */
82
+ export function setCompanyDetails(reply: CompanySource | unknown): void {
83
+ const details = readCompanyDetails(reply);
84
+ companyDetailsSignal.value = details;
85
+ applyCompanyToDocument(details);
86
+ }
87
+
88
+ /** true while config.loadCompanyDetails has not answered yet (no reply, and no config.appName to show meanwhile). */
89
+ export function isCompanyPending(config: UiConfig, details: CompanyDetails | null): boolean {
90
+ const hasCompanySource = Boolean(config.loadCompanyDetails);
91
+ return hasCompanySource && !details && !config.appName;
92
+ }
93
+
94
+ /**
95
+ * The app label: company appName, else config.appName, else config.appNameKey (shown with t()).
96
+ * "" while the company details are still loading (so the app key does not flash before the real name).
97
+ */
98
+ export function readAppNameLabel(config: UiConfig, details: CompanyDetails | null): string {
99
+ if (details?.appName) {
100
+ return details.appName;
101
+ }
102
+ const isPending = isCompanyPending(config, details);
103
+ if (isPending) {
104
+ return "";
105
+ }
106
+ return config.appName ?? config.appNameKey;
107
+ }
@@ -0,0 +1,43 @@
1
+ // document-sync.ts
2
+ // Keeps the <html> element in sync with the signals:
3
+ // <html lang="ar" dir="rtl" data-theme="dark">
4
+ // Uses a signals effect, so it updates automatically whenever a signal changes.
5
+
6
+ import { effect } from "@preact/signals-react";
7
+ import { directionSignal, localeSignal, themeSignal } from "./signals.ts";
8
+
9
+ let stopDocumentSync: (() => void) | null = null;
10
+
11
+ /** Writes the current theme, language and direction to <html>. */
12
+ export function applyDocumentAttributes(): void {
13
+ const theme = themeSignal.value;
14
+ const languageCode = localeSignal.value;
15
+ const direction = directionSignal.value;
16
+ const hasDocument = typeof document !== "undefined";
17
+ if (!hasDocument) {
18
+ return;
19
+ }
20
+ const htmlElement = document.documentElement;
21
+ htmlElement.setAttribute("data-theme", theme);
22
+ htmlElement.setAttribute("dir", direction);
23
+ if (languageCode) {
24
+ htmlElement.lang = languageCode;
25
+ }
26
+ }
27
+
28
+ /** Starts the automatic sync. Safe to call many times: it only starts once. */
29
+ export function startDocumentSync(): void {
30
+ if (stopDocumentSync) {
31
+ return;
32
+ }
33
+ stopDocumentSync = effect(applyDocumentAttributes);
34
+ }
35
+
36
+ /** Stops the automatic sync (used by tests). */
37
+ export function stopDocumentSyncForTests(): void {
38
+ if (!stopDocumentSync) {
39
+ return;
40
+ }
41
+ stopDocumentSync();
42
+ stopDocumentSync = null;
43
+ }
@@ -0,0 +1,85 @@
1
+ // language-service.ts
2
+ // Languages that come from the backend at runtime, separate from config.ts (like the menu: nav).
3
+ //
4
+ // config.loadSupportLanguages: "/app-api/languages" // the provider calls it on start
5
+ // setLanguages(langResponse); // or call it yourself
6
+ //
7
+ // langResponse is the backend reply { data: [...], meta } or only the list.
8
+ // Texts load from config.loadLocale(code): locales/en-US.json, locales/ar-SA.json ...
9
+ // When the reply arrives: the current language stays if it is in the list (and the user picked it),
10
+ // otherwise: the language marked isDefault, else config.defaultLanguage, else the browser / system language,
11
+ // else "en-US" (when listed), else the first one.
12
+
13
+ import { applyLanguage, readBrowserLanguage, readFallbackLanguage, readIsLanguageChosen } from "../i18n/locale-service.ts";
14
+ import type { LangSource } from "../interfaces/app-types.ts";
15
+ import { findLanguageOption } from "../i18n/direction.ts";
16
+ import { readDefaultLanguageCode, toLanguageOptions } from "../utils/language-util.ts";
17
+ import { languagesSignal, localeSignal, uiConfigSignal } from "./signals.ts";
18
+
19
+ /** The reply last applied by registerLanguages (undefined = none yet). */
20
+ let appliedLangSource: LangSource | null | undefined = undefined;
21
+
22
+ /** true when the code is in the current language list. */
23
+ export function isLanguageListed(languageCode: string | undefined): boolean {
24
+ if (!languageCode) {
25
+ return false;
26
+ }
27
+ const languages = languagesSignal.peek();
28
+ const language = findLanguageOption(languages, languageCode);
29
+ return Boolean(language);
30
+ }
31
+
32
+ /**
33
+ * The language to switch to after a new list (when the user did not pick one): the backend isDefault,
34
+ * config.defaultLanguage, the browser / system language, "en-US", or the first one.
35
+ */
36
+ export function readLanguageAfterUpdate(source: LangSource): string | undefined {
37
+ const languages = languagesSignal.peek();
38
+ const currentCode = localeSignal.peek();
39
+ const isCurrentListed = isLanguageListed(currentCode);
40
+ const isChosen = readIsLanguageChosen();
41
+ if (isCurrentListed && isChosen) {
42
+ return undefined;
43
+ }
44
+ const backendDefault = readDefaultLanguageCode(source);
45
+ const config = uiConfigSignal.peek();
46
+ const browserLanguage = readBrowserLanguage();
47
+ const fallbackLanguage = readFallbackLanguage(config);
48
+ const firstLanguage = languages[0];
49
+ const candidates = [backendDefault, config?.defaultLanguage, browserLanguage, fallbackLanguage, firstLanguage?.code];
50
+ for (const candidate of candidates) {
51
+ const isListed = isLanguageListed(candidate);
52
+ if (isListed) {
53
+ return candidate === currentCode ? undefined : candidate;
54
+ }
55
+ }
56
+ return undefined;
57
+ }
58
+
59
+ /** Shows the backend languages in the switchers and TypeLang, and switches language when needed. */
60
+ export function setLanguages(source: LangSource): void {
61
+ appliedLangSource = source;
62
+ const languages = toLanguageOptions(source);
63
+ languagesSignal.value = languages;
64
+ const nextCode = readLanguageAfterUpdate(source);
65
+ if (nextCode) {
66
+ void applyLanguage(nextCode, false);
67
+ }
68
+ }
69
+
70
+ /**
71
+ * Used by the config loaders (and tests). Applies the value only when it changed.
72
+ * undefined / null -> keep config.languages (or no list yet); texts of config.defaultLanguage still load
73
+ * reply / list -> show it (a new reply replaces the list)
74
+ */
75
+ export function registerLanguages(source: LangSource | null | undefined): void {
76
+ if (source === undefined || source === null || source === appliedLangSource) {
77
+ return;
78
+ }
79
+ setLanguages(source);
80
+ }
81
+
82
+ /** Forgets the applied reply so the next registerLanguages() applies it again (used when the config changes). */
83
+ export function forgetAppliedLanguages(): void {
84
+ appliedLangSource = undefined;
85
+ }
@@ -0,0 +1,40 @@
1
+ // layout-choice-service.ts
2
+ // Which app layout the user picked — for a shell with microfrontends, where the settings MFE offers the choice and
3
+ // the shell renders the layout:
4
+ // "app" AppLayout: header + menu (sidebar or mega menu)
5
+ // "aside" AsideLayout: menu only, no header, no mega menu
6
+ //
7
+ // changeLayoutChoice("aside"); // saves ORG-LAYOUT_CHOICE (localStorage) and fires PREFERENCE_EVENT
8
+ // layoutChoiceSignal.value // "app" | "aside" — every copy of the library on the page follows at once
9
+ //
10
+ // The provider reads the saved choice on mount; preference-sync.ts follows later changes (same tab and other tabs).
11
+ // An MFE has no layout of its own: it reads layoutChoiceSignal to know whether the shell shows a header.
12
+
13
+ import { signal } from "@preact/signals-react";
14
+ import { AppStorage } from "../utils/app-storage.ts";
15
+ import { LAYOUT_CHOICE } from "../utils/storage-keys.ts";
16
+
17
+ export type LayoutChoice = "app" | "aside";
18
+
19
+ /** The current layout choice ("app" until a saved one is read). */
20
+ export const layoutChoiceSignal = signal<LayoutChoice>("app");
21
+
22
+ /** "aside" stays "aside"; anything else (nothing saved, an old value) is "app". */
23
+ export function toLayoutChoice(value: string | null | undefined): LayoutChoice {
24
+ return value === "aside" ? "aside" : "app";
25
+ }
26
+
27
+ /** Reads the saved choice into layoutChoiceSignal (not saved again). */
28
+ export function applySavedLayoutChoice(): void {
29
+ const savedValue = AppStorage.getText(LAYOUT_CHOICE);
30
+ const choice = toLayoutChoice(savedValue);
31
+ if (choice !== layoutChoiceSignal.peek()) {
32
+ layoutChoiceSignal.value = choice;
33
+ }
34
+ }
35
+
36
+ /** Picks a layout: saved as LAYOUT_CHOICE; the shell and every MFE on the page follow at once. */
37
+ export function changeLayoutChoice(choice: LayoutChoice): void {
38
+ layoutChoiceSignal.value = choice;
39
+ AppStorage.setData(LAYOUT_CHOICE, choice);
40
+ }
@@ -0,0 +1,67 @@
1
+ // menu-service.ts
2
+ // Menus that come from the backend at runtime, separate from config.ts.
3
+ //
4
+ // config.loadMenuNavigation: "/app-api/menu-access" // the provider calls it after sign in
5
+ // setMenu(menuResponse); // or call it yourself, for example after login
6
+ // setMenuLoading(); // sidebar shows a skeleton until setMenu()
7
+ //
8
+ // menuResponse is the backend reply { data: [...], meta } or only the list. Options come from config.navOptions.
9
+
10
+ import type { MenuOptions, MenuSource } from "../interfaces/app-types.ts";
11
+ import { toNavigation } from "../utils/menu-util.ts";
12
+ import { setNavigation, setNavigationLoading } from "./navigation-service.ts";
13
+ import { uiConfigSignal } from "./signals.ts";
14
+
15
+ /** The menu reply last applied by registerMenu (undefined = none yet). */
16
+ let appliedMenuSource: MenuSource | null | undefined = undefined;
17
+
18
+ /** Reads the menu options from config.navOptions. */
19
+ export function readMenuOptions(): MenuOptions {
20
+ const config = uiConfigSignal.peek();
21
+ return config?.navOptions ?? {};
22
+ }
23
+
24
+ /** Shows the backend menu: converts the reply into navigation items and hides the menu skeleton. */
25
+ export function setMenu(source: MenuSource, options?: MenuOptions): void {
26
+ appliedMenuSource = source;
27
+ const menuOptions = options ?? readMenuOptions();
28
+ const navItems = toNavigation(source, menuOptions);
29
+ setNavigation(navItems);
30
+ setNavigationLoading(false);
31
+ }
32
+
33
+ /** Shows the menu skeleton until setMenu() is called. */
34
+ export function setMenuLoading(): void {
35
+ appliedMenuSource = null;
36
+ setNavigationLoading(true);
37
+ }
38
+
39
+ /** Removes the backend menu (for example on logout). */
40
+ export function clearMenu(): void {
41
+ setNavigation([]);
42
+ setNavigationLoading(false);
43
+ appliedMenuSource = undefined;
44
+ }
45
+
46
+ /**
47
+ * Used by the config loaders (and tests). Applies the value only when it changed.
48
+ * undefined -> use config.navigation
49
+ * null -> still loading: menu skeleton (typical first value before the API answers)
50
+ * reply / list -> show it (a new reply object later replaces the menu)
51
+ * Tip: on an API error pass [] (empty menu) instead of leaving null, or the skeleton stays.
52
+ */
53
+ export function registerMenu(source: MenuSource | null | undefined): void {
54
+ if (source === undefined || source === appliedMenuSource) {
55
+ return;
56
+ }
57
+ if (source === null) {
58
+ setMenuLoading();
59
+ return;
60
+ }
61
+ setMenu(source);
62
+ }
63
+
64
+ /** Forgets the applied reply so the next registerMenu() applies it again (used when the config changes). */
65
+ export function forgetAppliedMenu(): void {
66
+ appliedMenuSource = undefined;
67
+ }
@@ -0,0 +1,160 @@
1
+ // navigation-service.ts
2
+ // Navigation state: menu items, navigation mode, collapsed rail and mega menu.
3
+ // The current page is the ?page query parameter (see query/query-param.ts).
4
+ //
5
+ // setNavigation(menusFromApi); // replace the config menus at runtime (role based menus)
6
+ // setNavigationLoading(true); // sidebar shows a skeleton
7
+ // changeNavigationMode("megamenu"); // switch layout, saved to localStorage
8
+
9
+ import type { MouseEvent } from "react";
10
+ import { ConstValue } from "dff-util";
11
+ import type { NavItem, NavigationMode, UiConfig } from "../interfaces/ui-config.ts";
12
+ import {
13
+ isMenuVisibleSignal,
14
+ isSidebarCollapsedSignal,
15
+ isSidebarOpenSignal,
16
+ navigationLoadingSignal,
17
+ navigationModeSignal,
18
+ navigationSignal,
19
+ openMegaMenuIdSignal,
20
+ railFlyoutSignal,
21
+ } from "./signals.ts";
22
+ import { AppStorage } from "../utils/app-storage.ts";
23
+ import { MENU_MODE, SIDEBAR_COLLAPSED } from "../utils/storage-keys.ts";
24
+
25
+ /** Replaces the navigation items, for example with menus loaded from the backend. */
26
+ export function setNavigation(items: NavItem[]): void {
27
+ navigationSignal.value = items;
28
+ }
29
+
30
+ /** Shows or hides the menu skeleton while menus load. */
31
+ export function setNavigationLoading(isLoading: boolean): void {
32
+ navigationLoadingSignal.value = isLoading;
33
+ }
34
+
35
+ /** true when the user may see this item (permissions.read is not false). */
36
+ export function isNavItemVisible(item: NavItem): boolean {
37
+ const canRead = item.permissions?.read ?? true;
38
+ return canRead;
39
+ }
40
+
41
+ /** Returns only the items the user may read, also inside groups. Empty groups are removed. */
42
+ export function filterVisibleNavigation(items: NavItem[]): NavItem[] {
43
+ const visibleItems: NavItem[] = [];
44
+ for (const item of items) {
45
+ const isVisible = isNavItemVisible(item);
46
+ if (!isVisible) {
47
+ continue;
48
+ }
49
+ if (!item.children) {
50
+ visibleItems.push(item);
51
+ continue;
52
+ }
53
+ const visibleChildren = filterVisibleNavigation(item.children);
54
+ if (visibleChildren.length === 0 && !item.path) {
55
+ continue;
56
+ }
57
+ const visibleGroup: NavItem = { ...item, children: visibleChildren };
58
+ visibleItems.push(visibleGroup);
59
+ }
60
+ return visibleItems;
61
+ }
62
+
63
+ /** Switches between "sidebar" and "megamenu" and remembers the choice. */
64
+ export function changeNavigationMode(mode: NavigationMode): void {
65
+ navigationModeSignal.value = mode;
66
+ closeMegaMenu();
67
+ closeRailFlyout();
68
+ AppStorage.setData(MENU_MODE, mode);
69
+ }
70
+
71
+ /** Collapses or expands the desktop sidebar rail and remembers it. */
72
+ export function toggleSidebarCollapsed(): void {
73
+ const isCollapsed = isSidebarCollapsedSignal.value;
74
+ const nextValue = !isCollapsed;
75
+ isSidebarCollapsedSignal.value = nextValue;
76
+ closeRailFlyout();
77
+ const storedValue = String(nextValue);
78
+ AppStorage.setData(SIDEBAR_COLLAPSED, storedValue);
79
+ }
80
+
81
+ /** Reads the saved navigation mode, or the config value. */
82
+ export function readInitialNavigationMode(config: UiConfig): NavigationMode {
83
+ const storedMode = AppStorage.getText(MENU_MODE);
84
+ if (storedMode === "sidebar" || storedMode === "megamenu") {
85
+ return storedMode;
86
+ }
87
+ return config.layout?.menuMode ?? "sidebar";
88
+ }
89
+
90
+ /** Sets navigation items, mode and collapsed state from the config and localStorage. */
91
+ export function initializeNavigation(config: UiConfig): void {
92
+ navigationSignal.value = config.navigation ?? [];
93
+ navigationModeSignal.value = readInitialNavigationMode(config);
94
+ const storedCollapsed = AppStorage.getText(SIDEBAR_COLLAPSED);
95
+ const isCollapsible = config.layout?.isSidebarCollapsible ?? true;
96
+ isSidebarCollapsedSignal.value = isCollapsible && storedCollapsed === ConstValue.TRUE;
97
+ isMenuVisibleSignal.value = config.layout?.showMenu ?? true;
98
+ }
99
+
100
+ // ---- Menu on / off ----
101
+
102
+ /**
103
+ * Shows or hides the whole menu at runtime (sidebar + rail, or the mega menu bar, and the menu buttons):
104
+ * setMenuVisible(false); // for example a full-screen page, a kiosk view or a user without menu rights
105
+ * setMenuVisible(true);
106
+ */
107
+ export function setMenuVisible(isVisible: boolean): void {
108
+ isMenuVisibleSignal.value = isVisible;
109
+ if (!isVisible) {
110
+ closeAllMenus();
111
+ }
112
+ }
113
+
114
+ /** Switches the menu on / off. */
115
+ export function toggleMenuVisible(): void {
116
+ const isVisible = isMenuVisibleSignal.value;
117
+ setMenuVisible(!isVisible);
118
+ }
119
+
120
+ // ---- Mega menu ----
121
+
122
+ /** Opens the mega menu group stored in data-menu-id, or closes it when it is already open. */
123
+ export function handleMegaMenuTriggerClick(event: MouseEvent<HTMLElement>): void {
124
+ const trigger = event.currentTarget;
125
+ const menuId = trigger.dataset.menuId ?? ConstValue.EMPTY;
126
+ const isAlreadyOpen = openMegaMenuIdSignal.value === menuId;
127
+ openMegaMenuIdSignal.value = isAlreadyOpen ? ConstValue.EMPTY : menuId;
128
+ }
129
+
130
+ /** Closes the mega menu. */
131
+ export function closeMegaMenu(): void {
132
+ openMegaMenuIdSignal.value = ConstValue.EMPTY;
133
+ }
134
+
135
+ // ---- Collapsed rail flyout ----
136
+
137
+ /** Opens the flyout of the rail group stored in data-menu-id, next to the clicked button. */
138
+ export function handleRailGroupClick(event: MouseEvent<HTMLElement>): void {
139
+ const button = event.currentTarget;
140
+ const groupId = button.dataset.menuId ?? ConstValue.EMPTY;
141
+ const isAlreadyOpen = railFlyoutSignal.value.groupId === groupId;
142
+ if (isAlreadyOpen) {
143
+ closeRailFlyout();
144
+ return;
145
+ }
146
+ const buttonRect = button.getBoundingClientRect();
147
+ railFlyoutSignal.value = { groupId: groupId, top: buttonRect.top };
148
+ }
149
+
150
+ /** Closes the rail flyout. */
151
+ export function closeRailFlyout(): void {
152
+ railFlyoutSignal.value = { groupId: ConstValue.EMPTY, top: 0 };
153
+ }
154
+
155
+ /** Closes every open menu: drawer, mega menu and rail flyout. Used after a link click. */
156
+ export function closeAllMenus(): void {
157
+ isSidebarOpenSignal.value = false;
158
+ closeMegaMenu();
159
+ closeRailFlyout();
160
+ }
@@ -0,0 +1,101 @@
1
+ // preference-sync.ts
2
+ // Keeps the theme, language, menu mode and layout choice the same in every copy of the library on the page — for microfrontends,
3
+ // where each MFE bundles its own shared-lib-web — and in other tabs.
4
+ //
5
+ // AppStorage.setData(THEME | LANG, ...) -> fires window event PREFERENCE_EVENT (same tab, storage-keys.ts)
6
+ // another tab saves THEME | LANG -> the browser fires a "storage" event
7
+ // every provider listens to both and applies the saved value without saving it again (no event loop).
8
+
9
+ import { applyLanguage } from "../i18n/locale-service.ts";
10
+ import { isKnownTheme } from "../theme/theme-service.ts";
11
+ import { AppStorage, readPrefixedKey } from "../utils/app-storage.ts";
12
+ import { LANG, LAYOUT_CHOICE, MENU_MODE, PREFERENCE_EVENT, THEME } from "../utils/storage-keys.ts";
13
+ import { applySavedLayoutChoice } from "./layout-choice-service.ts";
14
+ import { localeSignal, navigationModeSignal, themeSignal, uiConfigSignal } from "./signals.ts";
15
+
16
+ let isPreferenceSyncStarted = false;
17
+
18
+ /** Applies the saved theme when it differs (not saved again). */
19
+ export function applySavedTheme(): void {
20
+ const config = uiConfigSignal.peek();
21
+ const savedTheme = AppStorage.getText(THEME);
22
+ if (!config || !savedTheme || savedTheme === themeSignal.peek()) {
23
+ return;
24
+ }
25
+ const isKnown = isKnownTheme(config, savedTheme);
26
+ if (isKnown) {
27
+ themeSignal.value = savedTheme;
28
+ }
29
+ }
30
+
31
+ /** Applies the saved language when it differs (not saved again). */
32
+ export function applySavedLanguage(): void {
33
+ const savedLanguage = AppStorage.getText(LANG);
34
+ if (!savedLanguage || savedLanguage === localeSignal.peek()) {
35
+ return;
36
+ }
37
+ void applyLanguage(savedLanguage, false);
38
+ }
39
+
40
+ /** Applies the saved menu mode ("sidebar" / "megamenu") when it differs (not saved again). */
41
+ export function applySavedMenuMode(): void {
42
+ const savedMode = AppStorage.getText(MENU_MODE);
43
+ const isKnownMode = savedMode === "sidebar" || savedMode === "megamenu";
44
+ if (isKnownMode && savedMode !== navigationModeSignal.peek()) {
45
+ navigationModeSignal.value = savedMode;
46
+ }
47
+ }
48
+
49
+ /** Applies the preference named by the key ("THEME", "LANG", "MENU_MODE" or "LAYOUT_CHOICE"). */
50
+ export function applySavedPreference(key: string): void {
51
+ if (key === THEME) {
52
+ applySavedTheme();
53
+ }
54
+ if (key === LANG) {
55
+ applySavedLanguage();
56
+ }
57
+ if (key === MENU_MODE) {
58
+ applySavedMenuMode();
59
+ }
60
+ if (key === LAYOUT_CHOICE) {
61
+ applySavedLayoutChoice();
62
+ }
63
+ }
64
+
65
+ /** Same tab: another library copy (or this one) saved a preference. */
66
+ export function handlePreferenceEvent(event: Event): void {
67
+ const detail = (event as CustomEvent<{ key?: string }>).detail;
68
+ const key = detail?.key ?? "";
69
+ applySavedPreference(key);
70
+ }
71
+
72
+ /** Other tab: localStorage changed. */
73
+ export function handleStorageEvent(event: StorageEvent): void {
74
+ const themeKey = readPrefixedKey(THEME);
75
+ const languageKey = readPrefixedKey(LANG);
76
+ const menuModeKey = readPrefixedKey(MENU_MODE);
77
+ const layoutChoiceKey = readPrefixedKey(LAYOUT_CHOICE);
78
+ if (event.key === themeKey) {
79
+ applySavedTheme();
80
+ }
81
+ if (event.key === languageKey) {
82
+ applySavedLanguage();
83
+ }
84
+ if (event.key === menuModeKey) {
85
+ applySavedMenuMode();
86
+ }
87
+ if (event.key === layoutChoiceKey) {
88
+ applySavedLayoutChoice();
89
+ }
90
+ }
91
+
92
+ /** Starts listening once (called by SharedWebUiProvider). */
93
+ export function startPreferenceSync(): void {
94
+ const hasWindow = typeof window !== "undefined";
95
+ if (!hasWindow || isPreferenceSyncStarted) {
96
+ return;
97
+ }
98
+ isPreferenceSyncStarted = true;
99
+ window.addEventListener(PREFERENCE_EVENT, handlePreferenceEvent);
100
+ window.addEventListener("storage", handleStorageEvent);
101
+ }
@@ -0,0 +1,18 @@
1
+ // progress-service.ts
2
+ // Thin loading bar at the top of the page while requests run.
3
+ //
4
+ // ShowProgress(true); await AppHttp.Get(url); ShowProgress(false);
5
+
6
+ import { progressSignal } from "./signals.ts";
7
+
8
+ let runningCount = 0;
9
+
10
+ /** Shows (true) or hides (false) the progress bar. Calls are counted, so parallel requests work. */
11
+ export function ShowProgress(isRunning: boolean): void {
12
+ if (isRunning) {
13
+ runningCount += 1;
14
+ } else {
15
+ runningCount = Math.max(runningCount - 1, 0);
16
+ }
17
+ progressSignal.value = runningCount > 0;
18
+ }