shared-lib-web 0.0.0-stage → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (641) hide show
  1. package/CODING_RULES.md +118 -0
  2. package/LICENSE +21 -0
  3. package/README.md +630 -2
  4. package/dist/components/app-brand.d.ts +9 -0
  5. package/dist/components/app-brand.d.ts.map +1 -0
  6. package/dist/components/app-brand.js +23 -0
  7. package/dist/components/app-brand.js.map +1 -0
  8. package/dist/components/branch-switcher.d.ts +7 -0
  9. package/dist/components/branch-switcher.d.ts.map +1 -0
  10. package/dist/components/branch-switcher.js +37 -0
  11. package/dist/components/branch-switcher.js.map +1 -0
  12. package/dist/components/coming-soon.d.ts +6 -0
  13. package/dist/components/coming-soon.d.ts.map +1 -0
  14. package/dist/components/coming-soon.js +19 -0
  15. package/dist/components/coming-soon.js.map +1 -0
  16. package/dist/components/empty-state.d.ts +15 -0
  17. package/dist/components/empty-state.d.ts.map +1 -0
  18. package/dist/components/empty-state.js +14 -0
  19. package/dist/components/empty-state.js.map +1 -0
  20. package/dist/components/language-switcher.d.ts +8 -0
  21. package/dist/components/language-switcher.d.ts.map +1 -0
  22. package/dist/components/language-switcher.js +48 -0
  23. package/dist/components/language-switcher.js.map +1 -0
  24. package/dist/components/page-loader.d.ts +2 -0
  25. package/dist/components/page-loader.d.ts.map +1 -0
  26. package/dist/components/page-loader.js +8 -0
  27. package/dist/components/page-loader.js.map +1 -0
  28. package/dist/components/page-not-found.d.ts +2 -0
  29. package/dist/components/page-not-found.d.ts.map +1 -0
  30. package/dist/components/page-not-found.js +18 -0
  31. package/dist/components/page-not-found.js.map +1 -0
  32. package/dist/components/permission-denied.d.ts +2 -0
  33. package/dist/components/permission-denied.d.ts.map +1 -0
  34. package/dist/components/permission-denied.js +12 -0
  35. package/dist/components/permission-denied.js.map +1 -0
  36. package/dist/components/require-access.d.ts +11 -0
  37. package/dist/components/require-access.d.ts.map +1 -0
  38. package/dist/components/require-access.js +15 -0
  39. package/dist/components/require-access.js.map +1 -0
  40. package/dist/components/scroll-to-top.d.ts +12 -0
  41. package/dist/components/scroll-to-top.d.ts.map +1 -0
  42. package/dist/components/scroll-to-top.js +42 -0
  43. package/dist/components/scroll-to-top.js.map +1 -0
  44. package/dist/components/settings-menu.d.ts +17 -0
  45. package/dist/components/settings-menu.d.ts.map +1 -0
  46. package/dist/components/settings-menu.js +102 -0
  47. package/dist/components/settings-menu.js.map +1 -0
  48. package/dist/components/theme-switcher.d.ts +5 -0
  49. package/dist/components/theme-switcher.d.ts.map +1 -0
  50. package/dist/components/theme-switcher.js +33 -0
  51. package/dist/components/theme-switcher.js.map +1 -0
  52. package/dist/components/toast-container.d.ts +5 -0
  53. package/dist/components/toast-container.d.ts.map +1 -0
  54. package/dist/components/toast-container.js +51 -0
  55. package/dist/components/toast-container.js.map +1 -0
  56. package/dist/components/top-progress.d.ts +2 -0
  57. package/dist/components/top-progress.d.ts.map +1 -0
  58. package/dist/components/top-progress.js +14 -0
  59. package/dist/components/top-progress.js.map +1 -0
  60. package/dist/components/user-menu.d.ts +26 -0
  61. package/dist/components/user-menu.d.ts.map +1 -0
  62. package/dist/components/user-menu.js +85 -0
  63. package/dist/components/user-menu.js.map +1 -0
  64. package/dist/context/ui-context.d.ts +5 -0
  65. package/dist/context/ui-context.d.ts.map +1 -0
  66. package/dist/context/ui-context.js +16 -0
  67. package/dist/context/ui-context.js.map +1 -0
  68. package/dist/context/use-ui.d.ts +3 -0
  69. package/dist/context/use-ui.d.ts.map +1 -0
  70. package/dist/context/use-ui.js +39 -0
  71. package/dist/context/use-ui.js.map +1 -0
  72. package/dist/i18n/default-messages.d.ts +5 -0
  73. package/dist/i18n/default-messages.d.ts.map +1 -0
  74. package/dist/i18n/default-messages.js +64 -0
  75. package/dist/i18n/default-messages.js.map +1 -0
  76. package/dist/i18n/direction.d.ts +10 -0
  77. package/dist/i18n/direction.d.ts.map +1 -0
  78. package/dist/i18n/direction.js +35 -0
  79. package/dist/i18n/direction.js.map +1 -0
  80. package/dist/i18n/locale-service.d.ts +36 -0
  81. package/dist/i18n/locale-service.d.ts.map +1 -0
  82. package/dist/i18n/locale-service.js +163 -0
  83. package/dist/i18n/locale-service.js.map +1 -0
  84. package/dist/i18n/translator.d.ts +14 -0
  85. package/dist/i18n/translator.d.ts.map +1 -0
  86. package/dist/i18n/translator.js +81 -0
  87. package/dist/i18n/translator.js.map +1 -0
  88. package/dist/index.d.ts +106 -0
  89. package/dist/index.d.ts.map +1 -0
  90. package/dist/index.js +119 -0
  91. package/dist/index.js.map +1 -0
  92. package/dist/interfaces/app-types.d.ts +137 -0
  93. package/dist/interfaces/app-types.d.ts.map +1 -0
  94. package/dist/interfaces/app-types.js +5 -0
  95. package/dist/interfaces/app-types.js.map +1 -0
  96. package/dist/interfaces/toast.d.ts +9 -0
  97. package/dist/interfaces/toast.d.ts.map +1 -0
  98. package/dist/interfaces/toast.js +4 -0
  99. package/dist/interfaces/toast.js.map +1 -0
  100. package/dist/interfaces/ui-config.d.ts +172 -0
  101. package/dist/interfaces/ui-config.d.ts.map +1 -0
  102. package/dist/interfaces/ui-config.js +6 -0
  103. package/dist/interfaces/ui-config.js.map +1 -0
  104. package/dist/interfaces/ui-context.d.ts +37 -0
  105. package/dist/interfaces/ui-context.d.ts.map +1 -0
  106. package/dist/interfaces/ui-context.js +4 -0
  107. package/dist/interfaces/ui-context.js.map +1 -0
  108. package/dist/layout.d.ts +10 -0
  109. package/dist/layout.d.ts.map +1 -0
  110. package/dist/layout.js +22 -0
  111. package/dist/layout.js.map +1 -0
  112. package/dist/layouts/app-layout.d.ts +23 -0
  113. package/dist/layouts/app-layout.d.ts.map +1 -0
  114. package/dist/layouts/app-layout.js +52 -0
  115. package/dist/layouts/app-layout.js.map +1 -0
  116. package/dist/layouts/article-layout.d.ts +7 -0
  117. package/dist/layouts/article-layout.d.ts.map +1 -0
  118. package/dist/layouts/article-layout.js +8 -0
  119. package/dist/layouts/article-layout.js.map +1 -0
  120. package/dist/layouts/aside-layout.d.ts +27 -0
  121. package/dist/layouts/aside-layout.d.ts.map +1 -0
  122. package/dist/layouts/aside-layout.js +70 -0
  123. package/dist/layouts/aside-layout.js.map +1 -0
  124. package/dist/layouts/auth-layout.d.ts +7 -0
  125. package/dist/layouts/auth-layout.d.ts.map +1 -0
  126. package/dist/layouts/auth-layout.js +20 -0
  127. package/dist/layouts/auth-layout.js.map +1 -0
  128. package/dist/layouts/content-layout.d.ts +3 -0
  129. package/dist/layouts/content-layout.d.ts.map +1 -0
  130. package/dist/layouts/content-layout.js +10 -0
  131. package/dist/layouts/content-layout.js.map +1 -0
  132. package/dist/layouts/float-layout.d.ts +3 -0
  133. package/dist/layouts/float-layout.d.ts.map +1 -0
  134. package/dist/layouts/float-layout.js +10 -0
  135. package/dist/layouts/float-layout.js.map +1 -0
  136. package/dist/layouts/grid-layout.d.ts +3 -0
  137. package/dist/layouts/grid-layout.d.ts.map +1 -0
  138. package/dist/layouts/grid-layout.js +10 -0
  139. package/dist/layouts/grid-layout.js.map +1 -0
  140. package/dist/layouts/head-layout.d.ts +16 -0
  141. package/dist/layouts/head-layout.d.ts.map +1 -0
  142. package/dist/layouts/head-layout.js +36 -0
  143. package/dist/layouts/head-layout.js.map +1 -0
  144. package/dist/layouts/header.d.ts +18 -0
  145. package/dist/layouts/header.d.ts.map +1 -0
  146. package/dist/layouts/header.js +26 -0
  147. package/dist/layouts/header.js.map +1 -0
  148. package/dist/layouts/layout-constants.d.ts +3 -0
  149. package/dist/layouts/layout-constants.d.ts.map +1 -0
  150. package/dist/layouts/layout-constants.js +5 -0
  151. package/dist/layouts/layout-constants.js.map +1 -0
  152. package/dist/layouts/mega-menu.d.ts +3 -0
  153. package/dist/layouts/mega-menu.d.ts.map +1 -0
  154. package/dist/layouts/mega-menu.js +104 -0
  155. package/dist/layouts/mega-menu.js.map +1 -0
  156. package/dist/layouts/navigation.d.ts +11 -0
  157. package/dist/layouts/navigation.d.ts.map +1 -0
  158. package/dist/layouts/navigation.js +41 -0
  159. package/dist/layouts/navigation.js.map +1 -0
  160. package/dist/layouts/rail-flyout.d.ts +5 -0
  161. package/dist/layouts/rail-flyout.d.ts.map +1 -0
  162. package/dist/layouts/rail-flyout.js +49 -0
  163. package/dist/layouts/rail-flyout.js.map +1 -0
  164. package/dist/layouts/rail-tooltip.d.ts +8 -0
  165. package/dist/layouts/rail-tooltip.d.ts.map +1 -0
  166. package/dist/layouts/rail-tooltip.js +60 -0
  167. package/dist/layouts/rail-tooltip.js.map +1 -0
  168. package/dist/layouts/sidebar.d.ts +38 -0
  169. package/dist/layouts/sidebar.d.ts.map +1 -0
  170. package/dist/layouts/sidebar.js +137 -0
  171. package/dist/layouts/sidebar.js.map +1 -0
  172. package/dist/markdown.d.ts +4 -0
  173. package/dist/markdown.d.ts.map +1 -0
  174. package/dist/markdown.js +12 -0
  175. package/dist/markdown.js.map +1 -0
  176. package/dist/providers/provider-effects.d.ts +9 -0
  177. package/dist/providers/provider-effects.d.ts.map +1 -0
  178. package/dist/providers/provider-effects.js +26 -0
  179. package/dist/providers/provider-effects.js.map +1 -0
  180. package/dist/providers/register-config.d.ts +4 -0
  181. package/dist/providers/register-config.d.ts.map +1 -0
  182. package/dist/providers/register-config.js +28 -0
  183. package/dist/providers/register-config.js.map +1 -0
  184. package/dist/providers/shared-web-ui-provider.d.ts +31 -0
  185. package/dist/providers/shared-web-ui-provider.d.ts.map +1 -0
  186. package/dist/providers/shared-web-ui-provider.js +54 -0
  187. package/dist/providers/shared-web-ui-provider.js.map +1 -0
  188. package/dist/providers/theme-provider.d.ts +6 -0
  189. package/dist/providers/theme-provider.d.ts.map +1 -0
  190. package/dist/providers/theme-provider.js +11 -0
  191. package/dist/providers/theme-provider.js.map +1 -0
  192. package/dist/providers/translation-provider.d.ts +8 -0
  193. package/dist/providers/translation-provider.d.ts.map +1 -0
  194. package/dist/providers/translation-provider.js +21 -0
  195. package/dist/providers/translation-provider.js.map +1 -0
  196. package/dist/query/page-link.d.ts +20 -0
  197. package/dist/query/page-link.d.ts.map +1 -0
  198. package/dist/query/page-link.js +53 -0
  199. package/dist/query/page-link.js.map +1 -0
  200. package/dist/query/page-path.d.ts +5 -0
  201. package/dist/query/page-path.d.ts.map +1 -0
  202. package/dist/query/page-path.js +24 -0
  203. package/dist/query/page-path.js.map +1 -0
  204. package/dist/query/query-param.d.ts +63 -0
  205. package/dist/query/query-param.d.ts.map +1 -0
  206. package/dist/query/query-param.js +215 -0
  207. package/dist/query/query-param.js.map +1 -0
  208. package/dist/query/use-query-param.d.ts +5 -0
  209. package/dist/query/use-query-param.d.ts.map +1 -0
  210. package/dist/query/use-query-param.js +21 -0
  211. package/dist/query/use-query-param.js.map +1 -0
  212. package/dist/skeleton/skeleton-article.d.ts +2 -0
  213. package/dist/skeleton/skeleton-article.d.ts.map +1 -0
  214. package/dist/skeleton/skeleton-article.js +7 -0
  215. package/dist/skeleton/skeleton-article.js.map +1 -0
  216. package/dist/skeleton/skeleton-auth-form.d.ts +6 -0
  217. package/dist/skeleton/skeleton-auth-form.d.ts.map +1 -0
  218. package/dist/skeleton/skeleton-auth-form.js +9 -0
  219. package/dist/skeleton/skeleton-auth-form.js.map +1 -0
  220. package/dist/skeleton/skeleton-cards.d.ts +6 -0
  221. package/dist/skeleton/skeleton-cards.d.ts.map +1 -0
  222. package/dist/skeleton/skeleton-cards.js +16 -0
  223. package/dist/skeleton/skeleton-cards.js.map +1 -0
  224. package/dist/skeleton/skeleton-chat.d.ts +2 -0
  225. package/dist/skeleton/skeleton-chat.d.ts.map +1 -0
  226. package/dist/skeleton/skeleton-chat.js +17 -0
  227. package/dist/skeleton/skeleton-chat.js.map +1 -0
  228. package/dist/skeleton/skeleton-dashboard.d.ts +2 -0
  229. package/dist/skeleton/skeleton-dashboard.d.ts.map +1 -0
  230. package/dist/skeleton/skeleton-dashboard.js +16 -0
  231. package/dist/skeleton/skeleton-dashboard.js.map +1 -0
  232. package/dist/skeleton/skeleton-float.d.ts +2 -0
  233. package/dist/skeleton/skeleton-float.d.ts.map +1 -0
  234. package/dist/skeleton/skeleton-float.js +7 -0
  235. package/dist/skeleton/skeleton-float.js.map +1 -0
  236. package/dist/skeleton/skeleton-form.d.ts +10 -0
  237. package/dist/skeleton/skeleton-form.d.ts.map +1 -0
  238. package/dist/skeleton/skeleton-form.js +16 -0
  239. package/dist/skeleton/skeleton-form.js.map +1 -0
  240. package/dist/skeleton/skeleton-menu.d.ts +2 -0
  241. package/dist/skeleton/skeleton-menu.d.ts.map +1 -0
  242. package/dist/skeleton/skeleton-menu.js +16 -0
  243. package/dist/skeleton/skeleton-menu.js.map +1 -0
  244. package/dist/skeleton/skeleton-page.d.ts +2 -0
  245. package/dist/skeleton/skeleton-page.d.ts.map +1 -0
  246. package/dist/skeleton/skeleton-page.js +9 -0
  247. package/dist/skeleton/skeleton-page.js.map +1 -0
  248. package/dist/skeleton/skeleton-table.d.ts +2 -0
  249. package/dist/skeleton/skeleton-table.d.ts.map +1 -0
  250. package/dist/skeleton/skeleton-table.js +16 -0
  251. package/dist/skeleton/skeleton-table.js.map +1 -0
  252. package/dist/state/auth-service.d.ts +28 -0
  253. package/dist/state/auth-service.d.ts.map +1 -0
  254. package/dist/state/auth-service.js +92 -0
  255. package/dist/state/auth-service.js.map +1 -0
  256. package/dist/state/branch-service.d.ts +42 -0
  257. package/dist/state/branch-service.d.ts.map +1 -0
  258. package/dist/state/branch-service.js +193 -0
  259. package/dist/state/branch-service.js.map +1 -0
  260. package/dist/state/document-sync.d.ts +7 -0
  261. package/dist/state/document-sync.d.ts.map +1 -0
  262. package/dist/state/document-sync.js +39 -0
  263. package/dist/state/document-sync.js.map +1 -0
  264. package/dist/state/language-service.d.ts +16 -0
  265. package/dist/state/language-service.d.ts.map +1 -0
  266. package/dist/state/language-service.js +73 -0
  267. package/dist/state/language-service.js.map +1 -0
  268. package/dist/state/menu-service.d.ts +20 -0
  269. package/dist/state/menu-service.d.ts.map +1 -0
  270. package/dist/state/menu-service.js +59 -0
  271. package/dist/state/menu-service.js.map +1 -0
  272. package/dist/state/navigation-service.d.ts +37 -0
  273. package/dist/state/navigation-service.d.ts.map +1 -0
  274. package/dist/state/navigation-service.js +131 -0
  275. package/dist/state/navigation-service.js.map +1 -0
  276. package/dist/state/preference-sync.d.ts +15 -0
  277. package/dist/state/preference-sync.d.ts.map +1 -0
  278. package/dist/state/preference-sync.js +85 -0
  279. package/dist/state/preference-sync.js.map +1 -0
  280. package/dist/state/progress-service.d.ts +3 -0
  281. package/dist/state/progress-service.d.ts.map +1 -0
  282. package/dist/state/progress-service.js +17 -0
  283. package/dist/state/progress-service.js.map +1 -0
  284. package/dist/state/screen-access.d.ts +15 -0
  285. package/dist/state/screen-access.d.ts.map +1 -0
  286. package/dist/state/screen-access.js +60 -0
  287. package/dist/state/screen-access.js.map +1 -0
  288. package/dist/state/sidebar-service.d.ts +8 -0
  289. package/dist/state/sidebar-service.d.ts.map +1 -0
  290. package/dist/state/sidebar-service.js +18 -0
  291. package/dist/state/sidebar-service.js.map +1 -0
  292. package/dist/state/signals.d.ts +84 -0
  293. package/dist/state/signals.d.ts.map +1 -0
  294. package/dist/state/signals.js +137 -0
  295. package/dist/state/signals.js.map +1 -0
  296. package/dist/state/toast-service.d.ts +9 -0
  297. package/dist/state/toast-service.d.ts.map +1 -0
  298. package/dist/state/toast-service.js +36 -0
  299. package/dist/state/toast-service.js.map +1 -0
  300. package/dist/styles.css +15 -0
  301. package/dist/theme/dark-themes.d.ts +2 -0
  302. package/dist/theme/dark-themes.d.ts.map +1 -0
  303. package/dist/theme/dark-themes.js +20 -0
  304. package/dist/theme/dark-themes.js.map +1 -0
  305. package/dist/theme/logo.d.ts +4 -0
  306. package/dist/theme/logo.d.ts.map +1 -0
  307. package/dist/theme/logo.js +10 -0
  308. package/dist/theme/logo.js.map +1 -0
  309. package/dist/theme/theme-service.d.ts +21 -0
  310. package/dist/theme/theme-service.d.ts.map +1 -0
  311. package/dist/theme/theme-service.js +69 -0
  312. package/dist/theme/theme-service.js.map +1 -0
  313. package/dist/types/class-names.d.ts +9 -0
  314. package/dist/types/class-names.d.ts.map +1 -0
  315. package/dist/types/class-names.js +45 -0
  316. package/dist/types/class-names.js.map +1 -0
  317. package/dist/types/field-error.d.ts +5 -0
  318. package/dist/types/field-error.d.ts.map +1 -0
  319. package/dist/types/field-error.js +16 -0
  320. package/dist/types/field-error.js.map +1 -0
  321. package/dist/types/field-props.d.ts +20 -0
  322. package/dist/types/field-props.d.ts.map +1 -0
  323. package/dist/types/field-props.js +4 -0
  324. package/dist/types/field-props.js.map +1 -0
  325. package/dist/types/field-registry.d.ts +11 -0
  326. package/dist/types/field-registry.d.ts.map +1 -0
  327. package/dist/types/field-registry.js +18 -0
  328. package/dist/types/field-registry.js.map +1 -0
  329. package/dist/types/field-wrapper.d.ts +13 -0
  330. package/dist/types/field-wrapper.d.ts.map +1 -0
  331. package/dist/types/field-wrapper.js +16 -0
  332. package/dist/types/field-wrapper.js.map +1 -0
  333. package/dist/types/lang-field.d.ts +15 -0
  334. package/dist/types/lang-field.d.ts.map +1 -0
  335. package/dist/types/lang-field.js +68 -0
  336. package/dist/types/lang-field.js.map +1 -0
  337. package/dist/types/markdown-color-mode.d.ts +7 -0
  338. package/dist/types/markdown-color-mode.d.ts.map +1 -0
  339. package/dist/types/markdown-color-mode.js +11 -0
  340. package/dist/types/markdown-color-mode.js.map +1 -0
  341. package/dist/types/media-service.d.ts +24 -0
  342. package/dist/types/media-service.d.ts.map +1 -0
  343. package/dist/types/media-service.js +41 -0
  344. package/dist/types/media-service.js.map +1 -0
  345. package/dist/types/media-viewer.d.ts +2 -0
  346. package/dist/types/media-viewer.d.ts.map +1 -0
  347. package/dist/types/media-viewer.js +23 -0
  348. package/dist/types/media-viewer.js.map +1 -0
  349. package/dist/types/type.button.d.ts +36 -0
  350. package/dist/types/type.button.d.ts.map +1 -0
  351. package/dist/types/type.button.js +27 -0
  352. package/dist/types/type.button.js.map +1 -0
  353. package/dist/types/type.checkbox.d.ts +5 -0
  354. package/dist/types/type.checkbox.d.ts.map +1 -0
  355. package/dist/types/type.checkbox.js +26 -0
  356. package/dist/types/type.checkbox.js.map +1 -0
  357. package/dist/types/type.confirm.d.ts +19 -0
  358. package/dist/types/type.confirm.d.ts.map +1 -0
  359. package/dist/types/type.confirm.js +15 -0
  360. package/dist/types/type.confirm.js.map +1 -0
  361. package/dist/types/type.date.d.ts +16 -0
  362. package/dist/types/type.date.d.ts.map +1 -0
  363. package/dist/types/type.date.js +65 -0
  364. package/dist/types/type.date.js.map +1 -0
  365. package/dist/types/type.drawer.d.ts +20 -0
  366. package/dist/types/type.drawer.d.ts.map +1 -0
  367. package/dist/types/type.drawer.js +31 -0
  368. package/dist/types/type.drawer.js.map +1 -0
  369. package/dist/types/type.dropdown.d.ts +23 -0
  370. package/dist/types/type.dropdown.d.ts.map +1 -0
  371. package/dist/types/type.dropdown.js +34 -0
  372. package/dist/types/type.dropdown.js.map +1 -0
  373. package/dist/types/type.filter.d.ts +17 -0
  374. package/dist/types/type.filter.d.ts.map +1 -0
  375. package/dist/types/type.filter.js +28 -0
  376. package/dist/types/type.filter.js.map +1 -0
  377. package/dist/types/type.icon.d.ts +21 -0
  378. package/dist/types/type.icon.d.ts.map +1 -0
  379. package/dist/types/type.icon.js +24 -0
  380. package/dist/types/type.icon.js.map +1 -0
  381. package/dist/types/type.image.d.ts +34 -0
  382. package/dist/types/type.image.d.ts.map +1 -0
  383. package/dist/types/type.image.js +46 -0
  384. package/dist/types/type.image.js.map +1 -0
  385. package/dist/types/type.input.d.ts +13 -0
  386. package/dist/types/type.input.d.ts.map +1 -0
  387. package/dist/types/type.input.js +29 -0
  388. package/dist/types/type.input.js.map +1 -0
  389. package/dist/types/type.lang-md.d.ts +10 -0
  390. package/dist/types/type.lang-md.d.ts.map +1 -0
  391. package/dist/types/type.lang-md.js +56 -0
  392. package/dist/types/type.lang-md.js.map +1 -0
  393. package/dist/types/type.lang.d.ts +11 -0
  394. package/dist/types/type.lang.d.ts.map +1 -0
  395. package/dist/types/type.lang.js +56 -0
  396. package/dist/types/type.lang.js.map +1 -0
  397. package/dist/types/type.list.d.ts +13 -0
  398. package/dist/types/type.list.d.ts.map +1 -0
  399. package/dist/types/type.list.js +42 -0
  400. package/dist/types/type.list.js.map +1 -0
  401. package/dist/types/type.mdv.d.ts +10 -0
  402. package/dist/types/type.mdv.d.ts.map +1 -0
  403. package/dist/types/type.mdv.js +22 -0
  404. package/dist/types/type.mdv.js.map +1 -0
  405. package/dist/types/type.mdx.d.ts +10 -0
  406. package/dist/types/type.mdx.d.ts.map +1 -0
  407. package/dist/types/type.mdx.js +30 -0
  408. package/dist/types/type.mdx.js.map +1 -0
  409. package/dist/types/type.modal.d.ts +18 -0
  410. package/dist/types/type.modal.d.ts.map +1 -0
  411. package/dist/types/type.modal.js +30 -0
  412. package/dist/types/type.modal.js.map +1 -0
  413. package/dist/types/type.otp.d.ts +8 -0
  414. package/dist/types/type.otp.d.ts.map +1 -0
  415. package/dist/types/type.otp.js +48 -0
  416. package/dist/types/type.otp.js.map +1 -0
  417. package/dist/types/type.search.d.ts +16 -0
  418. package/dist/types/type.search.d.ts.map +1 -0
  419. package/dist/types/type.search.js +48 -0
  420. package/dist/types/type.search.js.map +1 -0
  421. package/dist/types/type.select.d.ts +14 -0
  422. package/dist/types/type.select.d.ts.map +1 -0
  423. package/dist/types/type.select.js +53 -0
  424. package/dist/types/type.select.js.map +1 -0
  425. package/dist/types/type.switch.d.ts +8 -0
  426. package/dist/types/type.switch.d.ts.map +1 -0
  427. package/dist/types/type.switch.js +26 -0
  428. package/dist/types/type.switch.js.map +1 -0
  429. package/dist/types/type.table.d.ts +28 -0
  430. package/dist/types/type.table.d.ts.map +1 -0
  431. package/dist/types/type.table.js +72 -0
  432. package/dist/types/type.table.js.map +1 -0
  433. package/dist/types/type.text-area.d.ts +9 -0
  434. package/dist/types/type.text-area.d.ts.map +1 -0
  435. package/dist/types/type.text-area.js +26 -0
  436. package/dist/types/type.text-area.js.map +1 -0
  437. package/dist/types/type.time.d.ts +9 -0
  438. package/dist/types/type.time.d.ts.map +1 -0
  439. package/dist/types/type.time.js +34 -0
  440. package/dist/types/type.time.js.map +1 -0
  441. package/dist/types/type.upload.d.ts +45 -0
  442. package/dist/types/type.upload.d.ts.map +1 -0
  443. package/dist/types/type.upload.js +90 -0
  444. package/dist/types/type.upload.js.map +1 -0
  445. package/dist/types/type.video.d.ts +19 -0
  446. package/dist/types/type.video.d.ts.map +1 -0
  447. package/dist/types/type.video.js +33 -0
  448. package/dist/types/type.video.js.map +1 -0
  449. package/dist/types/upload-service.d.ts +47 -0
  450. package/dist/types/upload-service.d.ts.map +1 -0
  451. package/dist/types/upload-service.js +191 -0
  452. package/dist/types/upload-service.js.map +1 -0
  453. package/dist/utils/app-config.d.ts +6 -0
  454. package/dist/utils/app-config.d.ts.map +1 -0
  455. package/dist/utils/app-config.js +17 -0
  456. package/dist/utils/app-config.js.map +1 -0
  457. package/dist/utils/app-http.d.ts +49 -0
  458. package/dist/utils/app-http.d.ts.map +1 -0
  459. package/dist/utils/app-http.js +229 -0
  460. package/dist/utils/app-http.js.map +1 -0
  461. package/dist/utils/app-storage.d.ts +56 -0
  462. package/dist/utils/app-storage.d.ts.map +1 -0
  463. package/dist/utils/app-storage.js +236 -0
  464. package/dist/utils/app-storage.js.map +1 -0
  465. package/dist/utils/crypto-util.d.ts +15 -0
  466. package/dist/utils/crypto-util.d.ts.map +1 -0
  467. package/dist/utils/crypto-util.js +76 -0
  468. package/dist/utils/crypto-util.js.map +1 -0
  469. package/dist/utils/event-util.d.ts +16 -0
  470. package/dist/utils/event-util.d.ts.map +1 -0
  471. package/dist/utils/event-util.js +51 -0
  472. package/dist/utils/event-util.js.map +1 -0
  473. package/dist/utils/file-util.d.ts +30 -0
  474. package/dist/utils/file-util.d.ts.map +1 -0
  475. package/dist/utils/file-util.js +165 -0
  476. package/dist/utils/file-util.js.map +1 -0
  477. package/dist/utils/lang-util.d.ts +12 -0
  478. package/dist/utils/lang-util.d.ts.map +1 -0
  479. package/dist/utils/lang-util.js +53 -0
  480. package/dist/utils/lang-util.js.map +1 -0
  481. package/dist/utils/language-util.d.ts +21 -0
  482. package/dist/utils/language-util.d.ts.map +1 -0
  483. package/dist/utils/language-util.js +96 -0
  484. package/dist/utils/language-util.js.map +1 -0
  485. package/dist/utils/leave-guard.d.ts +5 -0
  486. package/dist/utils/leave-guard.d.ts.map +1 -0
  487. package/dist/utils/leave-guard.js +24 -0
  488. package/dist/utils/leave-guard.js.map +1 -0
  489. package/dist/utils/lucide-icon.d.ts +10 -0
  490. package/dist/utils/lucide-icon.d.ts.map +1 -0
  491. package/dist/utils/lucide-icon.js +48 -0
  492. package/dist/utils/lucide-icon.js.map +1 -0
  493. package/dist/utils/menu-util.d.ts +33 -0
  494. package/dist/utils/menu-util.d.ts.map +1 -0
  495. package/dist/utils/menu-util.js +151 -0
  496. package/dist/utils/menu-util.js.map +1 -0
  497. package/dist/utils/option-util.d.ts +21 -0
  498. package/dist/utils/option-util.d.ts.map +1 -0
  499. package/dist/utils/option-util.js +101 -0
  500. package/dist/utils/option-util.js.map +1 -0
  501. package/dist/utils/session-id.d.ts +5 -0
  502. package/dist/utils/session-id.d.ts.map +1 -0
  503. package/dist/utils/session-id.js +44 -0
  504. package/dist/utils/session-id.js.map +1 -0
  505. package/dist/utils/shared-regexp.d.ts +31 -0
  506. package/dist/utils/shared-regexp.d.ts.map +1 -0
  507. package/dist/utils/shared-regexp.js +17 -0
  508. package/dist/utils/shared-regexp.js.map +1 -0
  509. package/dist/utils/storage-keys.d.ts +68 -0
  510. package/dist/utils/storage-keys.d.ts.map +1 -0
  511. package/dist/utils/storage-keys.js +75 -0
  512. package/dist/utils/storage-keys.js.map +1 -0
  513. package/package.json +101 -4
  514. package/src/components/app-brand.tsx +37 -0
  515. package/src/components/branch-switcher.tsx +74 -0
  516. package/src/components/coming-soon.tsx +35 -0
  517. package/src/components/empty-state.tsx +42 -0
  518. package/src/components/language-switcher.tsx +77 -0
  519. package/src/components/page-loader.tsx +11 -0
  520. package/src/components/page-not-found.tsx +42 -0
  521. package/src/components/permission-denied.tsx +21 -0
  522. package/src/components/require-access.tsx +30 -0
  523. package/src/components/scroll-to-top.tsx +62 -0
  524. package/src/components/settings-menu.tsx +224 -0
  525. package/src/components/theme-switcher.tsx +72 -0
  526. package/src/components/toast-container.tsx +73 -0
  527. package/src/components/top-progress.tsx +14 -0
  528. package/src/components/user-menu.tsx +179 -0
  529. package/src/context/ui-context.ts +20 -0
  530. package/src/context/use-ui.ts +42 -0
  531. package/src/i18n/default-messages.ts +67 -0
  532. package/src/i18n/direction.ts +43 -0
  533. package/src/i18n/locale-service.ts +187 -0
  534. package/src/i18n/translator.ts +88 -0
  535. package/src/index.ts +341 -0
  536. package/src/interfaces/app-types.ts +154 -0
  537. package/src/interfaces/toast.ts +12 -0
  538. package/src/interfaces/ui-config.ts +189 -0
  539. package/src/interfaces/ui-context.ts +43 -0
  540. package/src/layout.ts +29 -0
  541. package/src/layouts/app-layout.tsx +103 -0
  542. package/src/layouts/article-layout.tsx +16 -0
  543. package/src/layouts/aside-layout.tsx +118 -0
  544. package/src/layouts/auth-layout.tsx +41 -0
  545. package/src/layouts/content-layout.tsx +11 -0
  546. package/src/layouts/float-layout.tsx +11 -0
  547. package/src/layouts/grid-layout.tsx +11 -0
  548. package/src/layouts/head-layout.tsx +61 -0
  549. package/src/layouts/header.tsx +74 -0
  550. package/src/layouts/layout-constants.ts +5 -0
  551. package/src/layouts/mega-menu.tsx +203 -0
  552. package/src/layouts/navigation.ts +45 -0
  553. package/src/layouts/rail-flyout.tsx +77 -0
  554. package/src/layouts/rail-tooltip.tsx +77 -0
  555. package/src/layouts/sidebar.tsx +296 -0
  556. package/src/markdown.ts +12 -0
  557. package/src/providers/provider-effects.ts +30 -0
  558. package/src/providers/register-config.ts +30 -0
  559. package/src/providers/shared-web-ui-provider.tsx +98 -0
  560. package/src/providers/theme-provider.tsx +15 -0
  561. package/src/providers/translation-provider.tsx +28 -0
  562. package/src/query/page-link.tsx +84 -0
  563. package/src/query/page-path.ts +26 -0
  564. package/src/query/query-param.ts +263 -0
  565. package/src/query/use-query-param.ts +23 -0
  566. package/src/skeleton/skeleton-article.tsx +11 -0
  567. package/src/skeleton/skeleton-auth-form.tsx +20 -0
  568. package/src/skeleton/skeleton-cards.tsx +35 -0
  569. package/src/skeleton/skeleton-chat.tsx +34 -0
  570. package/src/skeleton/skeleton-dashboard.tsx +34 -0
  571. package/src/skeleton/skeleton-float.tsx +10 -0
  572. package/src/skeleton/skeleton-form.tsx +45 -0
  573. package/src/skeleton/skeleton-menu.tsx +30 -0
  574. package/src/skeleton/skeleton-page.tsx +18 -0
  575. package/src/skeleton/skeleton-table.tsx +25 -0
  576. package/src/state/auth-service.ts +104 -0
  577. package/src/state/branch-service.ts +217 -0
  578. package/src/state/document-sync.ts +43 -0
  579. package/src/state/language-service.ts +80 -0
  580. package/src/state/menu-service.ts +67 -0
  581. package/src/state/navigation-service.ts +160 -0
  582. package/src/state/preference-sync.ts +93 -0
  583. package/src/state/progress-service.ts +18 -0
  584. package/src/state/screen-access.ts +70 -0
  585. package/src/state/sidebar-service.ts +22 -0
  586. package/src/state/signals.ts +183 -0
  587. package/src/state/toast-service.ts +45 -0
  588. package/src/styles.css +15 -0
  589. package/src/theme/dark-themes.ts +20 -0
  590. package/src/theme/logo.ts +12 -0
  591. package/src/theme/theme-service.ts +82 -0
  592. package/src/types/class-names.ts +53 -0
  593. package/src/types/field-error.ts +19 -0
  594. package/src/types/field-props.ts +23 -0
  595. package/src/types/field-registry.ts +27 -0
  596. package/src/types/field-wrapper.tsx +42 -0
  597. package/src/types/lang-field.ts +71 -0
  598. package/src/types/markdown-color-mode.ts +13 -0
  599. package/src/types/media-service.ts +61 -0
  600. package/src/types/media-viewer.tsx +57 -0
  601. package/src/types/type.button.tsx +108 -0
  602. package/src/types/type.checkbox.tsx +49 -0
  603. package/src/types/type.confirm.tsx +50 -0
  604. package/src/types/type.date.tsx +97 -0
  605. package/src/types/type.drawer.tsx +86 -0
  606. package/src/types/type.dropdown.tsx +81 -0
  607. package/src/types/type.filter.tsx +64 -0
  608. package/src/types/type.icon.ts +53 -0
  609. package/src/types/type.image.tsx +115 -0
  610. package/src/types/type.input.tsx +57 -0
  611. package/src/types/type.lang-md.tsx +129 -0
  612. package/src/types/type.lang.tsx +156 -0
  613. package/src/types/type.list.tsx +97 -0
  614. package/src/types/type.mdv.tsx +35 -0
  615. package/src/types/type.mdx.tsx +54 -0
  616. package/src/types/type.modal.tsx +77 -0
  617. package/src/types/type.otp.tsx +82 -0
  618. package/src/types/type.search.tsx +87 -0
  619. package/src/types/type.select.tsx +87 -0
  620. package/src/types/type.switch.tsx +52 -0
  621. package/src/types/type.table.tsx +152 -0
  622. package/src/types/type.text-area.tsx +51 -0
  623. package/src/types/type.time.tsx +61 -0
  624. package/src/types/type.upload.tsx +294 -0
  625. package/src/types/type.video.tsx +119 -0
  626. package/src/types/upload-service.ts +229 -0
  627. package/src/utils/app-config.ts +21 -0
  628. package/src/utils/app-http.ts +255 -0
  629. package/src/utils/app-storage.ts +259 -0
  630. package/src/utils/crypto-util.ts +88 -0
  631. package/src/utils/event-util.ts +58 -0
  632. package/src/utils/file-util.ts +186 -0
  633. package/src/utils/lang-util.ts +60 -0
  634. package/src/utils/language-util.ts +107 -0
  635. package/src/utils/leave-guard.ts +26 -0
  636. package/src/utils/lucide-icon.ts +55 -0
  637. package/src/utils/menu-util.ts +165 -0
  638. package/src/utils/option-util.ts +108 -0
  639. package/src/utils/session-id.ts +48 -0
  640. package/src/utils/shared-regexp.ts +18 -0
  641. package/src/utils/storage-keys.ts +80 -0
