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,165 @@
1
+ // menu-util.ts
2
+ // Turns backend menus (MenuAccessType) into NavItem[] for the sidebar and mega menu.
3
+ //
4
+ // const navItems = toNavigation(menuResponse); // { data: [...], meta } or the plain list
5
+ // setNavigation(navItems);
6
+ //
7
+ // Usually you do not call this yourself: config.loadMenuNavigation or setMenu(menuResponse) do it.
8
+ //
9
+ // What it does:
10
+ // - accepts the full reply { data, meta } or only the list
11
+ // - moves the children of the "Root" group (for example ADMIN_ROOT) to the top level
12
+ // - sorts by priority (same priority keeps the backend order), removes active: false
13
+ // - icon names like "layout-dashboard" or "User-Round-Key" become lucide names
14
+ // - flat flags read/create/update/delete become permissions (read: false hides the item)
15
+
16
+ import { ConstValue } from "dff-util";
17
+ import type { MenuAccessType, MenuOptions, MenuSource } from "../interfaces/app-types.ts";
18
+ import type { NavItem, ScreenPermissions } from "../interfaces/ui-config.ts";
19
+ import { resolveLucideIcon } from "./lucide-icon.ts";
20
+
21
+ /** Reads permissions from the object style or the flat flag style. */
22
+ export function readMenuPermissions(menu: MenuAccessType): ScreenPermissions {
23
+ const permissions = menu.permissions;
24
+ return {
25
+ read: permissions?.read ?? menu.read ?? true,
26
+ create: permissions?.create ?? menu.create ?? true,
27
+ update: permissions?.update ?? menu.update ?? true,
28
+ delete: permissions?.delete ?? menu.delete ?? true,
29
+ };
30
+ }
31
+
32
+ /** Sort compare: lower priority first. Menus with the same priority keep the backend order. */
33
+ export function compareMenuPriority(first: MenuAccessType, second: MenuAccessType): number {
34
+ const firstPriority = first.priority ?? Number.MAX_SAFE_INTEGER;
35
+ const secondPriority = second.priority ?? Number.MAX_SAFE_INTEGER;
36
+ return firstPriority - secondPriority;
37
+ }
38
+
39
+ /** Id ending used by backend container groups, for example "ADMIN_ROOT". */
40
+ export const ROOT_MENU_ID_SUFFIX = "_ROOT";
41
+
42
+ /** Name used by backend container groups. */
43
+ export const ROOT_MENU_NAME = "root";
44
+
45
+ /** Returns the active menus sorted by priority (a new list, the input is not changed). */
46
+ export function sortActiveMenus(menus: MenuAccessType[]): MenuAccessType[] {
47
+ const activeMenus: MenuAccessType[] = [];
48
+ for (const menu of menus) {
49
+ if (menu.active !== false) {
50
+ activeMenus.push(menu);
51
+ }
52
+ }
53
+ activeMenus.sort(compareMenuPriority);
54
+ return activeMenus;
55
+ }
56
+
57
+ /** Converts one backend menu (and its children) into a NavItem. */
58
+ export function toNavItem(menu: MenuAccessType): NavItem {
59
+ const itemId = menu.id ?? menu.menuId ?? menu.href ?? menu.name;
60
+ const permissions = readMenuPermissions(menu);
61
+ const childMenus = menu.children ?? [];
62
+ const children = toNavItems(childMenus);
63
+ const navItem: NavItem = {
64
+ id: itemId,
65
+ labelKey: menu.name,
66
+ labelLang: menu.nameLang,
67
+ descriptionKey: menu.description,
68
+ path: menu.href || undefined,
69
+ icon: menu.icon ? resolveLucideIcon(menu.icon) : undefined,
70
+ permissions: permissions,
71
+ };
72
+ if (children.length > 0) {
73
+ navItem.children = children;
74
+ }
75
+ return navItem;
76
+ }
77
+
78
+ /** Converts backend menus into NavItem[]: inactive menus removed, sorted by priority. */
79
+ export function toNavItems(menus: MenuAccessType[]): NavItem[] {
80
+ const activeMenus = sortActiveMenus(menus);
81
+ const navItems: NavItem[] = [];
82
+ for (const menu of activeMenus) {
83
+ const navItem = toNavItem(menu);
84
+ navItems.push(navItem);
85
+ }
86
+ return navItems;
87
+ }
88
+
89
+ /**
90
+ * Some backends wrap all menus in one container menu (for example id "ADMIN_ROOT").
91
+ * Returns the children of that container, or the menus unchanged when it is not there.
92
+ */
93
+ export function unwrapRootMenu(menus: MenuAccessType[], rootMenuId: string): MenuAccessType[] {
94
+ for (const menu of menus) {
95
+ const menuId = menu.id ?? menu.menuId;
96
+ if (menuId === rootMenuId) {
97
+ return menu.children ?? [];
98
+ }
99
+ }
100
+ return menus;
101
+ }
102
+
103
+ /** Reads the menu list from the backend reply ({ data: [...] }) or returns the list itself. */
104
+ export function readMenuRows(source: MenuSource | null | undefined): MenuAccessType[] {
105
+ if (!source) {
106
+ return [];
107
+ }
108
+ const isList = Array.isArray(source);
109
+ if (isList) {
110
+ return source;
111
+ }
112
+ return source.data ?? [];
113
+ }
114
+
115
+ /** true when the menu is a container group whose children belong at the top level. */
116
+ export function isRootMenu(menu: MenuAccessType, options: MenuOptions = {}): boolean {
117
+ const menuId = menu.id ?? menu.menuId ?? ConstValue.EMPTY;
118
+ const rootMenuIds = options.rootMenuIds;
119
+ if (rootMenuIds) {
120
+ return rootMenuIds.includes(menuId);
121
+ }
122
+ const menuName = menu.name ?? ConstValue.EMPTY;
123
+ const lowerName = menuName.toLowerCase();
124
+ const isNamedRoot = lowerName === ROOT_MENU_NAME;
125
+ const hasRootId = menuId.endsWith(ROOT_MENU_ID_SUFFIX);
126
+ return isNamedRoot || hasRootId;
127
+ }
128
+
129
+ /**
130
+ * Replaces root groups by their children, in the place of the group.
131
+ * [Root(Dashboard, Products), Administrator, Settings] -> [Dashboard, Products, Administrator, Settings]
132
+ */
133
+ export function flattenRootMenus(menus: MenuAccessType[], options: MenuOptions = {}): MenuAccessType[] {
134
+ const sortedMenus = sortActiveMenus(menus);
135
+ const isFlattened = options.isRootFlattened ?? true;
136
+ if (!isFlattened) {
137
+ return sortedMenus;
138
+ }
139
+ const flatMenus: MenuAccessType[] = [];
140
+ for (const menu of sortedMenus) {
141
+ const isRoot = isRootMenu(menu, options);
142
+ if (!isRoot) {
143
+ flatMenus.push(menu);
144
+ continue;
145
+ }
146
+ const rootChildren = menu.children ?? [];
147
+ const sortedChildren = sortActiveMenus(rootChildren);
148
+ for (const childMenu of sortedChildren) {
149
+ flatMenus.push(childMenu);
150
+ }
151
+ }
152
+ return flatMenus;
153
+ }
154
+
155
+ /** Converts a backend menu reply (or list) into the navigation items the shell shows. */
156
+ export function toNavigation(source: MenuSource | null | undefined, options: MenuOptions = {}): NavItem[] {
157
+ const menuRows = readMenuRows(source);
158
+ const flatMenus = flattenRootMenus(menuRows, options);
159
+ const navItems: NavItem[] = [];
160
+ for (const menu of flatMenus) {
161
+ const navItem = toNavItem(menu);
162
+ navItems.push(navItem);
163
+ }
164
+ return navItems;
165
+ }
@@ -0,0 +1,108 @@
1
+ // option-util.ts
2
+ // Ready-made OptionType lists from dff-util data, for TypeSelect / TypeList / TypeFilter.
3
+ //
4
+ // const countryOptions = readCountryOptions(); // 🇮🇳 India ...
5
+ // const telCodeOptions = readTelCodeOptions(); // 🇮🇳 +91 ...
6
+ // const languageOptions = readLanguageOptions(); // हिन्दी (Hindi) ...
7
+
8
+ import { Countries, languages, type OptionType } from "dff-util";
9
+
10
+ /** One option per country: key = country code ("IN"), label = name, icon = flag. */
11
+ export function readCountryOptions(): OptionType[] {
12
+ const options: OptionType[] = [];
13
+ for (const country of Countries) {
14
+ const option: OptionType = { key: country.code, label: country.name, icon: country.flag };
15
+ options.push(option);
16
+ }
17
+ return options;
18
+ }
19
+
20
+ /**
21
+ * One option per country phone code (optionally only the given country codes, for example ["CA", "US"]): key = country code ("IN"), label = "+91 India", icon = flag.
22
+ * The key is the country code because several countries share a phone code (+1). Read the number with readTelCode("IN").
23
+ */
24
+ export function readTelCodeOptions(countryCodes: string[] = []): OptionType[] {
25
+ const options: OptionType[] = [];
26
+ const hasFilter = countryCodes.length > 0;
27
+ for (const country of Countries) {
28
+ const isWanted = !hasFilter || countryCodes.includes(country.code);
29
+ if (!isWanted) {
30
+ continue;
31
+ }
32
+ const telCode = `+${country.telCode}`;
33
+ const option: OptionType = { key: country.code, label: `${telCode} ${country.name}`, icon: country.flag };
34
+ options.push(option);
35
+ }
36
+ return options;
37
+ }
38
+
39
+ /** One option per language: key = "hi-IN", label = "हिन्दी (Hindi)". */
40
+ export function readLanguageOptions(): OptionType[] {
41
+ const options: OptionType[] = [];
42
+ for (const language of languages) {
43
+ const option: OptionType = { key: language.lang, label: `${language.locale} (${language.name})` };
44
+ options.push(option);
45
+ }
46
+ return options;
47
+ }
48
+
49
+ /** Phone code of a country: readTelCode("IN") -> "+91". Empty text when unknown. */
50
+ export function readTelCode(countryCode: string): string {
51
+ for (const country of Countries) {
52
+ if (country.code === countryCode) {
53
+ return `+${country.telCode}`;
54
+ }
55
+ }
56
+ return "";
57
+ }
58
+
59
+ /** Reads the first text-like field from a record. */
60
+ function readFirstText(record: Record<string, unknown>, fieldNames: string[]): string {
61
+ for (const fieldName of fieldNames) {
62
+ const fieldValue = record[fieldName];
63
+ const isText = typeof fieldValue === "string" || typeof fieldValue === "number";
64
+ if (isText && String(fieldValue).length > 0) {
65
+ return String(fieldValue);
66
+ }
67
+ }
68
+ return "";
69
+ }
70
+
71
+ /**
72
+ * Turns backend rows (AppHttp.Load results) into OptionType[].
73
+ * key: key | value | code | id label: label | name | value lang: nameLang | labelLang
74
+ * Rows with active === false are skipped.
75
+ */
76
+ export function toOptionTypes(rows: unknown[]): OptionType[] {
77
+ const options: OptionType[] = [];
78
+ for (const row of rows) {
79
+ if (!row || typeof row !== "object") {
80
+ continue;
81
+ }
82
+ const record = row as Record<string, unknown>;
83
+ if (record.active === false) {
84
+ continue;
85
+ }
86
+ const key = readFirstText(record, ["key", "value", "code", "id"]);
87
+ const label = readFirstText(record, ["label", "name", "value", "key"]);
88
+ const langValue = record.nameLang ?? record.labelLang;
89
+ const lang = langValue && typeof langValue === "object" ? (langValue as Record<string, string>) : undefined;
90
+ const option: OptionType = { key: key, label: label, disabled: record.disabled === true, lang: lang };
91
+ options.push(option);
92
+ }
93
+ return options;
94
+ }
95
+
96
+ /** Reads the row list of a response: response.data (array) or the response itself (array). */
97
+ export function readResponseRows(response: unknown): unknown[] {
98
+ if (Array.isArray(response)) {
99
+ return response;
100
+ }
101
+ if (response && typeof response === "object") {
102
+ const data = (response as Record<string, unknown>).data;
103
+ if (Array.isArray(data)) {
104
+ return data;
105
+ }
106
+ }
107
+ return [];
108
+ }
@@ -0,0 +1,48 @@
1
+ // session-id.ts
2
+ // One random id per browser tab, saved in sessionStorage as "<APPNAMEKEY>-ACTIVE_SESSION_ID" (ORG-ACTIVE_SESSION_ID).
3
+ // AppHttp sends it as the x-session-id header on every API request.
4
+
5
+ import { AppUUID4, ConstValue } from "dff-util";
6
+ import { AppStorage } from "./app-storage.ts";
7
+ import { ACTIVE_SESSION_ID } from "./storage-keys.ts";
8
+
9
+ /** Key of older versions (no app prefix); its value is moved to ACTIVE_SESSION_ID once. */
10
+ const OLD_SESSION_ID_KEY = "active_session_id";
11
+
12
+ /** Takes the id saved by an older version (and removes the old key), or "". */
13
+ function takeOldSessionId(): string {
14
+ const oldId = window.sessionStorage.getItem(OLD_SESSION_ID_KEY);
15
+ if (!oldId) {
16
+ return ConstValue.EMPTY;
17
+ }
18
+ window.sessionStorage.removeItem(OLD_SESSION_ID_KEY);
19
+ return oldId;
20
+ }
21
+
22
+ /** Returns the tab's session id, creating it on first use. */
23
+ export function readSessionId(): string {
24
+ const hasWindow = typeof window !== "undefined";
25
+ if (!hasWindow) {
26
+ return ConstValue.EMPTY;
27
+ }
28
+ // The old unprefixed key is always removed; its id is kept only when there is no new one yet.
29
+ const oldId = takeOldSessionId();
30
+ const storedId = AppStorage.getText(ACTIVE_SESSION_ID);
31
+ if (storedId) {
32
+ return storedId;
33
+ }
34
+ const newId = oldId || AppUUID4();
35
+ AppStorage.setData(ACTIVE_SESSION_ID, newId);
36
+ return newId;
37
+ }
38
+
39
+ /** Starts a new session id (for example after log out). */
40
+ export function resetSessionId(): string {
41
+ const hasWindow = typeof window !== "undefined";
42
+ if (!hasWindow) {
43
+ return ConstValue.EMPTY;
44
+ }
45
+ AppStorage.removeData(ACTIVE_SESSION_ID);
46
+ window.sessionStorage.removeItem(OLD_SESSION_ID_KEY);
47
+ return readSessionId();
48
+ }
@@ -0,0 +1,18 @@
1
+ // shared-regexp.ts
2
+ // dff-util RegExp plus a few patterns it does not have. Use dff-util RegExp first.
3
+ //
4
+ // pattern: { value: SharedRegExp.MOBILE_10, message: ConstKeys.INVALID_PHONE }
5
+
6
+ import { RegExp as DffRegExp } from "dff-util";
7
+
8
+ export const SharedRegExp = {
9
+ ...DffRegExp,
10
+ /** Exactly 10 digits (mobile number without country code). */
11
+ MOBILE_10: /^[0-9]{10}$/,
12
+ /** Letters and spaces only (person names). */
13
+ PERSON_NAME: /^[\p{L}\s]+$/u,
14
+ /** Letters, numbers, spaces and , ' . / - (city, state, address lines). */
15
+ ADDRESS_TEXT: /^[\p{L}0-9\s,'./-]+$/u,
16
+ /** Upper-case letters and digits (codes and ids). */
17
+ UPPER_ALPHA_NUMERIC: /^[A-Z0-9]+$/,
18
+ };
@@ -0,0 +1,15 @@
1
+ // signal-source.ts
2
+ // Config values that can be a signal (loadLocale, loadThemes, loadSupportLanguages, loadBranches, loadMenuNavigation).
3
+ // A signal is recognised by its shape (value, peek, subscribe), so a signal from another copy of the signals package
4
+ // (each microfrontend bundles its own) works too.
5
+
6
+ import type { ValueSignal } from "../interfaces/ui-config.ts";
7
+
8
+ /** true when the value is a signal (or a computed). */
9
+ export function isSignalSource(source: unknown): source is ValueSignal<unknown> {
10
+ if (typeof source !== "object" || source === null) {
11
+ return false;
12
+ }
13
+ const candidate = source as Partial<ValueSignal<unknown>>;
14
+ return typeof candidate.peek === "function" && typeof candidate.subscribe === "function" && "value" in candidate;
15
+ }
@@ -0,0 +1,86 @@
1
+ // storage-keys.ts
2
+ // The AppStorage key names shared by every app (the same names the apps used in utils/services/app.storage.ts).
3
+ // AppStorage adds config.appNameKey as prefix: LANG -> "ORG-LANG".
4
+ //
5
+ // import { AppStorage, TOKEN, BRANCH_ID } from "shared-lib-web";
6
+ // AppStorage.setData(BRANCH_ID, branchId);
7
+ // const token = AppStorage.getData(TOKEN);
8
+
9
+ /** Access token (sessionStorage). */
10
+ export const TOKEN = "TOKEN";
11
+ /** Random id of this browser tab (sessionStorage); AppHttp sends it as the x-session-id header. */
12
+ export const ACTIVE_SESSION_ID = "ACTIVE_SESSION_ID";
13
+ /** Signed-in user saved by startSession(). */
14
+ export const AUTH_USER = "AUTH_USER";
15
+ export const SESSION_INFO = "SESSION_INFO";
16
+ export const SCREEN_ACCESS = "SCREEN_ACCESS";
17
+ export const SCREEN_ACTION = "SCREEN_ACTION";
18
+ export const NAV = "NAV";
19
+ /** "true" when the user ticked "remember me" on the login form (localStorage, kept on log out). */
20
+ export const REMEMBER_ME = "REMEMBER_ME";
21
+ export const TRANS = "TRANS";
22
+ export const DIR = "DIR";
23
+ /** Language the user picked (localStorage, kept on log out). */
24
+ export const LANG = "LANG";
25
+ /** Theme the user picked (localStorage, kept on log out). */
26
+ export const THEME = "THEME";
27
+ /** Which app layout the user picked, for apps that offer a choice (localStorage, kept on log out). */
28
+ export const LAYOUT_CHOICE = "LAYOUT_CHOICE";
29
+ /** Menu mode the user picked: "sidebar" or "megamenu" (localStorage, kept on log out). */
30
+ export const MENU_MODE = "MENU_MODE";
31
+ /** "true" when the sidebar is collapsed to the icon rail (localStorage, kept on log out). */
32
+ export const SIDEBAR_COLLAPSED = "SIDEBAR_COLLAPSED";
33
+ export const OTP_ID = "OTP_ID";
34
+ /** Selected branch; AppHttp sends it as the x-branch-id header. */
35
+ export const BRANCH_ID = "BRANCH_ID";
36
+ export const BRANCH_NAME = "BRANCH_NAME";
37
+ /** Absolute cutoff (ISO) after which the JWT can no longer be regenerated. */
38
+ export const REGEN_EXPIRES_AT = "REGEN_EXPIRES_AT";
39
+
40
+ /** All key names in one object: StorageKeys.TOKEN, StorageKeys.LANG ... */
41
+ export const StorageKeys = {
42
+ TOKEN: TOKEN,
43
+ ACTIVE_SESSION_ID: ACTIVE_SESSION_ID,
44
+ AUTH_USER: AUTH_USER,
45
+ SESSION_INFO: SESSION_INFO,
46
+ SCREEN_ACCESS: SCREEN_ACCESS,
47
+ SCREEN_ACTION: SCREEN_ACTION,
48
+ NAV: NAV,
49
+ REMEMBER_ME: REMEMBER_ME,
50
+ TRANS: TRANS,
51
+ DIR: DIR,
52
+ LANG: LANG,
53
+ THEME: THEME,
54
+ LAYOUT_CHOICE: LAYOUT_CHOICE,
55
+ MENU_MODE: MENU_MODE,
56
+ SIDEBAR_COLLAPSED: SIDEBAR_COLLAPSED,
57
+ OTP_ID: OTP_ID,
58
+ BRANCH_ID: BRANCH_ID,
59
+ BRANCH_NAME: BRANCH_NAME,
60
+ REGEN_EXPIRES_AT: REGEN_EXPIRES_AT,
61
+ } as const;
62
+
63
+ /**
64
+ * The ONLY keys kept in localStorage (preferences; they survive log out and AppStorage.clearData keeps them).
65
+ * Every other key (TOKEN, AUTH_USER, NAV, TRANS, BRANCH_ID ...) lives in sessionStorage.
66
+ * A project adds its own preference keys with config.localStorageKeys.
67
+ */
68
+ export const LOCAL_STORAGE_KEYS: string[] = [LANG, THEME, LAYOUT_CHOICE, MENU_MODE, SIDEBAR_COLLAPSED, REMEMBER_ME];
69
+
70
+ /**
71
+ * Window event fired by AppStorage.setData when a localStorage preference is saved (detail = { key }).
72
+ * Every copy of the library on the page listens to it (preference-sync.ts) — useful for microfrontends.
73
+ */
74
+ export const PREFERENCE_EVENT = "shared-lib-web:preference";
75
+
76
+ /**
77
+ * Window event fired by startSession / endSession (detail = { isSignedIn, copyId }). Every OTHER copy of the library
78
+ * on the page applies it (auth-service.ts) — so a sign in inside an auth microfrontend signs the shell in too.
79
+ */
80
+ export const SESSION_EVENT = "shared-lib-web:session";
81
+
82
+ /** AppStorage prefix when config.appNameKey is missing. */
83
+ export const DEFAULT_APP_STORAGE_PREFIX = "UI";
84
+
85
+ /** Start of every window.env name: REACT_APP_ + APPNAMEKEY + _ + KEY -> REACT_APP_ORG_API_BASE_URL. */
86
+ export const ENV_NAME_START = "REACT_APP_";