@@ -0,0 +1,71 @@
1
+ // lang-field.ts
2
+ // Shared logic of the multi-language fields (TypeLang and TypeLangMarkdown).
3
+ // The form value is one object per field: { en: "Hello", fr: "Bonjour", ar: "مرحبا" }.
4
+ // Languages come from config.languages; the current language is shown first.
5
+ // The translate button next to another language fills it from the current language
6
+ // using dff-util CallLangText.
7
+
8
+ import { CallLangText, ConstKeys, ConstValue } from "dff-util";
9
+ import type { MouseEvent } from "react";
10
+ import { translate } from "../i18n/translator.ts";
11
+ import type { LanguageOption } from "../interfaces/ui-config.ts";
12
+ import { ShowToast } from "../state/toast-service.ts";
13
+ import { readFieldBinding, translatingFieldPathSignal } from "./field-registry.ts";
14
+
15
+ /** Puts the current language first, then the others in config order. */
16
+ export function orderLanguagesForEditing(languages: LanguageOption[], currentCode: string): LanguageOption[] {
17
+ const orderedLanguages: LanguageOption[] = [];
18
+ const otherLanguages: LanguageOption[] = [];
19
+ for (const language of languages) {
20
+ if (language.code === currentCode) {
21
+ orderedLanguages.push(language);
22
+ } else {
23
+ otherLanguages.push(language);
24
+ }
25
+ }
26
+ return [...orderedLanguages, ...otherLanguages];
27
+ }
28
+
29
+ /** Full path of one language inside a multi-language field: ("title", "fr") -> "title.fr". */
30
+ export function readLanguageFieldPath(fieldName: string, languageCode: string): string {
31
+ return `${fieldName}${ConstValue.PERIOD}${languageCode}`;
32
+ }
33
+
34
+ /**
35
+ * Translate button handler. The button carries:
36
+ * data-source-path field to read data-source-lang its language
37
+ * data-target-path field to fill data-target-lang its language
38
+ */
39
+ export async function handleTranslateClick(event: MouseEvent<HTMLButtonElement>): Promise<void> {
40
+ const button = event.currentTarget;
41
+ const sourcePath = button.dataset.sourcePath ?? ConstValue.EMPTY;
42
+ const targetPath = button.dataset.targetPath ?? ConstValue.EMPTY;
43
+ const sourceLanguage = button.dataset.sourceLang ?? ConstValue.EMPTY;
44
+ const targetLanguage = button.dataset.targetLang ?? ConstValue.EMPTY;
45
+ const sourceBinding = readFieldBinding(sourcePath);
46
+ const targetBinding = readFieldBinding(targetPath);
47
+ if (!sourceBinding || !targetBinding) {
48
+ return;
49
+ }
50
+ const sourceValue = sourceBinding.value ?? ConstValue.EMPTY;
51
+ const sourceText = String(sourceValue);
52
+ const trimmedText = sourceText.trim();
53
+ if (trimmedText.length === 0) {
54
+ return;
55
+ }
56
+ translatingFieldPathSignal.value = targetPath;
57
+ try {
58
+ const translatedText = await CallLangText(sourceText, sourceLanguage, targetLanguage);
59
+ targetBinding.onChange(translatedText);
60
+ } catch {
61
+ const message = translate(ConstKeys.WENT_WRONG);
62
+ ShowToast(message, "warning");
63
+ } finally {
64
+ translatingFieldPathSignal.value = ConstValue.EMPTY;
65
+ }
66
+ }
67
+
68
+ /** Click handler wrapper that does not return a promise (for onClick). */
69
+ export function handleTranslateButtonClick(event: MouseEvent<HTMLButtonElement>): void {
70
+ void handleTranslateClick(event);
71
+ }
@@ -0,0 +1,13 @@
1
+ // markdown-color-mode.ts
2
+ // The markdown editor and viewer follow the DaisyUI theme through data-color-mode.
3
+
4
+ import { isDarkThemeSignal } from "../state/signals.ts";
5
+
6
+ /** "dark" on dark themes, "light" otherwise. */
7
+ export function readMarkdownColorMode(): "dark" | "light" {
8
+ const isDarkTheme = isDarkThemeSignal.value;
9
+ return isDarkTheme ? "dark" : "light";
10
+ }
11
+
12
+ /** Keeps the markdown colours on the theme background. */
13
+ export const MARKDOWN_SURFACE_STYLE = { backgroundColor: "transparent" };
@@ -0,0 +1,61 @@
1
+ // media-service.ts
2
+ // Shared state and handlers for TypeImage / TypeVideo:
3
+ // - loading: <img> / <video> get data-loaded or data-error, so CSS (peer-data-*) hides the skeleton
4
+ // or shows the error icon without React state;
5
+ // - preview: one popup for the whole app (MediaViewer, rendered by SharedWebUiProvider).
6
+
7
+ import { signal } from "@preact/signals-react";
8
+ import { ConstValue } from "dff-util";
9
+ import type { SyntheticEvent, MouseEvent } from "react";
10
+
11
+ export type MediaType = "image" | "video";
12
+
13
+ export interface MediaPreview {
14
+ type: MediaType;
15
+ /** Full-size file shown in the popup. "" = popup closed. */
16
+ src: string;
17
+ /** Popup heading and alt text (already translated). */
18
+ title: string;
19
+ /** Video still shown before playing. */
20
+ poster: string;
21
+ }
22
+
23
+ const CLOSED_PREVIEW: MediaPreview = { type: "image", src: ConstValue.EMPTY, title: ConstValue.EMPTY, poster: ConstValue.EMPTY };
24
+
25
+ /** The media shown in the popup, or src "" when it is closed. */
26
+ export const mediaPreviewSignal = signal<MediaPreview>(CLOSED_PREVIEW);
27
+
28
+ /** onLoad / onLoadedData: the file is ready, the skeleton goes away. */
29
+ export function markMediaLoaded(event: SyntheticEvent<HTMLElement>): void {
30
+ const element = event.currentTarget;
31
+ element.dataset.loaded = "true";
32
+ }
33
+
34
+ /** onError: the file could not be loaded, an icon replaces the skeleton. */
35
+ export function markMediaFailed(event: SyntheticEvent<HTMLElement>): void {
36
+ const element = event.currentTarget;
37
+ element.dataset.error = "true";
38
+ }
39
+
40
+ /** Opens the popup for any media. */
41
+ export function openMediaPreview(preview: MediaPreview): void {
42
+ mediaPreviewSignal.value = preview;
43
+ }
44
+
45
+ /** Thumbnail click: the button carries data-media-type, data-media-src, data-media-title and data-media-poster. */
46
+ export function handleMediaPreviewClick(event: MouseEvent<HTMLElement>): void {
47
+ const dataset = event.currentTarget.dataset;
48
+ const type: MediaType = dataset.mediaType === "video" ? "video" : "image";
49
+ const preview: MediaPreview = {
50
+ type: type,
51
+ src: dataset.mediaSrc ?? ConstValue.EMPTY,
52
+ title: dataset.mediaTitle ?? ConstValue.EMPTY,
53
+ poster: dataset.mediaPoster ?? ConstValue.EMPTY,
54
+ };
55
+ openMediaPreview(preview);
56
+ }
57
+
58
+ /** Closes the popup (a playing video stops because it is removed). */
59
+ export function closeMediaPreview(): void {
60
+ mediaPreviewSignal.value = CLOSED_PREVIEW;
61
+ }
@@ -0,0 +1,57 @@
1
+ // media-viewer.tsx
2
+ // The popup of TypeImage / TypeVideo: the full image, or the video playing with controls.
3
+ // A skeleton shows until the file is ready. Rendered once by SharedWebUiProvider.
4
+
5
+ import { useSignals } from "@preact/signals-react/runtime";
6
+ import { useUi } from "../context/use-ui.ts";
7
+ import { closeMediaPreview, markMediaFailed, markMediaLoaded, mediaPreviewSignal } from "./media-service.ts";
8
+ import { TypeIcon } from "./type.icon.ts";
9
+ import { TypeModal } from "./type.modal.tsx";
10
+
11
+ /** Skeleton and error icon that follow the data-loaded / data-error of the media element before them (peer). */
12
+ const MEDIA_SKELETON_CLASS = "skeleton absolute inset-0 peer-data-[error=true]:hidden peer-data-[loaded=true]:hidden";
13
+ const MEDIA_ERROR_CLASS = "absolute inset-0 hidden flex-col items-center justify-center gap-2 opacity-60 peer-data-[error=true]:flex";
14
+
15
+ export function MediaViewer() {
16
+ useSignals();
17
+ const { t } = useUi();
18
+ const preview = mediaPreviewSignal.value;
19
+ const isOpen = preview.src !== "";
20
+ const isVideo = preview.type === "video";
21
+ const errorText = t("ui.mediaError");
22
+ const posterUrl = preview.poster || undefined;
23
+
24
+ return (
25
+ <TypeModal isOpen={isOpen} title={preview.title} onClose={closeMediaPreview} size="2xl">
26
+ <div className="relative flex min-h-64 items-center justify-center overflow-hidden rounded-box bg-base-200">
27
+ {isVideo ? (
28
+ <video
29
+ key={preview.src}
30
+ src={preview.src}
31
+ poster={posterUrl}
32
+ controls
33
+ autoPlay
34
+ playsInline
35
+ className="peer max-h-[75vh] w-full bg-neutral opacity-0 transition-opacity data-[loaded=true]:opacity-100"
36
+ onLoadedData={markMediaLoaded}
37
+ onError={markMediaFailed}
38
+ />
39
+ ) : (
40
+ <img
41
+ key={preview.src}
42
+ src={preview.src}
43
+ alt={preview.title}
44
+ className="peer max-h-[75vh] w-auto object-contain opacity-0 transition-opacity data-[loaded=true]:opacity-100"
45
+ onLoad={markMediaLoaded}
46
+ onError={markMediaFailed}
47
+ />
48
+ )}
49
+ <span className={MEDIA_SKELETON_CLASS} />
50
+ <span className={MEDIA_ERROR_CLASS}>
51
+ <TypeIcon name={isVideo ? "VideoOff" : "ImageOff"} size={32} />
52
+ <span className="text-sm">{errorText}</span>
53
+ </span>
54
+ </div>
55
+ </TypeModal>
56
+ );
57
+ }
@@ -0,0 +1,108 @@
1
+ // type.button.tsx
2
+ // DaisyUI button with an action colour, optional lucide-react icon (TypeIcon) and loading state.
3
+ //
4
+ // <TypeButton action="primary" label={t("save")} icon="Save" type="submit" isLoading={userSaveIsLoading.value} />
5
+ // <TypeButton action="ghost" label={t("cancel")} icon="X" onPress={handleUserCancel} />
6
+ // <TypeButton type="submit" form="user-form" label={t("save")} /> // outside the <form id="user-form">
7
+
8
+ import type { MouseEventHandler } from "react";
9
+ import { useUi } from "../context/use-ui.ts";
10
+ import {
11
+ BUTTON_ACTION_CLASSES,
12
+ BUTTON_SIZE_CLASSES,
13
+ joinClassNames,
14
+ type ButtonAction,
15
+ type ControlSize,
16
+ } from "./class-names.ts";
17
+ import { TypeIcon, type IconName } from "./type.icon.ts";
18
+
19
+ export interface TypeButtonProps {
20
+ /** Visible text (already translated). */
21
+ label: string;
22
+ /** Colour / style. Default "primary". */
23
+ action?: ButtonAction;
24
+ /** lucide-react icon name, for example "Save". */
25
+ icon?: IconName;
26
+ /** Click handler. Not needed for type="submit". */
27
+ onPress?: MouseEventHandler<HTMLButtonElement>;
28
+ /** Default "button". */
29
+ type?: "button" | "submit" | "reset";
30
+ disabled?: boolean;
31
+ /** Shows a spinner and disables the button. */
32
+ isLoading?: boolean;
33
+ /** Use the outline style. */
34
+ isOutline?: boolean;
35
+ /** Show only the icon (label becomes the aria-label). */
36
+ isIconOnly?: boolean;
37
+ size?: ControlSize;
38
+ /** Full width. */
39
+ isBlock?: boolean;
40
+ className?: string;
41
+ /** Extra data passed to the click handler through data-value (read with event.currentTarget.dataset.value). */
42
+ dataValue?: string;
43
+ /** Focus this button when it appears (for example Cancel in a confirm dialog). */
44
+ autoFocus?: boolean;
45
+ /** Marks the button that closes an overlay (Escape clicks it). */
46
+ isOverlayClose?: boolean;
47
+ /** id of the <form> this button belongs to, when it sits outside it (for example Submit in a HeadLayout). */
48
+ form?: string;
49
+ }
50
+
51
+ export function TypeButton(props: TypeButtonProps) {
52
+ const {
53
+ label,
54
+ action = "primary",
55
+ icon,
56
+ onPress,
57
+ type = "button",
58
+ disabled = false,
59
+ isLoading = false,
60
+ isOutline = false,
61
+ isIconOnly = false,
62
+ size = "md",
63
+ isBlock = false,
64
+ className,
65
+ dataValue,
66
+ autoFocus = false,
67
+ isOverlayClose = false,
68
+ form,
69
+ } = props;
70
+ const { t } = useUi();
71
+ const loadingText = t("ui.loading");
72
+ const actionClass = BUTTON_ACTION_CLASSES[action];
73
+ const sizeClass = BUTTON_SIZE_CLASSES[size];
74
+ const classList = [
75
+ "btn",
76
+ actionClass,
77
+ sizeClass,
78
+ isOutline ? "btn-outline" : "",
79
+ isIconOnly ? "btn-square" : "",
80
+ isBlock ? "btn-block" : "",
81
+ className,
82
+ ];
83
+ const buttonClassName = joinClassNames(classList);
84
+ const showIcon = Boolean(icon) && !isLoading;
85
+ const iconElement = showIcon ? <TypeIcon name={icon} size={16} /> : null;
86
+ const spinnerElement = isLoading ? <span className="loading loading-spinner loading-sm" aria-label={loadingText} /> : null;
87
+ const isDisabled = disabled || isLoading;
88
+
89
+ return (
90
+ <button
91
+ type={type}
92
+ form={form}
93
+ className={buttonClassName}
94
+ onClick={onPress}
95
+ disabled={isDisabled}
96
+ aria-busy={isLoading}
97
+ aria-label={isIconOnly ? label : undefined}
98
+ data-value={dataValue}
99
+ data-overlay-close={isOverlayClose ? true : undefined}
100
+ autoFocus={autoFocus}
101
+ title={isIconOnly ? label : undefined}
102
+ >
103
+ {spinnerElement}
104
+ {iconElement}
105
+ {isIconOnly ? null : label}
106
+ </button>
107
+ );
108
+ }
@@ -0,0 +1,49 @@
1
+ // type.checkbox.tsx
2
+ // Checkbox (boolean) connected to react-hook-form.
3
+ //
4
+ // <TypeCheckbox control={control} name="acceptTerms" label={t("terms.accept")} rules={{ required: { value: true, message: ConstKeys.REQUIRED } }} />
5
+
6
+ import { useId } from "react";
7
+ import { useController, type FieldValues } from "react-hook-form";
8
+ import { useUi } from "../context/use-ui.ts";
9
+ import { joinClassNames } from "./class-names.ts";
10
+ import { readFieldErrorText } from "./field-error.ts";
11
+ import type { TypeFieldProps } from "./field-props.ts";
12
+
13
+ export type TypeCheckboxProps<TFieldValues extends FieldValues> = TypeFieldProps<TFieldValues>;
14
+
15
+ export function TypeCheckbox<TFieldValues extends FieldValues>(props: TypeCheckboxProps<TFieldValues>) {
16
+ const { control, name, label, rules, error, hint, disabled, className } = props;
17
+ const { t } = useUi();
18
+ const inputId = useId();
19
+ const controllerOptions = { control: control, name: name, rules: rules, disabled: disabled };
20
+ const { field, fieldState } = useController(controllerOptions);
21
+ const fieldError = error ?? fieldState.error;
22
+ const errorText = readFieldErrorText(fieldError, t);
23
+ const isChecked = Boolean(field.value);
24
+ const classList = ["fieldset", className];
25
+ const wrapperClassName = joinClassNames(classList);
26
+ const checkboxClassName = errorText ? "checkbox checkbox-error" : "checkbox checkbox-primary";
27
+ const messageText = errorText ?? hint;
28
+
29
+ return (
30
+ <fieldset className={wrapperClassName}>
31
+ <label className="label cursor-pointer gap-3 text-base-content" htmlFor={inputId}>
32
+ <input
33
+ id={inputId}
34
+ ref={field.ref}
35
+ name={field.name}
36
+ type="checkbox"
37
+ checked={isChecked}
38
+ onChange={field.onChange}
39
+ onBlur={field.onBlur}
40
+ disabled={field.disabled}
41
+ className={checkboxClassName}
42
+ aria-invalid={Boolean(errorText)}
43
+ />
44
+ <span>{label}</span>
45
+ </label>
46
+ {messageText ? <p className={errorText ? "label text-error" : "label"}>{messageText}</p> : null}
47
+ </fieldset>
48
+ );
49
+ }
@@ -0,0 +1,50 @@
1
+ // type.confirm.tsx
2
+ // In-app replacement for window.confirm. Cancel has the focus first, so Enter never confirms
3
+ // a destructive action by accident. Escape or a backdrop click cancels.
4
+ //
5
+ // <TypeConfirm isOpen={isDeleteOpen.value} title={t("user.deleteTitle")} message={t("user.deleteText")}
6
+ // tone="error" isLoading={userDeleteIsLoading.value}
7
+ // onConfirm={handleDeleteConfirm} onCancel={closeDeleteConfirm} />
8
+
9
+ import type { MouseEventHandler } from "react";
10
+ import { useUi } from "../context/use-ui.ts";
11
+ import { TypeButton } from "./type.button.tsx";
12
+ import { TypeModal } from "./type.modal.tsx";
13
+
14
+ export interface TypeConfirmProps {
15
+ isOpen: boolean;
16
+ /** Heading (already translated). */
17
+ title: string;
18
+ /** Explanation (already translated). */
19
+ message?: string;
20
+ /** Default: translated "Confirm". */
21
+ confirmLabel?: string;
22
+ /** Default: translated "Cancel". */
23
+ cancelLabel?: string;
24
+ /** "error" for destructive actions. Default "primary". */
25
+ tone?: "primary" | "error" | "warning";
26
+ isLoading?: boolean;
27
+ onConfirm: MouseEventHandler<HTMLButtonElement>;
28
+ onCancel: MouseEventHandler<HTMLElement>;
29
+ }
30
+
31
+ export function TypeConfirm(props: TypeConfirmProps) {
32
+ const { isOpen, title, message, confirmLabel, cancelLabel, tone = "primary", isLoading = false, onConfirm, onCancel } = props;
33
+ const { t } = useUi();
34
+ const defaultConfirmText = t("ui.confirm");
35
+ const defaultCancelText = t("ui.cancel");
36
+ const confirmText = confirmLabel ?? defaultConfirmText;
37
+ const cancelText = cancelLabel ?? defaultCancelText;
38
+ const footer = (
39
+ <>
40
+ <TypeButton action="ghost" label={cancelText} onPress={onCancel} disabled={isLoading} autoFocus />
41
+ <TypeButton action={tone} label={confirmText} onPress={onConfirm} isLoading={isLoading} />
42
+ </>
43
+ );
44
+
45
+ return (
46
+ <TypeModal isOpen={isOpen} title={title} onClose={onCancel} size="sm" footer={footer} isCloseHidden>
47
+ {message ? <p className="opacity-80">{message}</p> : null}
48
+ </TypeModal>
49
+ );
50
+ }
@@ -0,0 +1,97 @@
1
+ // type.date.tsx
2
+ // Date (or date + time) picker connected to react-hook-form, using the browser date input.
3
+ // The form value is text: "2026-11-05" or, with isDateTime, "2026-11-05T14:30".
4
+ // A Date object as default value is also shown correctly.
5
+ //
6
+ // <TypeDate control={control} name="birthDate" label={t("user.birthDate")} max="2026-12-31" />
7
+
8
+ import { ConstValue } from "dff-util";
9
+ import { useId } from "react";
10
+ import { useController, type FieldValues } from "react-hook-form";
11
+ import { useUi } from "../context/use-ui.ts";
12
+ import { FieldWrapper, readMessageId } from "./field-wrapper.tsx";
13
+ import { joinClassNames } from "./class-names.ts";
14
+ import { readFieldErrorText } from "./field-error.ts";
15
+ import type { TypeFieldProps } from "./field-props.ts";
16
+
17
+ export interface TypeDateProps<TFieldValues extends FieldValues> extends TypeFieldProps<TFieldValues> {
18
+ /** Also pick the time. Default false. */
19
+ isDateTime?: boolean;
20
+ /** Earliest value, same format as the form value. */
21
+ min?: string;
22
+ /** Latest value, same format as the form value. */
23
+ max?: string;
24
+ }
25
+
26
+ /** Adds a leading zero: 5 -> "05". */
27
+ function padNumber(value: number): string {
28
+ const text = String(value);
29
+ return text.padStart(2, "0");
30
+ }
31
+
32
+ /** Formats a Date for the input: "YYYY-MM-DD" or "YYYY-MM-DDTHH:mm" (local time). */
33
+ export function formatDateInputValue(date: Date, isDateTime: boolean): string {
34
+ const year = date.getFullYear();
35
+ const monthNumber = date.getMonth() + 1;
36
+ const dayNumber = date.getDate();
37
+ const month = padNumber(monthNumber);
38
+ const day = padNumber(dayNumber);
39
+ const datePart = `${year}-${month}-${day}`;
40
+ if (!isDateTime) {
41
+ return datePart;
42
+ }
43
+ const hourNumber = date.getHours();
44
+ const minuteNumber = date.getMinutes();
45
+ const hours = padNumber(hourNumber);
46
+ const minutes = padNumber(minuteNumber);
47
+ return `${datePart}T${hours}:${minutes}`;
48
+ }
49
+
50
+ /** Turns the form value (text or Date) into the text the input shows. */
51
+ export function readDateInputValue(value: unknown, isDateTime: boolean): string {
52
+ if (value instanceof Date) {
53
+ const timeValue = value.getTime();
54
+ const isValidDate = !Number.isNaN(timeValue);
55
+ return isValidDate ? formatDateInputValue(value, isDateTime) : ConstValue.EMPTY;
56
+ }
57
+ if (typeof value === "string") {
58
+ return value;
59
+ }
60
+ return ConstValue.EMPTY;
61
+ }
62
+
63
+ export function TypeDate<TFieldValues extends FieldValues>(props: TypeDateProps<TFieldValues>) {
64
+ const { control, name, label, rules, error, hint, disabled, className, isDateTime = false, min, max } = props;
65
+ const { t } = useUi();
66
+ const inputId = useId();
67
+ const controllerOptions = { control: control, name: name, rules: rules, disabled: disabled };
68
+ const { field, fieldState } = useController(controllerOptions);
69
+ const fieldError = error ?? fieldState.error;
70
+ const errorText = readFieldErrorText(fieldError, t);
71
+ const hasError = Boolean(errorText);
72
+ const classList = ["input w-full", hasError ? "input-error" : ""];
73
+ const inputClassName = joinClassNames(classList);
74
+ const messageId = readMessageId(inputId);
75
+ const inputValue = readDateInputValue(field.value, isDateTime);
76
+ const inputType = isDateTime ? "datetime-local" : "date";
77
+
78
+ return (
79
+ <FieldWrapper inputId={inputId} label={label} errorText={errorText} hint={hint} className={className}>
80
+ <input
81
+ id={inputId}
82
+ ref={field.ref}
83
+ name={field.name}
84
+ type={inputType}
85
+ value={inputValue}
86
+ min={min}
87
+ max={max}
88
+ onChange={field.onChange}
89
+ onBlur={field.onBlur}
90
+ disabled={field.disabled}
91
+ className={inputClassName}
92
+ aria-invalid={hasError}
93
+ aria-describedby={errorText || hint ? messageId : undefined}
94
+ />
95
+ </FieldWrapper>
96
+ );
97
+ }
@@ -0,0 +1,86 @@
1
+ // type.drawer.tsx
2
+ // Side panel that slides over the page (for forms and details). Closes with ✕, backdrop click or Escape.
3
+ // "end" opens on the right in LTR and on the left in RTL.
4
+ //
5
+ // <TypeDrawer isOpen={userIsPopupOpen.value} title={t("user.editTitle")} onClose={closeUserPopup}
6
+ // actions={<TypeButton label={t("save")} type="submit" form="user-form" />}>
7
+ // <UserForm />
8
+ // </TypeDrawer>
9
+
10
+ import type { MouseEventHandler, ReactNode } from "react";
11
+ import { createPortal } from "react-dom";
12
+ import { useUi } from "../context/use-ui.ts";
13
+ import { joinClassNames } from "./class-names.ts";
14
+ import { TypeButton } from "./type.button.tsx";
15
+
16
+ export type DrawerSide = "start" | "end";
17
+ export type DrawerSize = "sm" | "md" | "lg" | "xl";
18
+
19
+ export interface TypeDrawerProps {
20
+ isOpen: boolean;
21
+ /** Heading (already translated). */
22
+ title?: string;
23
+ /** Small text under the heading. */
24
+ subTitle?: string;
25
+ /** Buttons next to ✕. */
26
+ actions?: ReactNode;
27
+ onClose: MouseEventHandler<HTMLElement>;
28
+ children?: ReactNode;
29
+ /** Default "end". */
30
+ side?: DrawerSide;
31
+ /** Width. Default "lg". */
32
+ size?: DrawerSize;
33
+ }
34
+
35
+ const DRAWER_SIZE_CLASSES: Record<DrawerSize, string> = {
36
+ sm: "max-w-sm",
37
+ md: "max-w-xl",
38
+ lg: "max-w-3xl",
39
+ xl: "max-w-5xl",
40
+ };
41
+
42
+ export function TypeDrawer(props: TypeDrawerProps) {
43
+ const { isOpen, title, subTitle, actions, onClose, children, side = "end", size = "lg" } = props;
44
+ const { t } = useUi();
45
+ if (!isOpen) {
46
+ return null;
47
+ }
48
+ const closeText = t("ui.close");
49
+ const sizeClass = DRAWER_SIZE_CLASSES[size];
50
+ const sideClass = side === "end" ? "end-0 border-s" : "start-0 border-e";
51
+ const panelClassList = [
52
+ "fixed inset-y-0 z-50 flex w-full flex-col border-base-300 bg-base-100 text-base-content shadow-2xl outline-none",
53
+ sideClass,
54
+ sizeClass,
55
+ ];
56
+ const panelClassName = joinClassNames(panelClassList);
57
+
58
+ const overlay = (
59
+ <div className="fixed inset-0 z-50" role="dialog" aria-modal="true" aria-label={title}>
60
+ <button type="button" className="absolute inset-0 bg-black/40" aria-label={closeText} onClick={onClose} />
61
+ <div className={panelClassName}>
62
+ <div className="flex shrink-0 items-center gap-3 border-b border-base-300 bg-base-200/50 p-4">
63
+ <div className="min-w-0 flex-1">
64
+ {title ? <h3 className="truncate text-lg font-bold">{title}</h3> : null}
65
+ {subTitle ? <p className="truncate text-xs opacity-60">{subTitle}</p> : null}
66
+ </div>
67
+ {actions}
68
+ <TypeButton
69
+ action="ghost"
70
+ size="sm"
71
+ icon="X"
72
+ label={closeText}
73
+ isIconOnly
74
+ isOverlayClose
75
+ autoFocus
76
+ className="btn-circle"
77
+ onPress={onClose}
78
+ />
79
+ </div>
80
+ <div className="flex-1 overflow-y-auto p-4 md:p-6">{children}</div>
81
+ </div>
82
+ </div>
83
+ );
84
+ // Rendered into <body> so a sticky or blurred parent (for example the header) can not clip it.
85
+ return createPortal(overlay, document.body);
86
+ }
@@ -0,0 +1,81 @@
1
+ // type.dropdown.tsx
2
+ // Action menu (not a form field): a button that opens a DaisyUI dropdown list.
3
+ // Each item's key is put in data-value; read it in your handler with readDataValue(event).
4
+ //
5
+ // <TypeDropdown label={t("user.actions")} icon="EllipsisVertical" isIconOnly items={userActionItems} onSelect={handleUserActionSelect} />
6
+ // function handleUserActionSelect(event: MouseEvent<HTMLButtonElement>) {
7
+ // const actionKey = readDataValue(event); // "edit" | "delete"
8
+ // }
9
+
10
+ import type { OptionType } from "dff-util";
11
+ import type { MouseEventHandler, ReactElement } from "react";
12
+ import { useUi } from "../context/use-ui.ts";
13
+ import { joinClassNames } from "./class-names.ts";
14
+ import { readOptionLabel } from "./type.select.tsx";
15
+ import { TypeIcon, type IconName } from "./type.icon.ts";
16
+
17
+ export interface TypeDropdownProps {
18
+ /** Button text (already translated). Also the aria-label when isIconOnly. */
19
+ label: string;
20
+ /** Items. option.icon is a lucide icon name. */
21
+ items: OptionType[];
22
+ /** Called with the clicked item; its key is in data-value. */
23
+ onSelect: MouseEventHandler<HTMLButtonElement>;
24
+ /** Button icon. */
25
+ icon?: IconName;
26
+ isIconOnly?: boolean;
27
+ /** Open to the start or end side. Default "end". */
28
+ align?: "start" | "end";
29
+ /** Open upwards. */
30
+ isTop?: boolean;
31
+ className?: string;
32
+ }
33
+
34
+ /** Closes the DaisyUI dropdown by removing focus from it. */
35
+ export function blurActiveElement(): void {
36
+ const activeElement = document.activeElement;
37
+ if (activeElement instanceof HTMLElement) {
38
+ activeElement.blur();
39
+ }
40
+ }
41
+
42
+ /** Builds the menu entries. */
43
+ function buildDropdownItems(items: OptionType[], languageCode: string, onSelect: MouseEventHandler<HTMLButtonElement>): ReactElement[] {
44
+ const elements: ReactElement[] = [];
45
+ for (const item of items) {
46
+ const itemLabel = readOptionLabel(item, languageCode);
47
+ const itemKey = String(item.key);
48
+ const iconElement = item.icon ? <TypeIcon name={item.icon} size={16} /> : null;
49
+ const element = (
50
+ <li key={itemKey} className={item.disabled ? "menu-disabled" : undefined}>
51
+ <button type="button" data-value={itemKey} disabled={item.disabled} onClick={onSelect} onMouseUp={blurActiveElement}>
52
+ {iconElement}
53
+ {itemLabel}
54
+ </button>
55
+ </li>
56
+ );
57
+ elements.push(element);
58
+ }
59
+ return elements;
60
+ }
61
+
62
+ export function TypeDropdown(props: TypeDropdownProps) {
63
+ const { label, items, onSelect, icon = "ChevronDown", isIconOnly = false, align = "end", isTop = false, className } = props;
64
+ const { locale } = useUi();
65
+ const itemElements = buildDropdownItems(items, locale, onSelect);
66
+ const classList = ["dropdown", align === "end" ? "dropdown-end" : "dropdown-start", isTop ? "dropdown-top" : "", className];
67
+ const dropdownClassName = joinClassNames(classList);
68
+ const buttonClassName = isIconOnly ? "btn btn-ghost btn-sm btn-square" : "btn btn-sm";
69
+
70
+ return (
71
+ <div className={dropdownClassName}>
72
+ <div tabIndex={0} role="button" className={buttonClassName} aria-label={label} title={label}>
73
+ {isIconOnly ? null : label}
74
+ <TypeIcon name={icon} size={16} />
75
+ </div>
76
+ <ul tabIndex={0} className="dropdown-content menu z-40 mt-1 w-52 rounded-box bg-base-100 p-2 shadow-lg">
77
+ {itemElements}
78
+ </ul>
79
+ </div>
80
+ );
81
+ }